Onglet Hooks

L'onglet Hooks n'est visible qu'après avoir activé les hooks personnalisés dans l'onglet Virtualisation.

Les hooks permettent d'exécuter un script en fonction d'actions (création, lancement, arrêt, suppression…) opérées sur les machines virtuelles.

Passer la variable Hooks sur les machines virtuelles à oui et cliquer sur le bouton + Nom du hook des machines virtuelles permet d'ajouter un hook.

Il est possible d'ajouter plusieurs hooks.

  • Nom du hook des machines virtuelles : choisir un nom unique ;

  • Déclencheur (on) : choisir l'action sur laquelle déclencher le hook ;

  • Script à déclencher (command) : saisir le nom du script personnalisé qui sont à stocker dans /var/lib/one/remotes/hooks/ ;

  • Arguments à passer au script (arguments) : argument à passer à l'appel du hook ($ID, $PREV_STATE $PREV_LCM_STATE…) ;

  • Exécuter sur les nœuds (remote) : provoque la copie des hooks sur les différents nœuds du cluster ;

  • État attendu en déclencheur CUSTOM (state) : État attendu par le hook lorsque le déclencheur est "CUSTOM" ;

  • État LCM attendu en déclencheur CUSTOM (lcm_state) : État LCM attendu par le hook lorsque le déclencheur est "CUSTOM" .

Les hooks permettent d'exécuter un script en fonction d'actions (création, suppression) opérées sur les utilisateurs.

Passer la variable Hooks sur les utilisateurs à oui et cliquer sur le bouton + Nom du hook d'utilisateur permet d'ajouter un hook.

Il est possible d'ajouter plusieurs hooks.

Nom du hook d'utilisateur : choisir un nom unique ;

Déclencheur (on) : choisir l'action sur laquelle déclencher le hook ;

Script à déclencher (command) : saisir le nom du script personnalisé qui sont à stocker dans /var/lib/one/remotes/hooks/ ;

Arguments à passer au script (arguments) : argument à passer à l'appel du hook.

Remarque

Des exemples de hooks sont documentés en anglais dans le fichier /etc/one/oned.conf (VM_HOOK et USER_HOOK).

L'utilisation des hooks est documenté en anglais à l'adresse suivante :

https://docs.opennebula.io/6.6/integration_and_development/system_interfaces/hook_driver.html