# Les pmo-actions

Les actions de la *petite maison orange* sont des actions réutilisables dans un environnement Gitea.
Elles sont avant tout faites pour me faciliter la vie dans la gestion de mon nuage personnel.

Pour les inclures utiliser la syntaxe:

```yaml
        uses: https://gargoton.petite-maison-orange.fr/pmo-actions/ACTION@main
```

En remplaçant `ACTION` par l'action désirée.

## L'action `healthchecks-ping`

Elle a pour but d'envoyer un ping sur un serveur [`healthchecks.io`](https://healthchecks.io/). Elles acceptent 
quatre valeurs en entrée, dont deux premières sont obligatoires.

- `server`: l'adresse du serveur inclue le protocole
            par exemple: `https://monserveur.mondomaine.io`
- `uuid`: l'identifiant hexadecimal du service. l'*uuid* sera combiné avec
          l'adresse du serveur pour construire l'URL à sonner:
          `$serveur/ping/$uuid`

- `command`: cette valeur peut prendre 4 valeurs : `start`|`log`|`fail`|`stop`.

- `message`: Le message qui sera logguer lors du ping sur le serveur [`healthchecks.io`](https://healthchecks.io/).