Modification de Gitlab: utiliser le depot composer

{{ArticleHead|Adadov}}

Gitlab intègre des fonctionnalités de dépôt aussi bien pour les packages que les images docker.Ce qui permet de facilement déployer pour soit même les packages qu'on développe. On va donc voir comment configurer composer pour accéder au dépôt de packages gitlab.

=== Prérequis dans le dépôt ===
Gitlab nécessite des références pour créer les packages. Il se base sur les étiquettes (tag).

Donc si vous souhaitez créer un package il faudra une étiquette sur le commit qui sera utilisé.

=== Création du package ===

==== Création manuelle ====
Vous pouvez demander, via l'API uniquement, la création manuelle des package.

Il faudra donc un token API pour utiliser cette fonction avec un minimum les droits suivants: 

* api
* read_api
* read_repository
* read_registry
* write_registry

Une fois votre clé en main, il suffit de faire une simple requête curl
{{LxTerm|text=curl --header "PRIVATE-TOKEN: <api_key>" --data branch=<branch> "https://git.exemple.com/api/v4/projects/<project_id>/packages/composer"|user=user}}

=== Configuration de composer ===
{{Info|La configuration peut être globale ou dédiée au projet, suivant votre besoin.}}

==== Configuration d'un simple projet ====
Du côté de composer il faudra aussi ajouter votre dépôt, personnellement j'ai choisi de configurer globalement.

J'utilise le driver Gitlab de composer directement, il permet de configurer directement avec l'URL de votre projet à la place d'une URL API des fois un peu obscure ...
{{LxTerm|text=composer config -g repositories.<repo_name> gitlab <repo_url>|user=user}}
Ajoutez aussi votre domaine gitlab dans votre configuration:
{{LxTerm|text=composer config -g gitlab-domains "<gitlab_domains>"|user=user}}

==== Configuration d'un groupe de projet ====
Pour me simplifier la vie, j'ai créé un groupe pour mes différentes extensions composer, ça simplifie la configuration du client.
{{LxTerm|text=composer config repositories.<url>/<groupid> '{"type": "composer", "url": "https://<url>/api/v4/group/<groupid>/-/packages/composer/packages.json"}'}}

==== Configuration du token d'accès ====
{{Warning|text=Si votre dépôt a une visibilité limitée, Il faudra ajouter votre personal token dans la configuration de composer:}}
{{LxTerm|text=composer config -g gitlab-token.<gitlab_domain> <token>|user=user}}
[[Catégorie:SysAdmin]]