:term:`workflow job template`은 릴리스 프로세스에 속한 전체 작업 세트를 단일 단위로 추적하는 작업을 수행하는 일련의 다양한 리소스를 하나로 연결합니다. 이러한 리소스에는 다음이 포함될 수 있습니다.
작업 템플릿
워크플로우 템플릿
프로젝트 동기화
인벤토리 소스 동기화
템플릿 메뉴는 현재 사용 가능한 워크플로우 및 작업 템플릿 목록을 엽니다. 기본 뷰는 접혀 있으며(콤팩트) 템플릿 이름, 템플릿 유형, 해당 템플릿을 사용하여 실행된 작업의 상태를 표시하지만 **펼치기**를 클릭하면 자세한 정보가 표시됩니다. 이 목록은 이름에 따라 알파벳순으로 정렬되지만 다른 기준에 따라 정렬하거나 템플릿의 다양한 필드 및 속성으로 검색할 수 있습니다. 이 화면에서는 작업 템플릿을 시작(), 편집(), 복사()할 수 있습니다.
워크플로우 편집기에 바로 액세스할 수 있는 워크플로우 시각화 도구 아이콘()은 워크플로우 템플릿에만 있습니다.
참고
워크플로우 템플릿은 다른 워크플로우 템플릿의 구성 요소로 사용할 수 있습니다. 워크플로우 템플릿의 다양한 매개변수를 사용하면 워크플로우 작업 템플릿 수준에서 수정할 수 있는 **시작 시 프롬프트**를 활성화할 수 있으며, 개별 워크플로우 템플릿 수준에서 할당된 값에는 영향을 미치지 않습니다. 관련 지침은 워크플로우 시각화 도구 섹션을 참조하십시오.
인벤토리: 필요한 경우 현재 로그인한 사용자에게 제공되는 인벤토리에서 이 워크플로우 템플릿에 사용할 인벤토리를 입력하거나 검색합니다.
시작 시 프롬프트: 선택하는 경우 이 워크플로우 템플릿이 시작되거나 다른 워크플로우 템플릿 내에서 사용될 때 인벤토리를 제공할 수 있습니다.
제한: 필요한 경우 워크플로우에서 실행할 서버의 서브 세트에 제한을 지정합니다. 이 값은 플레이북에서 관리하거나 영향을 주는 호스트 목록을 추가로 제한하는 호스트 패턴입니다. 패턴이 여러 개인 경우 콜론(“:”)으로 구분할 수 있습니다. 핵심 Ansible과 마찬가지로 “a:b”는 “그룹 a 또는 b에 있음”, “a:b:&c”는 “a 또는 b에 있으면서 c에 있어야 함”, “a:!b”는 “a에 있고 b에는 분명히 없음”을 나타냅니다.
시작 시 프롬프트: 선택하는 경우 기본값을 제공해도 시작 시 제한을 선택하라는 메시지가 표시됩니다.
SCM 분기: 필요한 경우 분기를 요청하는 모든 작업 템플릿 노드를 덮어쓰는 분기를 지정합니다.
시작 시 프롬프트: 선택하는 경우 기본값을 제공해도 시작 시 SCM 분기를 선택하라는 메시지가 표시됩니다.
레이블: “dev” 또는 “test”와 같이 이 워크플로우 템플릿을 설명하는 선택적 레이블을 제공합니다. 레이블은 해당 디스플레이에서 워크플로우 템플릿 및 완료된 작업을 그룹화하고 필터링하는 데 사용할 수 있습니다.
레이블은 워크플로우 템플릿에 추가할 때 생성됩니다. 레이블은 워크플로우 템플릿에 제공되는 프로젝트를 사용하여 단일 조직에 연결됩니다. 조직 멤버는 편집 권한이 있는 경우(예: 관리자 역할) 워크플로우 템플릿에 레이블을 생성할 수 있습니다.
워크플로우 템플릿이 저장되면 템플릿 개요에 레이블이 표시됩니다.
Click the “x” beside a label to remove it. When a label is removed, it is no longer associated with that particular Job or Job Template, but it will remain associated with any other jobs that reference it.
작업은 시작 시 워크플로우 템플릿에서 레이블을 가져옵니다. 워크플로우 템플릿에서 삭제된 레이블은 작업에서도 삭제됩니다.
옵션:
**동시 작업 활성화**를 선택하면 이 워크플로우를 동시에 실행할 수 있습니다. 자세한 내용은 :ref:`ug_job_concurrency`을 참조하십시오.
**Webhook 활성화**를 선택하면 작업 템플릿을 시작하는 데 사용되는 사전 정의된 SCM 시스템 웹 서비스와 연결하는 기능이 켜집니다. 현재 지원되는 SCM 시스템은 GitHub와 GitLab입니다.
Webhook를 활성화하면 다른 필드가 표시되면서 추가 정보를 요청합니다.
Webhook 서비스: Webhook에서 수신 대기할 서비스를 선택합니다.
Webhook 인증 정보: 필요한 경우 Webhook 서비스로 상태 업데이트를 다시 보내는 데 사용할 인증 정보로 GitHub 또는 GitLab PAT(개인 액세스 토큰)을 제공합니다. 인증 정보를 선택하려면 인증 정보가 있어야 합니다. 인증 정보를 생성하려면 :ref:`ug_credentials_cred_types`을 참조하십시오.
저장 시 추가 필드가 채워지고 워크플로우 시각화 도구가 자동으로 열립니다.
Webhook URL: 요청을 POST하는 Webhook 서비스의 URL이 자동으로 채워집니다.
Webhook 키: |at|로 보낸 페이로드에 서명하는 데 Webhook 서비스에서 사용하도록 생성된 공유 비밀입니다. |at|에서 이 서비스의 Webhook를 수락하려면 Webhook 서비스의 설정에 구성해야 합니다.
Webhook 설정에 대한 자세한 내용은 :ref:`ug_webhooks`을 참조하십시오.
템플릿을 저장하면 워크플로우 템플릿 페이지가 종료되고 워크플로우 시각화 도구가 열려 워크플로우를 빌드할 수 있습니다. 자세한 지침은 워크플로우 시각화 도구 섹션을 참조하십시오. 또는 워크플로우 시각화 도구를 닫고 새로 저장된 템플릿의 세부 정보 탭으로 돌아와서 권한, 알림, 일정, 설문 조사를 검토, 편집, 추가하거나 나중에 완료된 작업을 보고 워크플로우 템플릿을 빌드할 수 있습니다. 시작**을 클릭하여 워크플로우를 시작할 수도 있지만 시작하기 전에 템플릿을 먼저 저장해야 합니다. 그러지 않으면 **시작 버튼이 회색으로 유지되어 사용 불가능합니다. 또한 알림 탭은 템플릿을 저장한 후에만 표시됩니다.
스케줄이 이미 설정되어 있는 경우 스케줄 기본 설정을 검토, 편집 또는 활성화/비활성화합니다.
스케줄이 설정되지 않은 경우 :ref:`ug_scheduling`에서 자세한 내용을 참조하십시오.
중첩된 워크플로우에 사용된 워크플로우 템플릿에 설문 조사가 있거나 인벤토리 옵션에 시작 시 프롬프트**가 선택되어 있는 경우 일정 양식의 **저장 및 취소 버튼 옆에 프롬프트 버튼이 표시됩니다. 프롬프트 버튼을 클릭하면 인벤토리를 제공 또는 제거하거나 변경 사항 없이 단계를 건너뛸 수 있는 선택적 인벤토리 단계가 표시됩니다.
실행 또는 확인 작업 유형이 포함된 워크플로우의 경우 워크플로우 작업 템플릿 생성 또는 편집 화면에서 설문 조사를 설정할 수 있습니다. 설문 조사에서는 ‘추가 변수 요청’와 비슷하지만 간편한 질문 및 답변 방식으로 플레이북의 추가 변수를 설정합니다. 또한 설문 조사에서는 사용자 입력을 검증할 수 있습니다. 설문 조사를 생성하려면 설문 조사 탭을 클릭합니다.
설문 조사의 사용 사례는 다양합니다. 예를 들어 고급 Ansible 지식 없이도 실행할 수 있는 “단계로 푸시” 버튼을 개발자에게 제공하려는 작업이 있을 수 있습니다. 이 작업이 시작되면 “릴리스할 태그는 무엇입니까?”와 같은 질문에 응답하도록 요청하는 메시지가 표시될 수 있습니다.
워크플로우 시각화 도구를 사용하면 그래프를 사용해 작업 템플릿, 워크플로우 템플릿, 프로젝트 동기화, 인벤토리 동기화를 하나로 연결하여 워크플로우 템플릿을 빌드할 수 있습니다. 워크플로우 템플릿을 빌드하기 전에 워크플로우 섹션에서 부모 노드, 자식 노드, 형제 노드의 다양한 시나리오와 관련된 고려 사항을 참조하십시오.
템플릿(작업 템플릿 또는 워크플로우 작업 템플릿), 프로젝트 동기화, 인벤토리 동기화 또는 승인 등의 노드 유형 중 두 개 이상의 조합을 설정하여 워크플로우를 빌드할 수 있습니다. 각 노드는 직사각형으로 표시되고 관계 및 연결된 에지 유형은 노드를 연결하는 선(또는 링크)으로 표시됩니다.
워크플로우 템플릿의 세부 정보/편집 뷰에서 시각화 도구 탭을 클릭하거나 템플릿 목록 뷰에서 아이콘을 클릭하여 워크플로우 시각화 도구를 시작합니다.
버튼을 클릭하여 워크플로우에 추가할 노드 목록을 표시합니다.
오른쪽 창의 드롭다운 메뉴에서 추가할 노드 유형을 선택합니다.
승인 노드를 선택하는 경우 자세한 내용은 :ref:`ug_wf_approval_nodes`를 참조하십시오.
노드를 선택하면 노드와 연결된 유효한 옵션이 제공됩니다.
참고
워크플로우 그래프를 채울 때 기본 인벤토리가 없는 작업 템플릿을 선택하면 부모 워크플로우의 인벤토리가 사용됩니다. 작업 템플릿에는 인증 정보가 필요하지 않지만 암호가 필요한 인증 정보가 있는 경우 워크플로우의 작업 템플릿을 선택할 수 없습니다. 단, 인증 정보가 요청된 인증 정보로 교체되는 경우는 제외됩니다.
노드가 선택되면 워크플로우가 빌드되기 시작하고 선택한 노드에 수행할 작업 유형을 지정해야 합니다. 이 작업은 *에지 유형*이라고도 합니다.
후속 노드의 경우 다음 시나리오(에지 유형) 중 하나를 선택하여 각각에 적용할 수 있습니다.
항상: 성공 여부와 관계없이 계속 실행됩니다.
성공 시: 성공적으로 완료되면 다음 템플릿을 실행합니다.
실패 시: 실패 시 다른 템플릿을 실행합니다.
통합 노드인 경우 통합 필드에서 노드 동작을 선택합니다.
임의**는 기본 동작으로, 다음 통합 노드를 트리거하기 전에 *임의*의 노드를 지정된 대로 완료할 수 있습니다. 한 부모의 상태가 해당 실행 조건 중 하나를 충족하기만 하면 **임의 자식 노드가 실행됩니다. 즉, 임의 노드를 완료하는 데 모든 노드가 필요하지만 하나의 노드만 예상대로 완료되면 됩니다.
다음 노드를 통합하고 트리거하기 전에 모든 노드가 지정된 대로 완료되도록 모두**를 선택합니다. **모두 노드의 목적은 모든 부모가 자식 노드를 실행하기 위해 예상대로 완료되었는지 확인하는 것입니다. 워크플로우는 모든 부모가 자식 노드를 실행하기 위해 예상대로 작동했는지 확인합니다. 예상대로 작동하지 않았다면 자식 노드를 실행하지 않습니다.
노드가 루트 노드이거나 통합되는 노드가 없는 노드인 경우 통합 규칙을 설정해도 적용되지 않습니다. 해당 동작이 이를 트리거하는 작업에 의해 결정되기 때문입니다.
워크플로우에 사용된 작업 템플릿의 매개변수에 시작 시 프롬프트**가 선택되어 있는 경우 노드 수준에서 해당 값을 변경할 수 있는 **프롬프트 버튼이 표시됩니다. 마법사를 사용하여 각 탭에서 값을 변경하고 프리뷰 탭에서 **확인**을 클릭합니다.
마찬가지로, 워크플로우에 사용된 워크플로우 템플릿의 인벤토리 옵션에 **시작 시 프롬프트**가 선택되어 있는 경우 마법사를 사용하여 프롬프트에서 인벤토리를 제공합니다. 부모 워크플로우에 자체 인벤토리가 있는 경우 여기에 제공된 인벤토리를 덮어씁니다.
참고
요청 가능한 필수 필드가 있지만 이 필드의 기본값이 없는 작업 템플릿의 경우 노드를 생성할 때 선택 버튼이 활성화되기 전에 해당 값을 제공해야 합니다. 프롬프트 버튼을 사용하여 값을 제공할 때까지 선택 버튼을 비활성화하는 두 가지 경우는 1) 작업 템플릿에서 시작 시 프롬프트 체크박스를 선택하지만 기본값을 제공하지 않는 경우 또는 2) 필수 설문 조사 질문을 생성하지만 기본 응답을 제공하지 않는 경우입니다. 그러나 인증 정보가 있는 경우는 해당하지 않습니다. 시작 시 암호가 필요한 인증 정보는 워크플로우 노드를 생성할 때 허용되지 않습니다. 노드를 생성할 때는 노드 시작에 필요한 모든 정보를 제공해야 하기 때문입니다. 따라서 작업 템플릿에서 인증 정보를 입력하라는 메시지가 표시되면 |at|에서 암호가 필요한 인증 정보를 선택할 수 없도록 합니다.
또한 해당 노드에서 변경 사항을 적용하려면 프롬프트 마법사가 닫힐 때 **선택**을 클릭해야 합니다. 그러지 않으면 모든 변경 사항이 실제 작업 템플릿에 설정된 값으로 되돌아갑니다.
노드가 생성되면 노드의 레이블이 해당 작업 유형으로 지정됩니다. 각 워크플로우 노드와 연결된 템플릿은 진행하면서 선택한 실행 시나리오를 기반으로 실행됩니다. 나침반() 아이콘을 클릭하면 각 실행 시나리오와 해당 작업 유형에 대한 범례가 표시됩니다.
노드 위에 마우스를 올리면 다른 노드를 추가하거나(), 노드에 대한 정보를 보거나(), 노드 세부 정보를 편집하거나(), 기존 링크를 편집하거나(), 선택한 노드를 삭제할 수 있습니다().
노드 추가/편집을 완료하면 **선택**을 클릭하여 모든 수정 사항을 저장하고 그래프 뷰에서 노드를 렌더링합니다. 워크플로우를 빌드하는 방법은 :ref:`ug_wf_building_scenarios`를 참조하십시오.
워크플로우 템플릿 빌드를 완료하면 **저장**을 클릭하여 전체 워크플로우 템플릿을 저장하고 새 워크플로우 템플릿 세부 정보 페이지로 돌아갑니다.
중요
이 창에서 **닫기**를 클릭하면 작업이 저장되지 않고 전체 워크플로우 시각화 도구가 닫히게 되어 처음부터 다시 시작해야 합니다.
승인 노드를 선택할 경우 워크플로우를 진행하기 위해 사용자 개입이 필요합니다. 이 노드를 사용하면 플레이북 간 워크플로우를 일시 중지하여 워크플로우의 다음 플레이북을 계속하도록 승인해 지정된 시간 동안 개입할 수 있을 뿐 아니라 다른 트리거를 기다리지 않고도 최대한 빨리 계속할 수 있습니다.
시간 초과 기본값은 없지만, 요청이 만료되고 자동으로 거부될 때까지의 시간을 지정할 수 있습니다. 승인 노드에 대한 정보를 선택하고 제공하면 해당 노드가 그래프 뷰에서 일시 중지() 아이콘 옆에 표시됩니다.
승인자는 승인 노드가 포함된 워크플로우 작업 템플릿을 실행할 수 있으면서도 해당 워크플로우 작업 템플릿과 연결된 조직에서 조직 관리자 이상의 권한이 있는 구성원이거나, 이 특정 워크플로우 작업 템플릿 내에서 승인 권한이 명시적으로 할당된 사용자입니다.
만료가 할당된 상태에서 보류 중인 승인 노드가 지정된 제한 시간 내에 승인되지 않거나 거부되는 경우 각각 “시간 초과” 또는 “실패”로 표시되고 다음 “실패 시 노드” 또는 “항상 노드”로 이동합니다. 승인되면 “성공 시” 경로가 사용됩니다. API에서 이미 승인/거부되거나 시간 초과된 노드에 POST를 시도하면 이 작업이 중복되었음을 알리는 오류 메시지가 표시되고 추가 단계가 수행되지 않습니다.
|add node|가 표시될 때까지 두 노드를 연결하는 선 위에 마우스를 올리면 노드 사이에 다른 노드를 삽입할 수 있습니다. |add node|를 클릭하면 두 노드 사이에 노드가 자동으로 삽입됩니다.
분할 시나리오를 표시하기 위해 루트 노드를 추가하려면 버튼을 다시 클릭합니다.
분할 시나리오를 생성하려는 임의의 노드에서 분할 시나리오가 시작되는 노드 위에 마우스를 올린 후 |add node|를 클릭합니다. 이 작업은 기본적으로 동일한 부모 노드에 있는 여러 노드를 추가하여 형제 노드를 생성합니다.
참고
새 노드를 추가하면 프롬프트 버튼이 워크플로우 템플릿에도 적용됩니다. 워크플로우 템플릿에서 인벤토리와 설문 조사를 요청하는 메시지가 표시됩니다.
마지막으로 삽입한 노드를 실행 취소하려면 오른쪽 창에서 선택하지 않고 다른 노드를 클릭합니다. 또는 오른쪽 창에서 **취소**를 클릭합니다.
다음은 실행에 실패하는 경우 프로젝트 동기화 작업을 진행하고 성공 여부와 관계없이 인벤토리 동기화 작업을 진행하는 작업 템플릿에서 시작된 세 가지 작업을 모두 포함하는 워크플로우의 예제입니다.
창 상단에 있는 키를 참조하여 그래프 표시와 연결된 기호 및 색상의 의미를 확인합니다.
참고
다양한 에지 유형의 형제 노드 세트가 포함된 워크플로우에서 후속 노드가 연결된 노드를 제거하면 연결된 노드가 자동으로 형제 노드 세트를 결합하고 해당 에지 유형을 유지합니다.
노드를 수정할 수 있는 방법은 다음과 같습니다.
노드를 편집하려면 편집할 노드를 클릭합니다. 오른쪽 창에 현재 선택 사항이 표시됩니다. 변경 후 **선택**을 클릭하여 그래프 뷰에 변경 사항을 적용합니다.
기존 링크의 에지 유형(성공/실패/항상)을 편집하려면 해당 링크를 클릭합니다. 오른쪽 창에 현재 선택 사항이 표시됩니다. 변경 후 **저장**을 클릭하여 그래프 뷰에 변경 사항을 적용합니다.
한 노드의 새 링크를 다른 노드에 추가하려면 각 노드에 표시되는 링크 아이콘()을 클릭합니다. 이렇게 하면 연결할 수 있는 노드가 강조 표시됩니다. 이런 가능한 옵션은 점선으로 표시됩니다. 유효하지 않은 옵션은 회색 박스(노드)로 표시되며, 회색 박스는 이 외의 경우에서 유효하지 않은 링크를 생성합니다. 아래 예제에서는 **e2e-ec20de52-project**가 화살표로 표시된 대로 연결할 수 있는 옵션으로 **데모 프로젝트**를 보여 줍니다.
링크를 제거하려면 링크를 클릭하고 연결 해제 버튼을 클릭합니다.
이 버튼은 대상 또는 자식 노드에 부모가 두 개 이상 있는 경우에만 오른쪽 패널에 표시됩니다. 모든 노드는 항상 하나 이상의 다른 노드에 연결되어 있어야 하므로 이전 링크를 제거하기 전에 새 링크를 생성해야 합니다.
뷰를 확대/축소, 이동 또는 재배치하려면 설정 아이콘()을 클릭합니다. 또는 워크플로우 다이어그램을 드래그하여 화면에 재배치하거나 마우스 스크롤을 사용하여 확대/축소할 수 있습니다.
automation controller allows you the ability to copy a workflow template. If you choose to copy a workflow template, it does not copy any associated schedule, notifications, or permissions. Schedules and notifications must be recreated by the user or admin creating the copy of the workflow template. To copy a workflow template, you must have “Workflow Admin” permissions assigned at the Org level. The user copying the workflow template will be granted the admin permission, but no permissions are assigned (copied) to the workflow template.
왼쪽 탐색 모음의 템플릿 메뉴 또는 워크플로우 작업 템플릿 세부 정보 뷰에서 복사할 워크플로우 템플릿에 액세스합니다. 아래로 스크롤하여 템플릿 목록에서 액세스하면 됩니다.
버튼을 클릭합니다.
복사한 템플릿의 이름과 타임스탬프가 포함된 새 템플릿이 열립니다.
복사한 템플릿을 선택하고 이름 필드의 내용을 새 이름으로 교체한 후 다른 필드의 항목을 제공하거나 수정하여 이 템플릿을 완료합니다.
If a resource has a related resource that you do not have the right level of permission to, you cannot copy the resource, such as in the case where a project uses a credential that a current user only has Read access. However, for a workflow template, if any of its nodes uses an unauthorized job template, inventory, or credential, the workflow template can still be copied. But in the copied workflow template, the corresponding fields in the workflow template node will be absent.
), 편집(
), 복사(
)할 수 있습니다.
)은 워크플로우 템플릿에만 있습니다.
버튼을 클릭한 다음 메뉴 목록에서 **워크플로우 템플릿**을 선택합니다.
버튼을 클릭하여 워크플로우에 추가할 노드 목록을 표시합니다.
) 아이콘을 클릭하면 각 실행 시나리오와 해당 작업 유형에 대한 범례가 표시됩니다.
), 노드에 대한 정보를 보거나(
), 노드 세부 정보를 편집하거나(
), 선택한 노드를 삭제할 수 있습니다(
).
) 아이콘 옆에 표시됩니다.
)을 클릭합니다. 또는 워크플로우 다이어그램을 드래그하여 화면에 재배치하거나 마우스 스크롤을 사용하여 확대/축소할 수 있습니다.
)에 표시됩니다.
