23장. 워크플로우 작업 템플릿
워크플로 작업 템플릿은 릴리스 프로세스의 일부인 전체 작업 세트를 단일 단위로 추적하는 분산된 일련의 리소스를 함께 연결합니다. 이러한 리소스에는 다음이 포함됩니다.
- 작업 템플릿
- 워크플로우 작업 템플릿
- 프로젝트 동기화
- 인벤토리 소스 동기화
템플릿 목록 보기에는 현재 사용 가능한 워크플로우 및 작업 템플릿이 표시됩니다. 기본 뷰는 접혀 있으며(콤팩트) 템플릿 이름, 템플릿 유형 및 해당 템플릿을 사용하여 실행된 작업의 상태를 표시합니다. 각 항목 옆에 있는 화살표를 클릭하여 자세한 정보를 확장하고 볼 수 있습니다. 이 목록은 이름에 따라 알파벳순으로 정렬되지만 다른 기준에 따라 정렬하거나 템플릿의 다양한 필드 및 속성으로 검색할 수 있습니다. 이 화면에서
를 시작하고,
를 편집하고,
워크플로우 작업 템플릿을 복사할 수 있습니다.
워크플로우 편집기에 액세스할 수 있는 바로 가기로 워크플로우 시각화 프로그램
아이콘이 워크플로우 템플릿에만 있습니다.

워크플로 템플릿은 다른 워크플로우 템플릿의 빌드 블록으로 사용할 수 있습니다. 워크플로우 작업 템플릿 수준에서 편집할 수 있는 워크플로우 템플릿에서 여러 설정을 설정하여 시작 시 프롬프트 를 활성화할 수 있습니다. 이는 개별 워크플로우 템플릿 수준에서 할당된 값에는 영향을 미치지 않습니다. 자세한 지침은 워크플로우 시각화 도구 섹션을 참조하십시오.
23.1. 워크플로우 템플릿 생성
새 워크플로우 작업 템플릿을 생성하려면 다음 단계를 완료합니다.
워크플로우 템플릿에 제한을 설정하면 제한을 시작할 때 프롬프트 를 선택하지 않는 한 작업 템플릿에 전달되지 않습니다. 이 경우 실행 중인 플레이북에 제한이 필요한 경우 플레이북 오류가 발생할 수 있습니다.
프로세스
템플릿 목록 보기의 추가 목록에서 워크플로우 템플릿 추가 를 선택합니다.
다음 필드에 적절한 세부 정보를 입력합니다.
참고필드에 시작 확인란이 선택되어 있거나 워크플로우 템플릿을 시작하거나 다른 워크플로우 템플릿 내에서 워크플로우 템플릿을 사용하는 경우 해당 필드에 대한 값을 입력하라는 메시지가 표시됩니다. 대부분의 프롬프트 값은 작업 템플릿에 설정된 모든 값을 재정의합니다. 다음 표에는 예외가 설명되어 있습니다.
필드 옵션 시작 시 프롬프트 이름
작업의 이름을 입력합니다.
해당 없음
설명
임의의 설명을 적절하게 입력합니다(선택 사항).
해당 없음
조직
로그인한 사용자에게 제공되는 조직에서 이 템플릿에 사용할 조직을 선택합니다.
해당 없음
인벤토리
선택적으로 로그인한 사용자에게 제공되는 인벤토리에서 이 템플릿에 사용할 인벤토리를 선택합니다.
제공됨
제한
플레이북에서 관리하거나 영향을 주는 호스트 목록을 추가로 제한하는 호스트 패턴입니다. 콜론(:)으로 많은 패턴을 분리할 수 있습니다. 핵심 Ansible과 마찬가지로:
- A:b는 "그룹 a 또는 b"를 의미합니다.
- A:b:&c는 "a 또는 b에 있지만 c에 있어야 함"를 의미합니다.
- A:!b는 "a에 있고 b에는 분명히 없음"을 의미합니다.
자세한 내용은 Patterns: targeting hosts and groups in the Ansible documentation에서 참조하십시오.
제공됨
선택하는 경우 기본값을 제공해도 시작 시 제한을 선택하라는 메시지가 표시됩니다.
소스 제어 분기
워크플로우의 분기를 선택합니다. 이 분기는 분기를 요청하는 모든 워크플로우 작업 템플릿 노드에 적용됩니다.
제공됨
라벨
-
선택적으로
dev
또는test
와 같은 이 워크플로 작업 템플릿을 설명하는 레이블을 제공합니다. 라벨을 사용하여 디스플레이에서 워크플로우 작업 템플릿 및 완료된 작업을 그룹화하고 필터링합니다. - 레이블은 워크플로우 템플릿에 추가할 때 생성됩니다. 레이블은 워크플로우 템플릿에 제공되는 프로젝트를 사용하여 단일 조직에 연결됩니다. 조직 멤버는 편집 권한이 있는 경우(예: 관리자 역할) 워크플로우 템플릿에 레이블을 생성할 수 있습니다.
- 작업 템플릿을 저장하면 워크플로우 작업 템플릿 세부 정보 보기에 레이블이 표시됩니다.
- 레이블은 워크플로우에 사용되는 작업 템플릿 노드가 아닌 워크플로우 템플릿에만 적용됩니다.
-
제거하려면 레이블 옆에 있는
를 선택합니다. 레이블이 제거되면 해당 특정 작업 또는 작업 템플릿과 더 이상 연결되지 않지만 이를 참조하는 다른 작업과 연결된 상태로 유지됩니다.
제공됨
선택하는 경우 기본값을 제공해도 필요한 경우 추가 레이블을 제공하라는 메시지가 표시됩니다. - 기존 레이블을 삭제할 수 없습니다.
를 선택하면 기존 기본 레이블만 제거되지 않습니다.
변수
- 플레이북에 추가 명령행 변수를 전달합니다.
Ansible이 작동하는 방식 제어: 우선순위 규칙 . - YAML 또는 JSON을 사용하여 키 또는 값 쌍을 제공하는 방법에 대한 Ansible 문서에 설명된 ansible-playbook의 "-e" 또는 "-extra-vars" 명령줄 매개변수입니다. 이러한 변수에는 우선순위 최대값이 있으며 다른 위치에 지정된 다른 변수를 덮어씁니다. 다음은
git_branch: production release_version: 1.5
의 예입니다.제공됨
일정에 extra_vars를 지정하려면 워크플로우 작업 템플릿에서 변수 시작 시 프롬프트 를 선택하거나 작업 템플릿에서 설문 조사를 활성화해야 합니다. 답변된 설문 조사 질문이
extra_vars
가 됩니다. 추가 변수에 대한 자세한 내용은 추가 변수를 참조하십시오. ???작업 태그
를 입력하고 생성 드롭다운을 선택하여 실행해야 하는 플레이북의 부분을 지정합니다. 자세한 내용 및 예제는 Ansible 문서의 태그 를 참조하십시오.
제공됨
태그 건너뛰기
생성 드롭다운을 입력하고 선택하여 건너뛸 플레이북의 특정 작업 또는 일부를 지정합니다. 자세한 내용 및 예제는 Ansible 문서의 태그 를 참조하십시오.
제공됨
필요한 경우 이 템플릿을 시작하기 위해 다음 옵션을 지정합니다.
Webhook 활성화를 선택하여 워크플로우 작업 템플릿을 시작하는 데 사용되는 사전 정의된 SCM 시스템 웹 서비스와 연결하는 기능을 켭니다. GitHub 및 GitLab은 지원되는 SCM 시스템입니다.
Webhook를 활성화하면 다른 필드가 표시되면서 추가 정보를 요청합니다.
- Webhook 서비스: Webhook에서 수신 대기할 서비스를 선택합니다.
- Webhook 인증 정보: 필요한 경우 Webhook 서비스로 상태 업데이트를 다시 보내는 데 사용할 인증 정보로 GitHub 또는 GitLab PAT(개인 액세스 토큰)을 제공합니다. 자세한 내용은 인증 정보 유형을 참조하여 하나를 생성합니다.
- Webhook URL: 요청을 POST하는 Webhook 서비스의 URL이 자동으로 채워집니다.
Webhook 키: Webhook 서비스에서 자동화 컨트롤러로 전송된 페이로드에 서명하는 데 사용할 공유 시크릿을 생성합니다. 이 서비스의 Webhook가 자동화 컨트롤러에서 수락되도록 Webhook 서비스의 설정에서 이 구성을 구성해야 합니다. Webhook 설정에 대한 자세한 내용은 Webhook 작업을 참조하십시오.
동시 작업 활성화를 선택하여 이 워크플로우를 동시에 실행할 수 있는지 확인합니다. 자세한 내용은 자동화 컨트롤러 용량 결정 및 작업 영향을 참조하십시오.
- 워크플로우 템플릿 구성을 완료한 경우 클릭합니다.
템플릿을 저장하면 워크플로우 템플릿 페이지가 종료되고 워크플로우 시각화 프로그램이 열려 워크플로우를 빌드할 수 있습니다. 자세한 내용은 워크플로우 시각화 프로그램 섹션을 참조하십시오. 그렇지 않으면 다음 방법 중 하나를 선택합니다.
워크플로우 시각화 프로그램을 종료하여 새로 저장된 템플릿의 세부 정보 탭으로 돌아갑니다. 여기에서 다음 작업을 완료할 수 있습니다.
- 검토, 편집, 권한, 알림, 일정 및 설문 조사
- 완료된 작업 보기
- 워크플로우 템플릿 빌드
- 참고
시작하기 전에 템플릿을 저장하거나 시작은 비활성화 알림 탭은 템플릿을 저장한 후에만 표시됩니다.
상태로 유지됩니다.
