pmo-actions/push-image
1
0
Fork 0
generated from pmo-actions/healthchecks-ping
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Actualiser README.md

Browse Source
This commit is contained in:
Eric Coissac
2025-04-14 13:42:11 +02:00
parent 033f5cc3da
commit 420e5f4cd5
1 changed files with 32 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files

64
README.md
View File

@@ -1,6 +1,7 @@
# L'action `healthchecks-ping`
Cette action permet d’envoyer un *ping* vers un serveur [Healthchecks.io](https://healthchecks.io) (ou un serveur compatible). # 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. Elle est conçue pour être utilisée dans des workflows Gitea avec des runners auto-hébergés.
--- ---
@@ -8,54 +9,53 @@ Elle est conçue pour être utilisée dans des workflows Gitea avec des runners
## 🔧 Utilisation ## 🔧 Utilisation
```yaml ```yaml
- name: Notify healthchecks - name: Build and push Docker image
uses: https://gargoton.petite-maison-orange.fr/pmo-actions/healthchecks-ping@main uses: https://gargoton.petite-maison-orange.fr/pmo-actions/push-image@main
with:
image_name: my_image
image_tags: latest stable
``` ```
--- ---
## 📥 Paramètres ## 📥 Paramètres
| Nom | Obligatoire | Par défaut | Description | | Nom | Obligatoire | Par défaut | Description |
|------------------|-------------|------------|-----------------------------------------------------------------------------| |-------------------|-------------|-------------------------------------|---------------------------------------------------------------------------------|
| `check_server` | ✅ | – | Adresse du serveur Healthchecks, incluant `https://`. | | `image_name` | ✅ | – | Nom de l'image à pousser. |
| `check_uuid` | ✅ | – | Identifiant UUID de la vérification. | | `image_tags` | ✅ | – | Liste des tags à ajouter à l'image avant de la pousser. |
| `check_command` | ❌ | `stop` | Commande : `start`, `log`, `fail`, ou `stop`. | | `registry_login` | ❌ | `false` | Indique si l'action doit se connecter au registre avant de pousser l'image. |
| `check_message` | ❌ | `""` | Message transmis avec le ping (visible dans l’interface Healthchecks). | | `registry_user` | ❌ | `${{ secrets.PMO_REGISTRY_USER }}` | Utilisateur pour se connecter au registre. |
| `debug` | ❌ | `false` | Affiche des messages de debug détaillés si activé. | | `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 ## ▶️ Exemple de workflow
```yaml ```yaml
- name: Notify healthchecks (start) - name: Push Docker image
uses: https://gargoton.petite-maison-orange.fr/pmo-actions/healthchecks-ping@main uses: https://gargoton.petite-maison-orange.fr/pmo-actions/push-image@main
with: with:
check_server: https://hc-ping.com image_name: my_image
check_uuid: a1b2c3d4-1234-5678-9abc-def123456789 image_tags: latest stable
check_command: start registry_login: true
registry_user: ${{ secrets.PMO_REGISTRY_USER }}
- name: Build my project registry_password: ${{ secrets.PMO_REGISTRY_PASSWORD }}
run: make build registry_server: niepce.petite-maison-orange.fr
push_command: docker
- name: Notify healthchecks (stop) debug: true
uses: https://gargoton.petite-maison-orange.fr/pmo-actions/healthchecks-ping@main
with:
check_server: https://hc-ping.com
check_uuid: a1b2c3d4-1234-5678-9abc-def123456789
check_message: "Build terminé avec succès ✅"
``` ```
--- ---
## ⚙️ Comportement ## ⚙️ Comportement
- Si `check_command: fail` est utilisé, **l’action échoue volontairement** (`exit 1`). - Si l'option `registry_login` est activée, l'action se connecte au registre avant de pousser l'image.
- Si `curl` échoue, l’action affiche l’erreur et échoue également. - Si la commande `push_command` échoue, l'action renvoie une erreur.
- L’URL appelée par `curl` dépend de la commande : - L'image est poussée sous chaque tag spécifié dans le paramètre `image_tags`.
- `https://<check_server>/ping/<uuid>` *(commande `stop` ou vide)* - Si `debug` est activé, des informations détaillées sont affichées pendant le processus.
- `https://<check_server>/ping/<uuid>/<check_command>` *(commande `start`, `log`, `fail`)*
--- ---