Acciones de trabajo de Ansible

Esta página proporciona una referencia completa de las acciones de trabajos de Ansible disponibles en el catálogo de acciones de automatización de flujos de trabajo. Estas acciones le permiten lanzar y administrar plantillas de trabajos de la plataforma Ansible Automation (Automation Controller).

Requisitos previos

Antes de usar las acciones de Ansible en la automatización del flujo de trabajo, asegúrese de tener:

Una instancia de la plataforma Ansible Automation (Automation Controller) accesible a través de HTTPS.
Un token OAuth2 con alcance de escritura para el lanzamiento de trabajos (cree uno en Automation Controller > Users > Tokens).
El ID numérico de la plantilla de trabajo que desea lanzar.
La configuración ask_*_on_launch habilitada en la plantilla de trabajo para cada entrada opcional que planea usar (extraVars, limit, inventory).

Acciones de trabajo

Realiza el lanzamiento de una plantilla de trabajo de la plataforma Ansible Automation (Automation Controller) y devuelve el trabajo creado. Esta acción se basa en la acción base http.post.

El extremo es POST https://{host}/api/controller/v2/job_templates/{jobTemplateId}/launch/

Campo de entrada	Opcionalidad	Tipo	Ejemplo
anfitrión	Requerido	Cadena	`${{ :secrets:host }}` Nombre de host (y puerto opcional) del Automation Controller, sin esquema, por ejemplo, aap.example.com.
authToken	Requerido	Cadena	`${{ :secrets:ansibleControllerToken }}` Token OAuth2, enviado como `Authorization: Bearer <token>`. Cree en Automation Controller → usuario → token con alcance de escritura para el lanzamiento.
jobTemplateId	Requerido	En t	`42`
extraVars	Opcional	Mapa	`{"target_env": "staging", "app_version": "1.2.3"}` Asignado a `extra_vars`. Solo tiene efecto si la plantilla tiene `ask_variables_on_launch` (o una encuesta) habilitada.
limit	Opcional	Cadena	`web-servers` Patrón de host de Ansible. Asignado a `limit`. Requiere `ask_limit_on_launch`.
inventario	Opcional	Cadena	`7` ID de inventario numérico (anula el valor predeterminado de la plantilla). Asignado a `inventory`. Requiere `ask_inventory_on_launch`.
jobTags	Opcional	Cadena	`deploy,restart` Etiquetas separadas por comas. Asignado a `job_tags`. Requiere `ask_tags_on_launch`.
skipTags	Opcional	Cadena	`notifications` Etiquetas separadas por comas para omitir. Asignado a `skip_tags`. Requiere `ask_skip_tags_on_launch`.
selectors	Opcional	Lista	`[{"name": "jobId", "expression": ".id"}, {"name": "status", "expression": ".status"}]`

Campo de salida	Tipo	Ejemplo
success	Booleano	`success: true \| false`
response	Objeto	`{ "id": 128, "status": "pending", "job_template": 42, "url": "/api/controller/v2/jobs/128/" }`
errorMessage	Cadena	`{ "detail": "Variables not allowed on launch." }`

Ejemplo de flujo de trabajo
`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`

Ejemplo de flujo de trabajo

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

Te ofrecemos esta traducción automática para facilitar la lectura.

Requisitos previos

Acciones de trabajo

Lanzamiento de una plantilla de trabajo de Ansible

Te ofrecemos esta traducción automática para facilitar la lectura.

Acciones de trabajo de Ansible

Requisitos previos.css-21sua1{background:none;border:none;width:0;padding:0;}

Acciones de trabajo

Requisitos previos