Compléments d'informations sur "automation-cli"

À propos des commutateurs

Attention une mauvaise utilisation des commutateurs de commande “-op”, “-sshpass”, etc. peut entraîner des effets de bords liés au “parser commander”.

L’affectation d’une valeur à un commutateur s’écrit -[commutateur][espace]“[valeur]”, PAS DE ”=”

Exemple avec [-sshpass “Mot de passe clé SSH”], ne pas saisir [-sshpass=“Mot de passe clé SSH”], sinon “commander” ne gardera que “-s” qui correspond au mode silencieux pour la commande run.

Débogage (Debug)

Pour obtenir des informations de débogage, exécuter d’abord :

export MYTINYDCDEBUG=1

Puis exécuter l’automate de votre choix.

Les informations de débogage sont situées dans le répertoire : ”~/automation-cli.logs/automation-debug.log”. Le chemin complet est affiché dans la dernière ligne du rapport d’exécution.

Pour arrêter le débogage :

unset MYTINYDCDEBUG

ATTENTION : Les informations contenues dans le fichier de log du débogage peuvent faire apparaître des secrets…

Inactivité des hôtes

Quand une opération est exécutée par “automation-cli”, l’activité des hôtes est surveillée toutes les cinq secondes. “automation-cli” s’arrête automatiquement lorsque aucune activité n’a été détectée. La période par défaut est deux heures. Vous pouvez changer cette valeur en utilisant le commutateur -actto et indiquer une valeur en minutes.

Une activité est un événement sur les sorties “std” ou “stderr”.

Pour tester cette fonctionnalité :

automation-cli run -h "localhost" -actto 1 -c "sleep 120" -y

Bash

Protéger les variables à l’exécution, par l’exemple.

Afficher le contenu d’une variable passée dans l’environnement d’exécution : TESTTESTTEST=xxxx

# \$ see explanations
automation-cli run -h "localhost" -c "echo \$TESTTESTTEST" -y -e TESTTESTTEST="xxxx"
# OR
automation-cli run -h "localhost" -c 'echo "$TESTTESTTEST"' -y -e TESTTESTTEST="xxxx"

\$TESTTESTTEST parce que vous exécutez une commande bash. bash effectue la substitution de contenu avant exécution car le contenu est situé entre deux guillemets, pour plus de détails voir le fonctionnement de bash

Tâches ordonnancées (cron)

Dépendant du paramétrage de certains systèmes, dans un fichier “cron”, il est conseillé de préfixer la commande “automation-cli” par son emplacement réel “/usr/local/bin/automation-cli”. Pour éviter les envois de mails inutiles, ajoutez le paramètre “-s” (mode silencieux) qui supprime tout l’affichage de l’environnement “automation-cli”. Dans vos scripts, n’utilisez pas la sortie standard, conserver uniquement la sortie “stderr” pour les erreurs.

Sauvegarde des opérations

La bonne méthode reste de convertir le répertoire des opérations en dépôt Git. Cette partie est peu abordée dans le cadre de cette documentation. Pour plus d’information sur Git, c’est ici.

ATTENTION : Si vous enregistrez vos opérations dans un dépôt Git, vous devrez obligatoirement chiffrer vos inventaires.