Ansible 작업 템플릿 출시

이 페이지는 워크플로우 자동화 액션 카탈로그에서 사용할 수 있는 ansible.job.launch 액션에 대한 참조를 제공합니다. 워크플로우 단계에서 Ansible Automation 플랫폼(Automation Controller) 작업 템플릿을 출시하려면 이 액션을 사용하십시오.

사전 요구 사항은 Ansible 작업 액션을 참조하십시오.

작업 식별자는 ansible.job.launch입니다.

Ansible Automation 플랫폼(Automation Controller) 작업 템플릿을 출시하고 생성된 작업을 반환합니다. 성공 시, 작업이 종료 상태에 도달할 때까지 작업을 폴링하기 위해 ansible.job.getStatus와(과) 함께 사용할 수 있는 작업 id을(를) 반환합니다. 엔드포인트는 POST https://{host}/api/controller/v2/job_templates/{jobTemplateId}/launch/입니다.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력	유형	설명	예시
주인	문자열	필수 항목입니다. 스킴을 제외한 Automation Controller의 호스트명(및 선택적 포트)입니다.	`${{ :secrets:host }}`
authToken	문자열	필수 항목입니다. OAuth2 토큰이 `Authorization: Bearer <token>` (으)로 전송됩니다. 쓰기 범위로 Automation Controller > Users > Tokens 에서 생성하십시오.	`${{ :secrets:ansibleControllerToken }}`
jobTemplateId	Int	필수 항목입니다. 출시할 작업 템플릿의 숫자 ID입니다.	`42`
extraVars	지도	선택 사항. `extra_vars` (으)로 전달된 추가 변수입니다. 템플릿에서 `ask_variables_on_launch` 을(를) 활성화해야 합니다.	`{"target_env": "staging", "app_version": "1.2.3"}`
limit	문자열	선택 사항. `limit` (으)로 전달되는 Ansible 호스트 패턴입니다. `ask_limit_on_launch` 이(가) 필요합니다.	`web-servers`
inventory	문자열	선택 사항. 템플릿 기본값을 재정의하는 숫자 인벤토리 ID입니다. `ask_inventory_on_launch` 이(가) 필요합니다.	`7`
jobTags	문자열	선택 사항. `job_tags` (으)로 전달되는 쉼표로 구분된 태그입니다. `ask_tags_on_launch` 이(가) 필요합니다.	`deploy,restart`
skipTags	문자열	선택 사항. 건너뛸 쉼표로 구분된 태그이며, `skip_tags` (으)로 전달됩니다. `ask_skip_tags_on_launch` 이(가) 필요합니다.	`notifications`
selectors	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "jobId", "expression": ".id"}, {"name": "status", "expression": ".status"}]`

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출	유형	설명
success	부울	`true` 성공 시, 실패 시 `false` 입니다.
response	물체	생성된 작업 객체입니다. 상태를 폴링하려면 `ansible.job.getStatus`와(과) 함께 `id` 필드를 사용하십시오. `{ "id": 128, "status": "pending", "job_template": 42, "url": "/api/controller/v2/jobs/128/" }`
errorMessage	문자열	실패 시 오류 메시지. 성공 시 `null` 입니다.

산출

유형

설명

success

부울

true

성공 시, 실패 시

false

입니다.

response

물체

생성된 작업 객체입니다. 상태를 폴링하려면 ansible.job.getStatus와(과) 함께 id 필드를 사용하십시오.

{
  "id": 128,
  "status": "pending",
  "job_template": 42,
  "url": "/api/controller/v2/jobs/128/"
}

errorMessage

문자열

실패 시 오류 메시지. 성공 시

null

입니다.

다음 예제는 Ansible 작업 템플릿을 출시하고 폴링을 위해 작업 ID를 캡처합니다.

워크플로 예
`name: launch-ansible-remediation description: Launch 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" selectors: - name: jobId expression: ".id" next: end`

워크플로 예

name: launch-ansible-remediation
description: Launch 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"
      selectors:
        - name: jobId
          expression: ".id"
    next: end

사용자의 편의를 위해 제공되는 기계 번역입니다.

Ansible 작업 템플릿 출시

Ansible 작업 템플릿 출시.css-21sua1{background:none;border:none;width:0;padding:0;}

Ansible 작업 템플릿 출시