Ações de job do Ansible

Esta página fornece uma referência abrangente para as ações de job do Ansible disponíveis no catálogo de ações de automação de fluxo de trabalho. Essas ações permitem lançar e gerenciar modelos de job da plataforma Ansible Automation (Automation Controller).

Pré-requisitos

Antes de utilizar as ações do Ansible na automação do fluxo de trabalho, certificar-se de ter:

Uma instância da plataforma Ansible Automation (Automation Controller) acessível por HTTPS.
Um token OAuth2 com escopo de gravação para lançar jobs (crie um em Automation Controller > Users > Tokens).
O ID numérico do modelo de job que se deseja lançar.
A configuração ask_*_on_launch habilitada no modelo de job para cada entrada opcional que se planeja usar (extraVars, limit, inventory).

Ações de Job

Faz o lançamento de um modelo de job da plataforma de automação Ansible (Automation Controller) e retorna o job criado. Esta ação baseia-se na ação base http.post.

O endpoint é POST https://{host}/api/controller/v2/job_templates/{jobTemplateId}/launch/

Campo de entrada	Opcionalidade	Tipo	Exemplo
hospedar	Obrigatório	Corda	`${{ :secrets:host }}` Nome do host (e porta opcional) do Automation Controller, sem esquema, por exemplo, aap.example.com.
authToken	Obrigatório	Corda	`${{ :secrets:ansibleControllerToken }}` Token OAuth2, enviado como `Authorization: Bearer <token>`. Criar em Automation Controller → Usuários → Tokens com escopo de gravação para lançamento.
jobTemplateId	Obrigatório	Interno	`42`
extraVars	Opcional	Mapa	`{"target_env": "staging", "app_version": "1.2.3"}` Mapeado para `extra_vars`. Entra em vigor apenas se o modelo tiver `ask_variables_on_launch` (ou uma pesquisa) habilitado.
limit	Opcional	Corda	`web-servers` Padrão de host do Ansible. Mapeado para `limit`. Requer `ask_limit_on_launch`.
inventário	Opcional	Corda	`7` ID numérico de inventário (sobrescreve o padrão do modelo). Mapeado para `inventory`. Requer `ask_inventory_on_launch`.
jobTags	Opcional	Corda	`deploy,restart` Tags separadas por vírgula. Mapeado para `job_tags`. Requer `ask_tags_on_launch`.
skipTags	Opcional	Corda	`notifications` Tags separadas por vírgula a serem ignoradas. Mapeado para `skip_tags`. Requer `ask_skip_tags_on_launch`.
selectors	Opcional	Lista	`[{"name": "jobId", "expression": ".id"}, {"name": "status", "expression": ".status"}]`

Campo de saída	Tipo	Exemplo
success	Boleano	`success: true \| false`
response	Objeto	`{ "id": 128, "status": "pending", "job_template": 42, "url": "/api/controller/v2/jobs/128/" }`
errorMessage	Corda	`{ "detail": "Variables not allowed on launch." }`

Exemplo de fluxo de trabalho
`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`

Exemplo de fluxo de trabalho

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

Esta tradução de máquina é fornecida para sua comodidade.

Pré-requisitos

Ações de Job

Lançamento de um modelo de job do Ansible

Esta tradução de máquina é fornecida para sua comodidade.

Ações de job do Ansible

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

Ações de Job

Pré-requisitos