# L'action `push-image`

Cette action permet de pousser une image Docker dans un registre à l'aide des outils `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: Build and push Docker image
  uses: https://gargoton.petite-maison-orange.fr/pmo-actions/push-image@main
  with:
    image_name: my_image
    image_tags: latest stable
```
---

## 📥 Paramètres

| Nom               | Obligatoire | Par défaut                          | Description                                                                     |
|-------------------|-------------|-------------------------------------|---------------------------------------------------------------------------------|
| `image_name`      | ✅           | –                                   | Nom de l'image à pousser.                                                       |
| `image_tags`      | ✅           | –                                   | Liste des tags à ajouter à l'image avant de la pousser.                         |
| `registry_login`  | ❌           | `false`                             | Indique si l'action doit se connecter au registre avant de pousser l'image.    |
| `registry_user`   | ❌           | `${{ secrets.PMO_REGISTRY_USER }}`  | Utilisateur pour se connecter au registre.                                      |
| `registry_password`| ❌          | `${{ secrets.PMO_REGISTRY_PASSWORD }}`| Mot de passe pour se connecter au registre.                                    |
| `registry_server` | ❌           | `niepce.petite-maison-orange.fr`    | Adresse du serveur du registre d'images Docker.                                 |
| `push_command`    | ❌           | `podman`                            | Commande à utiliser pour pousser l'image (`docker` ou `podman`).               |
| `debug`           | ❌           | `false`                             | Mode débogage. Si activé, affiche des informations détaillées pendant l'exécution. |

---

## ▶️ Exemple de workflow

```yaml
- name: Push Docker image
  uses: https://gargoton.petite-maison-orange.fr/pmo-actions/push-image@main
  with:
    image_name: my_image
    image_tags: latest stable
    registry_login: true
    registry_user: ${{ secrets.PMO_REGISTRY_USER }}
    registry_password: ${{ secrets.PMO_REGISTRY_PASSWORD }}
    registry_server: niepce.petite-maison-orange.fr
    push_command: docker
    debug: true
```

---

## ⚙️ Comportement

- Si l'option `registry_login` est activée, l'action se connecte au registre avant de pousser l'image.
- Si la commande `push_command` échoue, l'action renvoie une erreur.
- L'image est poussée sous chaque tag spécifié dans le paramètre `image_tags`.
- Si `debug` est activé, des informations détaillées sont affichées pendant le processus.

---

## 🧡 À 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/)