Ce référentiel contient les fichiers APKBUILD pour chaque package Alpine Linux, ainsi que les correctifs et scripts requis, le cas échéant.
Il contient également des fichiers et répertoires supplémentaires liés au test (et donc à la construction) de ces packages sur GitLab (via GitLab CI).
Si vous souhaitez contribuer, veuillez lire le guide du contributeur et n'hésitez pas à soumettre une demande de fusion sur GitLab ou à soumettre un patch git sur la liste de diffusion Alpine aports (~alpine/[email protected]). (remarque : cette liste de diffusion n'est actuellement pas fonctionnelle)
L'arborescence des ports Alpine Linux se compose de 3 référentiels (répertoires). Chacun de ces 3 référentiels possède son propre ensemble de politiques, de cas d'utilisation et de flux de travail. Vous trouverez ci-dessous une définition des politiques de base auxquelles votre forfait doit s'appliquer. Des politiques supplémentaires peuvent s'appliquer. Veuillez vous référer à nos directives pour les développeurs.
Les packages du référentiel principal doivent être pris en charge conformément à notre documentation officielle du cycle de publication telle que définie sur notre site Web. En cas de doute, un package doit plutôt être déplacé vers notre référentiel communautaire. La politique pour un package dans le référentiel principal est de savoir si ce package est raisonnablement attendu dans un système de base et si un développeur lui est affecté qui peut le maintenir comme documenté sur notre page de publication. Un package dans main devrait également inclure la documentation appropriée s'il est livré avec le code source et avoir des suites de tests activées si elles sont fournies. Les nouveaux packages sont rarement introduits directement dans le référentiel principal et doivent suivre le workflow : testing => main
.
Les packages du référentiel communautaire doivent être pris en charge conformément à notre documentation officielle du cycle de publication telle que définie sur notre site Web. Les packages de la communauté sont ceux qui n'appartiennent pas à notre référentiel principal et qui ont terminé leurs tests dans notre référentiel de tests. Un package doit avoir un responsable et avoir des suites de tests activées si elles sont fournies et il est préférable d'envoyer la documentation si le code source le fournit. Les nouveaux packages sont rarement introduits directement dans le dépôt de la communauté et doivent suivre le workflow : testing => community
Les packages des référentiels de test ne suivent pas notre documentation officielle du cycle de publication telle que définie sur notre site Web et ne sont pas inclus dans nos versions officielles et ne sont expédiés que dans notre branche Edge. Ce référentiel est spécifiquement conçu pour introduire et tester des packages et comme zone de préparation pour nos autres référentiels. Les packages ne suivent aucune des politiques mentionnées précédemment et doivent seulement pouvoir être construits correctement. Une fois que le fonctionnement du package est vérifié, il doit être déplacé vers l'un des autres référentiels dès que possible, conformément aux politiques définies pour ce référentiel. Si le paquet n'est pas déplacé dans un délai de 6 mois, nous en informerons le responsable et le supprimerons après 9 mois.
Vous pouvez trouver des hooks git utiles dans le répertoire .githooks
. Pour les utiliser, exécutez la commande suivante après avoir cloné ce référentiel :
git config --local core.hooksPath .githooks