Actualiser README.md

This commit is contained in:
2025-04-14 14:28:05 +02:00
parent bf7636afa3
commit 884edebd14

View File

@@ -1,6 +1,6 @@
# L'action `healthchecks-ping`
# L'action `software-version`
Cette action permet denvoyer un *ping* vers un serveur [Healthchecks.io](https://healthchecks.io) (ou un serveur compatible).
Cette action extrait le numéro de version dun logiciel à partir dun fichier, généralement utilisé pour taguer une image Docker.
Elle est conçue pour être utilisée dans des workflows Gitea avec des runners auto-hébergés.
---
@@ -8,54 +8,45 @@ Elle est conçue pour être utilisée dans des workflows Gitea avec des runners
## 🔧 Utilisation
```yaml
- name: Notify healthchecks
uses: https://gargoton.petite-maison-orange.fr/pmo-actions/healthchecks-ping@main
- name: Get software version
uses: https://gargoton.petite-maison-orange.fr/pmo-actions/software-version@main
id: getversion
with:
version_file: my_version.txt
```
Le résultat est accessible via `${{ steps.getversion.outputs.version }}`.
---
## 📥 Paramètres
| Nom | Obligatoire | Par défaut | Description |
|------------------|-------------|------------|-----------------------------------------------------------------------------|
| `check_server` | | | Adresse du serveur Healthchecks, incluant `https://`. |
| `check_uuid` | | | Identifiant UUID de la vérification. |
| `check_command` | ❌ | `stop` | Commande : `start`, `log`, `fail`, ou `stop`. |
| `check_message` | ❌ | `""` | Message transmis avec le ping (visible dans linterface Healthchecks). |
| `debug` | ❌ | `false` | Affiche des messages de debug détaillés si activé. |
| Nom | Obligatoire | Par défaut | Description |
|------------------|-------------|--------------------------|-----------------------------------------------------------------------------|
| `git_checkout` | | `false` | Clone le dépôt courant si activé. Utile si le fichier version est dans le repo. |
| `version_file` | | `software_version.txt` | Nom du fichier contenant la version du logiciel (1re ligne non vide utilisée). |
| `debug` | ❌ | `false` | Mode débogage. Si activé, affiche des informations détaillées. |
---
## ▶️ Exemple de workflow
```yaml
- name: Notify healthchecks (start)
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_command: start
- name: Get version
id: getversion
uses: https://gargoton.petite-maison-orange.fr/pmo-actions/software-version@main
- name: Build my project
run: make build
- name: Notify healthchecks (stop)
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 ✅"
- name: Build image
run: echo "Version: ${{ steps.getversion.outputs.version }}"
```
---
## ⚙️ Comportement
- Si `check_command: fail` est utilisé, **laction échoue volontairement** (`exit 1`).
- Si `curl` échoue, laction affiche lerreur et échoue également.
- LURL appelée par `curl` dépend de la commande :
- `https://<check_server>/ping/<uuid>` *(commande `stop` ou vide)*
- `https://<check_server>/ping/<uuid>/<check_command>` *(commande `start`, `log`, `fail`)*
- Si le fichier spécifié n'existe pas, l'action échoue.
- La première ligne non vide est utilisée comme version.
- Les espaces sont supprimés au début et à la fin, les espaces internes sont remplacés par des tirets.
---
@@ -63,4 +54,4 @@ Elle est conçue pour être utilisée dans des workflows Gitea avec des runners
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/)
👉 [https://gargoton.petite-maison-orange.fr/pmo-actions/](https://gargoton.petite-maison-orange.fr/pmo-actions/)