Gitlab: utiliser le depot composer
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
[user@linux] $ | curl --header "PRIVATE-TOKEN: <api_key>" --data branch=<branch> "https://git.exemple.com/api/v4/projects/<project_id>/packages/composer" | dblclick to copy |
Configuration de composer
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 ...
[user@linux] $ | composer config -g repositories.<repo_name> gitlab <repo_url> | dblclick to copy |
Ajoutez aussi votre domaine gitlab dans votre configuration:
[user@linux] $ | composer config -g gitlab-domains "<gitlab_domains>" | dblclick to copy |
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.
[root@linux] # | composer config repositories.<url>/<groupid> '{"type": "composer", "url": "https://<url>/api/v4/group/<groupid>/-/packages/composer/packages.json"}' | dblclick to copy |
Configuration du token d'accès
Si votre dépôt a une visibilité limitée, Il faudra ajouter votre personal token dans la configuration de composer: |
[user@linux] $ | composer config -g gitlab-token.<gitlab_domain> <token> | dblclick to copy |