Utiliser l’agent invité OUTSCALE

Ce guide technique fournit des instructions étape par étape pour utiliser l’agent invité OUTSCALE (guest-agent) sur votre VM Linux. Utiliser l’agent invité peut vous permettre de créer des snapshots cohérents au niveau applicatif.

Installer guest-agent

Avant de commencer : Vérifiez les prérequis pour votre distribution sur le dépôt Github guest-agent.

Téléchargez et installez le paquet le plus récent depuis la page de Releases selon la distribution de votre VM (fichier .deb pour Debian / Ubuntu, fichier .rpm pour RHEL / Rocky).

Les paquets sont signés avec Sigstore : vous pouvez les valider à l’aide de Cosign. Pour en savoir plus, voir Signature Verification.

D’autres méthodes vous permettent d’installer guest-agent à l’aide de Cargo. Pour en savoir plus, voir Installation

Définir les actions de votre agent invité

Pour définir les actions réalisées par l’agent invité sur votre VM, vous devez utiliser des fichiers hook stockés dans les répertoires correspondant aux différentes phases d’exécution :

Phase Répertoire hooks

Phase	Répertoire hooks
`begin`	`snapshot.d`
`commit`	`snapshot-commit.d`
`completed`	`snapshot-completed.d`

begin

snapshot.d

commit

snapshot-commit.d

completed

snapshot-completed.d

Pour chaque phase, la première racine contenant ce répertoire est utilisée. Les autres racines sont ignorées jusqu’à la phase suivante.

Créer des snapshots cohérents avec les applications

Les hooks de snapshot sont des fichiers exécutables qui se trouvent dans le répertoire /etc/guest-agent/ et suivent les règles de nommage run-parts (les caractères autorisés sont a-z, A-Z, 0-9, et - _). Ils sont exécutés dans l’ordre alphabétique, l’un après l’autre.

Des hooks génériques sont disponibles en tant qu’exemples dans le paquet, sous le répertoire /etc/guest-agent/. Ils sont nommés avec le suffixe .disable, ce qui leur permet d’être ignorés puisque leur nom contient un caractère non-autorisé (.). Pour utiliser l’un de ces hooks, activez-le en supprimant son suffixe.

Répertoire de la phase Hooks, dans l’odre d’exécution

Répertoire de la phase	Hooks, dans l’odre d’exécution
snapshot.d	a `40-pod-exec` (pod `begin-command`, mettre la charge de travail en veille), `50-fsfreeze` (gel)
snapshot-commit.d	`90-pod-exec` (pod `commit-command`)
snapshot-completed.d	a `50-fsfreeze` (dégel) `90-pod-exec` (pod `completed-command`, reprendre la charge de travail)

snapshot.d

a 40-pod-exec (pod begin-command, mettre la charge de travail en veille), 50-fsfreeze (gel)

snapshot-commit.d

90-pod-exec (pod commit-command)

snapshot-completed.d

a 50-fsfreeze (dégel) 90-pod-exec (pod completed-command, reprendre la charge de travail)

Le snapshot cohérent avec les applications est prêt une fois qu’il a atteint la phase completed. Vous devez reprendre la charge de travail depuis snapshot-completed.d, après la restauration, et jamais depuis snapshot-commit.d.

Pour en savoir plus, voir hooks.md dans le dépôt Github.

Page connexe

Dépôt Github OUTSCALE guest-agent