Actions de tâche Ansible

Cette page fournit une référence complète des actions de tâche Ansible disponibles dans le catalogue des actions d'automatisation workflow. Ces actions vous permettent de lancer et de gérer les modèles de tâches de la plateforme Ansible Automation (Automation Controller).

Prérequis

Avant d'utiliser les actions Ansible dans l'automatisation workflow, assurez-vous de disposer de :

Une instance de la plateforme Ansible Automation (Automation Controller) accessible via HTTPS.
Un jeton OAuth2 avec une portée d'écriture pour le lancement de tâches (créez-en un sous Automation Controller > Users > Tokens).
L’ID numérique du modèle de tâche que vous souhaitez lancer.
Le paramètre ask_*_on_launch activé sur le modèle de tâche pour chaque entrée facultative que vous prévoyez d’utiliser (extraVars, limit, inventory).

Actions de job

Lancement d’un modèle de tâche Ansible Automation Platform (Automation Controller) et renvoi de la tâche créée. Cette action s’appuie sur l’action de base http.post.

Le point de terminaison est POST https://{host}/api/controller/v2/job_templates/{jobTemplateId}/launch/

Champ de saisie	optionnalité	Type	Exemple
host	Requis	Chaîne	`${{ :secrets:host }}` Nom d’hôte (et port facultatif) de l’Automation Controller, sans schéma, par exemple aap.example.com.
authToken	Requis	Chaîne	`${{ :secrets:ansibleControllerToken }}` Jeton OAuth2, envoyé en tant que `Authorization: Bearer <token>`. Créez sous Automation Controller → utilisateur → jeton avec une portée d'écriture pour le lancement.
jobTemplateId	Requis	Int	`42`
extraVars	Facultatif	Carte	`{"target_env": "staging", "app_version": "1.2.3"}` Mappé sur `extra_vars`. Ne prend effet que si le modèle a `ask_variables_on_launch` (ou une enquête) activé.
limit	Facultatif	Chaîne	`web-servers` Modèle d'hôte Ansible. Mappé sur `limit`. Nécessite `ask_limit_on_launch`.
inventaire	Facultatif	Chaîne	`7` ID d’inventaire numérique (remplace la valeur par défaut du modèle). Mappé sur `inventory`. Nécessite `ask_inventory_on_launch`.
jobTags	Facultatif	Chaîne	`deploy,restart` Tags séparés par des virgules. Mappé sur `job_tags`. Nécessite `ask_tags_on_launch`.
skipTags	Facultatif	Chaîne	`notifications` Tags séparés par des virgules à ignorer. Mappé sur `skip_tags`. Nécessite `ask_skip_tags_on_launch`.
selectors	Facultatif	List	`[{"name": "jobId", "expression": ".id"}, {"name": "status", "expression": ".status"}]`

Champ de sortie	Type	Exemple
success	Booléen	`success: true \| false`
response	Objet	`{ "id": 128, "status": "pending", "job_template": 42, "url": "/api/controller/v2/jobs/128/" }`
errorMessage	Chaîne	`{ "detail": "Variables not allowed on launch." }`

Exemple de workflow
`name: launch-ansible-remediation description: 'Launches an Ansible job template to remediate an incident' steps: - name: launch_job type: action action: ansible.job.launch version: 1 inputs: host: ${{ :secrets:host }} authToken: ${{ :secrets:ansibleControllerToken }} jobTemplateId: "42" extraVars: target_env: staging app_version: "1.2.3" next: end`

Exemple de workflow

name: launch-ansible-remediation
description: 'Launches an Ansible job template to remediate an incident'
steps:
  - name: launch_job
    type: action
    action: ansible.job.launch
    version: 1
    inputs:
      host: ${{ :secrets:host }}
      authToken: ${{ :secrets:ansibleControllerToken }}
      jobTemplateId: "42"
      extraVars:
        target_env: staging
        app_version: "1.2.3"
    next: end

Cette traduction automatique est fournie pour votre commodité.

Prérequis

Actions de job

Lancement d'un modèle de tâche Ansible

Cette traduction automatique est fournie pour votre commodité.

Actions de tâche Ansible

Prérequis.css-21sua1{background:none;border:none;width:0;padding:0;}

Actions de job

Prérequis