Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- public:technik:gentoo-overlay [2021/08/14 22:47] – Info eingefügt, dass GitLab jetzt der Upstream ist nex
+++ public:technik:gentoo-overlay [2022/12/10 18:57] – [Regeln für erfolgreiche Ebuilds im FeM-Overlay] Hinweis zu automatischer Issue-Zuweisung eingefügt nex
@@ Zeile 68: / Zeile 68: @@
 ===== Ebuilds einreichen =====
-<del>
+Für einen schreibenden Zugriff benötigt man einen Login im [[technik:dienste:gitlab|GitLab]].
-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]].
+Die ist üblicherweise der FeM LDAP-Zugang.
+Neue ebuilds können per Fork und anschließendem Merge Request eingericht werden.
-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.
+Für zusätzliche Berechtigunge (MRs selbst mergen, Issues bearbeiten, etc.) kann man sich an <fem-overlay@technik.fem-net.de> wenden.
-</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 ====
   * Verwende bei neuen Ebuilds die aktuellste [[http://devmanual.gentoo.org/ebuild-writing/eapi/index.html|EAPI]]. ([[http://dev.gentoo.org/~ulm/pms/head/eapi-cheatsheet.pdf|EAPI Cheat-Sheet]])
+    * Einzelne eclasses unterstützen nicht die neueste EAPI. In diesem Fall kann die nächstältere benutzt werden. EAPIs, die im Overlay als veraltet markiert sind, //dürfen nicht// in neuen ebuilds benutzt werden.
   * Im Files-Ordner sollen keine Archive, sondern nur Skripte und Patches liegen.
   * Alle Ebuilds besitzen einen validen Header
 <code|Header>
-# Copyright 1999-2XXX Gentoo Foundation
+# Copyright 1999-2XXX Gentoo Authors
 # Distributed under the terms of the GNU General Public License v2
 </code>
@@ Zeile 103: / Zeile 101: @@
 DEPEND
 RDEPEND
+BDEPEND
 S
@@ Zeile 111: / Zeile 110: @@
   * Variablen, die evtl. Leerzeichen enthalten könnten müssen bei Verwendung mit Kommandos gequotet werden
-    * standardmäßig: ${S}, ${WORKDIR}, ${FILESDIR}, ${DISTDIR}, ${ROOT}, ${D}
+    * standardmäßig: ''${S}, ${WORKDIR}, ${FILESDIR}, ${DISTDIR}, ${ROOT}, ${D}''
 <code|Beispiel>
@@ Zeile 118: / Zeile 117: @@
 # Quoting nötig, da der Pfad u.U. Leerzeichen enthält
-cd "${S}"
+cd "${S}" || die
 </code>
-  * möglichst eine metadata.xml anlegen mit Informationen, wer das Paket im Overlay betreut und welche Useflags verwendet werden
+  * möglichst eine metadata.xml anlegen mit Informationen, wer das Paket im Overlay betreut und welche Useflags verwendet werden. Die E-Mail-Adressen der Betreuer werden in der [[https://gitlab.fem-net.de/gentoo/fem-overlay-ci-tools/-/settings/ci_cd|CI-Konfiguration]] der fem-overlay-ci-tools hinterlegt, um eine automatische Zuweisung von Issues aufgrund der betroffenen Pakete zu ermöglichen.
 <file|Beispiel für metadata.xml>
 <?xml version="1.0" encoding="UTF-8"?>
@@ Zeile 135: / Zeile 134: @@
 </pkgmetadata>
 </file>
+  * Manifest erstellen mit pkgdev oder RepoMan:
+    * ''pkgdev manifest''
+    * ''repoman manifest''
   * RepoMan zur Prüfung des Ebuilds verwenden
-    * Verwendung:
+      * ''repoman full -dx'' (Prüft alle Ebuilds im aktuellen Verzeichnis)
-      * //**repoman manifest**// (Erstellt Manifest neu)
+  * pkgdev oder RepoMan zum commiten benutzen
-      * //**repoman**// (Prüft alle Ebuilds im aktuellen Verzeichnis)
+      * ''repoman commit''
-      * //**repoman commit**// (Erstellt einen Commit und fügt Metainformationen hinzu, falls die Prüfung erfolgreich war)
+      * ''pkgdev commit''
+  * pkgcheck zur Prüfung des Ebuilds verwenden
+    * ''pkgcheck scan'' (prüft Ebuilds im aktuellen Verzeichnis auf gängige Konventionen und Fehler)
 (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]] [[https://bamboo.fem.tu-ilmenau.de/browse/OVERLAY-CHECK|überprüft]].
+Das Overlay wird bei Änderungen u.A. mittels [[https://wiki.gentoo.org/wiki/Repoman|Repoman]] und pkgcheck per CI-Pipeline geprüft.
+Zudem werden ebuilds per [[https://blogs.gentoo.org/ago/2020/07/04/gentoo-tinderbox/|Tinderbox]] gebaut und Fehler gemeldet.
+**Sämtliche Pakete müssen erfolgreich die CI-Pipeline durchlaufen, um akzeptiert zu werden.**
 ==== Historie ====