registry-login/README.md

# L'action `registry-login`

Cette action permet de se connecter à un registre Docker (ou Podman).  
Elle est conçue pour être utilisée dans des workflows Gitea avec des runners auto-hébergés.

---

## 🔧 Utilisation

```yaml
- name: Connect to Docker registry
  uses: https://gargoton.petite-maison-orange.fr/pmo-actions/registry-login@main
```

---

## 📥 Paramètres

| Nom               | Obligatoire | Par défaut                | Description                                                                      |
|-------------------|-------------|---------------------------|----------------------------------------------------------------------------------|
| `registry_command` | ❌           | `podman`                  | Commande utilisée pour la connexion (ex : `docker` ou `podman`).                 |
| `registry_server`  | ❌           | `niepce.petite-maison-orange.fr` | Adresse du serveur du registre Docker.                                           |
| `registry_user`    | ❌           | `${{ secrets.PMO_REGISTRY_USER }}` | Nom d’utilisateur pour la connexion.                                             |
| `registry_password`| ❌           | `${{ secrets.PMO_REGISTRY_PASSWORD }}` | Mot de passe pour la connexion.                                                  |
| `debug`            | ❌           | `false`                   | Affiche des messages de debug détaillés si activé.                               |

---

## ▶️ Exemple de workflow

```yaml
- name: Connect to Docker registry
  uses: https://gargoton.petite-maison-orange.fr/pmo-actions/registry-login@main
  with:
    registry_server: niepce.petite-maison-orange.fr
    registry_user: ${{ secrets.PMO_REGISTRY_USER }}
    registry_password: ${{ secrets.PMO_REGISTRY_PASSWORD }}
```

---

## ⚙️ Comportement

- Si l’action réussit, un message de succès est affiché.
- Si l’action échoue (par exemple, si la connexion au registre échoue), un message d’erreur est affiché et l’action échoue également.
- L'action utilise la commande `login` pour établir la connexion au registre avec l'utilisateur et le mot de passe fournis.

---

## 🧡 À propos

Cette action fait partie des actions de la **Petite Maison Orange**.  
Toutes les actions sont disponibles ici :  
👉 [https://gargoton.petite-maison-orange.fr/pmo-actions/](https://gargoton.petite-maison-orange.fr/pmo-actions/)