ForgejoActions/dockerLogin/README.md

Action "Docker login to registry"

Description

Une action composite permettant de se connecter au registry Docker de Pixao en utilisant les secrets de Forgejo.

Le registry utilisé est celui intégré à Forgejo : son adresse est donc identique à l'URL de l'instance Forgejo.

L'action exécute simplement un docker login en passant le mot de passe via --password-stdin (le mot de passe n'apparaît donc pas dans la ligne de commande).

Paramètres

Paramètre	Obligatoire	Défaut	Description
REGISTRY_URL	Non	https://forgejo.pixao.fr	Adresse du registry (identique à l'URL Forgejo car on utilise le registry intégré à ce dernier).
REGISTRY_USER	Oui	—	Utilisateur pour se connecter au registry.
REGISTRY_PASSWORD	Oui	—	Mot de passe de l'utilisateur.

Exemple d'utilisation

steps:
  - name: Connexion au registry
    uses: https://forgejo.pixao.fr/CI-CD/ForgejoActions/dockerLogin@master
    with:
      REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
      REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
      # REGISTRY_URL est optionnel, la valeur par défaut pointe vers le registry Pixao

Points d'attention

• Docker requis : le runner qui exécute cette action doit disposer de la commande docker et avoir accès au démon Docker.
• Secrets Forgejo : REGISTRY_USER et REGISTRY_PASSWORD doivent être fournis via les secrets de Forgejo et jamais écrits en clair dans le workflow.
• URL par défaut : la valeur par défaut de REGISTRY_URL (https://forgejo.pixao.fr) est spécifique à l'infrastructure Pixao. Si vous changez d'environnement, pensez à surcharger ce paramètre.
• Persistance de la session : le docker login reste valable pour les étapes suivantes du même job. Il faut se reconnecter dans chaque job qui en a besoin.