Dieses Repository enthält die APKBUILD-Dateien für jedes einzelne Alpine-Linux-Paket sowie gegebenenfalls die erforderlichen Patches und Skripte.
Es enthält auch einige zusätzliche Dateien und Verzeichnisse, die sich auf das Testen (und damit Erstellen) dieser Pakete auf GitLab (über GitLab CI) beziehen.
Wenn Sie einen Beitrag leisten möchten, lesen Sie bitte den Leitfaden für Mitwirkende und senden Sie entweder eine Zusammenführungsanfrage auf GitLab oder einen Git-Patch auf der Alpine Aports-Mailingliste (~alpine/[email protected]). (Hinweis: Diese Mailingliste ist derzeit nicht funktionsfähig)
Der Alpine Linux-Aports-Baum besteht aus 3 Repositorys (Verzeichnissen). Jedes dieser drei Repositorys verfügt über eigene Richtlinien, Anwendungsfälle und Arbeitsabläufe. Nachfolgend finden Sie eine Definition der grundlegenden Richtlinien, die für Ihr Paket gelten sollten. Es können zusätzliche Richtlinien gelten. Weitere Informationen finden Sie in unseren Entwicklerrichtlinien.
Pakete im Haupt-Repository sollten gemäß unserer offiziellen Dokumentation zum Veröffentlichungszyklus unterstützt werden, wie auf unserer Website definiert. Im Zweifelsfall sollte ein Paket stattdessen in unser Community-Repository verschoben werden. Die Richtlinie für ein Paket im Haupt-Repository lautet, ob dieses Paket in einem Basissystem zumutbar ist und ihm ein Entwickler zugewiesen ist, der es wie auf unserer Release-Seite dokumentiert pflegen kann. Von einem Paket im Hauptpaket wird außerdem erwartet, dass es eine ordnungsgemäße Dokumentation enthält, wenn es mit dem Quellcode geliefert wird, und über aktivierte Testsuiten verfügt, sofern bereitgestellt. Neue Pakete werden selten direkt in das Haupt-Repository eingeführt und sollten dem Arbeitsablauf folgen: testing => main
.
Pakete im Community-Repository sollten gemäß unserer offiziellen Dokumentation zum Veröffentlichungszyklus unterstützt werden, wie auf unserer Website definiert. Pakete in der Community sind solche, die nicht zu unserem Haupt-Repository gehören und deren Tests in unserem Test-Repository abgeschlossen sind. Ein Paket sollte einen Betreuer haben und über aktivierte Testsuiten verfügen, sofern bereitgestellt, und wird der Auslieferung von Dokumentation vorgezogen, wenn der Quellcode dies bereitstellt. Neue Pakete werden selten direkt in das Community-Repository eingeführt und sollten dem Arbeitsablauf folgen: testing => community
Pakete in den Test-Repositories folgen nicht unserer offiziellen Release-Zyklus-Dokumentation, wie auf unserer Website definiert, sind nicht in unseren offiziellen Releases enthalten und werden nur in unserem Edge-Zweig versendet. Dieses Repository ist speziell zum Einführen und Testen von Paketen sowie als Staging-Bereich für unsere anderen Repositorys konzipiert. Die Pakete folgen keiner der zuvor genannten Richtlinien und müssen lediglich korrekt erstellt werden können. Nachdem überprüft wurde, dass das Paket funktioniert, sollte es so bald wie möglich gemäß den für dieses Repository festgelegten Richtlinien in eines der anderen Repositorys verschoben werden. Wenn das Paket nicht innerhalb eines Zeitraums von 6 Monaten verschoben wird, benachrichtigen wir den Betreuer und entfernen es nach 9 Monaten.
Einige nützliche Git-Hooks finden Sie im Verzeichnis .githooks
. Um sie zu verwenden, führen Sie nach dem Klonen dieses Repositorys den folgenden Befehl aus:
git config --local core.hooksPath .githooks