Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- public:technik:gentoo-overlay [2018/03/14 22:40] – angelegt frainz
+++ public:technik:gentoo-overlay [2021/08/14 22:52] – [Regeln für erfolgreiche Ebuilds im FeM-Overlay] Infos über die neue CI und Hinweis zur Nutzung von pkgcheck eingefügt nex
@@ Zeile 1: / Zeile 1: @@
 ====== Gentoo: FeM-Overlay ======
+<WRAP warning 50% center>
+Das FeM-Overlay ist von Bitbucket in das FeM-GitLab umgezogen.
+Die neue Upstream-URL lautet:
+https://gitlab.fem-net.de/gentoo/fem-overlay.git
+Bitte passt eure ''/etc/portage/repos.conf'' an und erstellt neue Commits ab sofort immer im GitLab.
+Der Bitbucket-Mirror wird ca. Dezember 2021 abgeschaltet.
+</WRAP>
 Das FeM-Overlay ist ein Portage Overlay für die Gentoo Paketverwaltung. Hier werden Ebuilds und Patches für Software gepflegt, die auf FeM Servern Einsatz findet, so aber nicht im offiziellen Portage-Tree enthalten ist.
@@ Zeile 8: / Zeile 19: @@
 ===== Nutzung =====
-  * URL des Overlays (git): https://bitbucket.fem.tu-ilmenau.de/scm/gentoo/fem-overlay.git
+  * URL des Overlays (git): https://gitlab.fem-net.de/gentoo/fem-overlay.git
+    * Upstream-Repository. Alle Commits werden hier in den master gemerged.
+  * URL des Overlays (git, alte URL): https://bitbucket.fem.tu-ilmenau.de/scm/gentoo/fem-overlay.git
+    * Hinweis: das Bitbucket wird per Push-Mirror aus dem GitLab gesynct. Bitte im GitLab committen.
   * URL des Overlays (svn): http://subversion.fem.tu-ilmenau.de/repository/fem-overlay/trunk/
-    * Hinweis: das Subversion wird minütlich aus dem Git-Master gesynct und ist nicht mehr schreibbar. Bitte im Git-Repo commiten.
+    * Hinweis: das Subversion wird minütlich aus dem Git-Master gesynct und ist nicht mehr schreibbar. Bitte im GitLab-Repo commiten.
 ==== Ohne Layman über repos.conf ====
+Diese Variante bietet sich an, wenn man selber am Repository Änderungen vornehmen möchte.
 <code>
 [fem-overlay]
-location = /usr/local/overlay/fem-overlay
+location = /var/db/repos/fem-overlay
 sync-type = git
-sync-uri = https://bitbucket.fem.tu-ilmenau.de/scm/gentoo/fem-overlay.git
+sync-uri = https://gitlab.fem-net.de/gentoo/fem-overlay.git
 auto-sync = yes
 </code>
-==== Mit Layman ====
+==== Mit eselect-repository ====
-Für das FeM-Overlay benötigt Layman Subversion-Support:
+Diese Variante verwendet in der Standardeinstellung ein [[https://github.com/gentoo-mirror/fem-overlay|Clone vom Repository]] mit zusätzlich generierten Metadaten, was emerge beschleunigt.
+Empfiehlt sich für Systeme, die das Overlay nur nutzen, aber lokal selbst keine Änderungen hinzufügen.
 <code>
-echo "app-portage/layman subversion" >> /etc/portage/package.use/layman
+eselect repository enable fem-overlay
-emerge app-portage/layman
 </code>
+==== Mit Layman ====
+Das Overlay ist in der offiziellen Liste enthalten.
 Hinzufügen des Overlays
 <code>
-layman --overlays=http://subversion.fem.tu-ilmenau.de/repositories.xml -L -a fem-overlay
+layman -a fem-overlay
 </code>
+=== layman wieder loswerden ===
+<code>
+# layman Referenzen entfernen
+rm /etc/portage/repos.conf/layman.conf
+sed -i -e '/source \/var\/lib\/layman\/make.conf/d' /etc/portage/make.conf
+sed -i -e '/\*/d' /etc/eix-sync.conf
+emerge -C layman
+rm -rf /var/lib/layman
+eix-sync # oder emerge --sync
+</code>
 ===== Ebuilds einreichen =====
+<del>
 Für einen schreibenden Zugriff braucht man ein Login im [[technik:server:jira|JIRA]] (und damit im [[technik:server:repository#bitbucket|Bitbucket]]) ([[https://jira.fem.tu-ilmenau.de/secure/Signup!default.jspa|Registrierung]]) und wendet sich dann an [[fem-overlay@technik.fem-net.de]].
 Mit einem Bitbucket-Login allein kann man aber bereits sich das [[https://bitbucket.fem.tu-ilmenau.de/projects/GENTOO/repos/fem-overlay?fork|Repo forken]], eine Änderung in einem Branch commiten und einen Pull-Request erstellen, falls man nicht vollen Schreibzugriff benötigt.
+</del>
+Die bestehenden Anweisungen beziehen sich auf das alte Upstream-Repository, welches bald zugunsten des [[https://gitlab.fem-net.de/gentoo/fem-overlay|GitLab-Repositorys]] nicht mehr benutzt wird.
 ==== Regeln für erfolgreiche Ebuilds im FeM-Overlay ====
@@ Zeile 102: / Zeile 140: @@
       * //**repoman**// (Prüft alle Ebuilds im aktuellen Verzeichnis)
       * //**repoman commit**// (Erstellt einen Commit und fügt Metainformationen hinzu, falls die Prüfung erfolgreich war)
+  * pkgcheck zur Prüfung des Ebuilds verwenden
+    * //**pkgcheck scan**// (prüft Ebuilds im aktuellen Verzeichnis auf gängige Konventionen und Fehler)
-(Ideen von aus den [[http://overlays.gentoo.org/proj/sunrise/wiki/CodingStandards|Coding-Standards des Sunrise-Overlays]].)
+(Ideen aus den [[http://overlays.gentoo.org/proj/sunrise/wiki/CodingStandards|Coding-Standards des Sunrise-Overlays]].)
+Das Overlay wird bei Änderungen mittels [[https://wiki.gentoo.org/wiki/Repoman|Repoman]], pkgcheck und overlint geprüft.
+Zudem werden ebuilds per [[https://blogs.gentoo.org/ago/2020/07/04/gentoo-tinderbox/|Tinderbox]] gebaut und Fehler gemeldet.
 ==== Historie ====
   * ca. 2008 - Das Overlay wurde angelegt
   * 2017-11-23 - Migration auf Git
+  * 2018-03-23 - Aufnahme in overlays.gentoo.org
+  * 2021-07-29 - Erste Arbeiten an der Umstellung auf den neuen Upstream https://gitlab.fem-net.de/gentoo/fem-overlay
+  * 2021-08-02 - Änderung des Upstream-Repos für ''api.gentoo.org'' auf GitHub
+  * 2021-08-13 - Das Overlay benutzt nun das GitLab als Upstream-Repository