8장. 룰북 활성화
룰북은 이벤트 중심 자동화 모델에서 IT 작업을 수행하는 데 사용하는 일련의 조건부 규칙입니다. 룰북은 이벤트 기반 Ansible에 이벤트 확인을 위한 소스와 특정 조건이 충족될 때 해당 이벤트가 발생하는 경우를 알려주는 수단입니다.
룰북은 규칙이 트리거될 때 수행할 작업을 지정합니다. 이벤트가 규칙에 대한 조건과 일치하면 규칙이 트리거됩니다. 현재 지원되는 작업은 다음과 같습니다.
-
run_playbook( ansible-rulebook CLI에서만 지원) -
run_module -
run_job_template -
run_workflow_template -
set_fact -
post_event -
retract_fact -
print_event -
shutdown -
debug -
none
자세한 내용은 작업을 참조하십시오.
룰북 활성화는 특정 룰북을 실행하는 의사 결정 환경에 의해 정의된 백그라운드에서 실행되는 프로세스입니다. 룰북 활성화 설정에 따라 룰북 활성화를 설정할 수 있습니다. ???
Red Hat은 하나의 postgres 데이터베이스가 있는 지원되지 않는 소스 플러그인을 사용하지 않는 것이 좋습니다. 이는 Ansible Automation Platform 사용에 잠재적인 위험을 초래할 수 있습니다.
고가용성 요구 사항을 충족하기 위해 이벤트 기반 Ansible 컨트롤러는 Ansible Automation Platform UI를 사용하여 중앙 집중식 Redis(REmote controlPlanectionary Server) 를 공유합니다. Redis를 사용할 수 없는 경우 다음 기능을 사용할 수 없습니다.
-
활성화를 만드는 경우, if
is_enabledis True - 활성화 삭제
- 활성화되지 않은 경우 활성화 활성화
- 아직 비활성화되지 않은 경우 활성화 비활성화
- 활성화 다시 시작
8.1. 룰북 활성화 설정
사전 요구 사항
- Ansible Automation Platform 대시보드에 콘텐츠 소비자로 로그인되어 있습니다.
- 프로젝트를 설정했습니다.
- 의사 결정 환경을 설정했습니다.
프로세스
- Ansible Automation Platform에 로그인합니다.
-
로 이동합니다. - 클릭합니다.
다음을 삽입합니다.
- 이름
- 이름을 삽입합니다.
- 설명
- 이 필드는 선택 사항입니다.
- 조직
- 조직 이름을 입력하거나 목록에서 Default를 선택합니다.
- 프로젝트
- 프로젝트는 룰북의 논리 컬렉션입니다. 이 필드는 선택 사항입니다.
- 룰북
- 룰북은 선택한 프로젝트에 따라 표시됩니다.
- 인증 정보
이 룰북 활성화에 대해 0개 이상의 인증 정보를 선택합니다. 이 필드는 선택 사항입니다.
참고- 이 필드에 표시되는 인증 정보는 룰북 활성화에 따라 사용자 지정되며 Vault, Red Hat Ansible Automation Platform 또는 생성한 모든 사용자 정의 인증 정보 유형만 포함합니다. 인증 정보에 대한 자세한 내용은 인증 정보를 참조하십시오. ???
- Red Hat Ansible Automation Platform 인증 정보를 사용하려는 경우 룰북 활성화에 대해 하나의 Red Hat Ansible Automation Platform 인증 정보 유형 만 선택할 수 있습니다.
- 의사 결정 환경
의사 결정 환경은 Ansible 룰북을 실행하는 컨테이너 이미지입니다.
참고이벤트 기반 Ansible 컨트롤러에서는 의사 결정 환경의 가져오기 정책을 사용자 지정할 수 없습니다. 기본적으로 always 정책의 동작을 따릅니다. 활성화가 시작될 때마다 시스템은 최신 버전의 이미지를 가져오려고 합니다.
- 재시작 정책
소스 플러그인을 실행하는 컨테이너 프로세스가 종료된 후 활성화를 다시 시작하는 방법을 결정하는 정책입니다.
정책:
- 항상: 성공적으로 종료되었는지 여부에 관계없이 룰북 활성화를 즉시 재시작하고 5회 이상 발생하지 않습니다.
- Never: 컨테이너 프로세스가 종료될 때 룰북 활성화를 재시작하지 않습니다.
- 실패 시: 컨테이너 프로세스가 실패한 경우에만 기본적으로 60초 후에 룰북 활성화를 재시작하고 5 번 이상 발생하지 않습니다.
- 로그 수준
이 필드는 기록된 이벤트의 심각도 및 콘텐츠 유형을 정의합니다.
수준:
- 오류: 활성화의 기록 탭에 표시되는 오류 메시지가 포함된 로그입니다.
- info: 성공 또는 실패, 트리거된 작업 이름 및 관련 작업 이벤트 및 오류와 같은 룰북 활성화에 대한 유용한 정보가 포함된 로그입니다.
- debug 단계에서만 유용하고 프로덕션 중에 값이 거의 없을 수 있는 정보가 포함된 로그입니다. 이 로그 수준에는 오류 및 로그 수준 데이터가 모두 포함됩니다.
- 서비스 이름
- 이는 활성화가 포트를 노출하는 경우 인바운드 연결을 구성하기 위해 Kubernetes의 서비스 이름을 정의합니다. 이 필드는 선택 사항입니다.
- 룰북 활성화가 활성화됩니까?
- 이렇게 하면 룰북 활성화가 자동으로 활성화됩니다.
- 변수
-
룰북의 변수는 JSON 또는 YAML 형식입니다. 콘텐츠는 ansible-rulebook 명령의
--vars플래그를 통해 전달되는 파일과 동일합니다. - 옵션
- 규칙 감사에서 이벤트를 표시하지 않으려면 Skip audit events 옵션을 선택합니다.
- 클릭합니다.
이제 룰북 활성화가 생성되고 규칙북 활성화 페이지에서 관리할 수 있습니다.
새 룰북 활성화를 저장하면 룰북 활성화의 세부 정보 페이지가 Pending, Running 또는 Failed 상태가 표시됩니다. 규칙북 활성화 목록 보기에서 다시 시작하거나 삭제할 수 있습니다.
경우에 따라 소스 플러그인이 종료되면 일정 시간 후에 룰북이 정상적으로 종료됩니다. 룰북 활성화가 종료되면 수행 대기 중인 작업이 취소되고 정보 수준 메시지가 활성화 로그로 전송됩니다. 자세한 내용은 규칙북 을 참조하십시오.
