Files
push-image/README.md

67 lines
3.1 KiB
Markdown
Raw Normal View History

2025-04-14 13:02:19 +02:00
2025-04-14 13:42:11 +02:00
# L'action `push-image`
Cette action permet de pousser une image Docker dans un registre à l'aide des outils `docker` ou `podman`.
2025-04-14 13:02:19 +02:00
Elle est conçue pour être utilisée dans des workflows Gitea avec des runners auto-hébergés.
---
## 🔧 Utilisation
```yaml
2025-04-14 13:42:11 +02:00
- 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
2025-04-14 13:02:19 +02:00
```
---
## 📥 Paramètres
2025-04-14 13:42:11 +02:00
| 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. |
2025-04-14 13:02:19 +02:00
---
## ▶️ Exemple de workflow
```yaml
2025-04-14 13:42:11 +02:00
- name: Push Docker image
uses: https://gargoton.petite-maison-orange.fr/pmo-actions/push-image@main
2025-04-14 13:02:19 +02:00
with:
2025-04-14 13:42:11 +02:00
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
2025-04-14 13:02:19 +02:00
```
---
## ⚙️ Comportement
2025-04-14 13:42:11 +02:00
- 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.
2025-04-14 13:02:19 +02:00
---
## 🧡 À 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/)