Ansible 플레이북 모범 사례 체크리스트

# 실용적인 인프라 엔지니어의 Ansible 플레이북 취향 - 작업을 명확한 기본값을 가진 역할로 구성하고, 플레이북은 얇게 유지하며, 대부분 호스트 그룹에 적용되는 역할 목록으로 구성합니다. 신뢰도: 0.90 - 모든 작업에서 ansible.builtin.copy와 같은 완전히 정규화된 컬렉션 이름을 사용하여 모듈이 모호하지 않도록 합니다. 신뢰도: 0.85 - requirements.yml 파일에 컬렉션 및 역할 버전을 고정하고, CI에서 해당 파일로만 설치합니다. 신뢰도: 0.90 - 모든 작업을 멱등적으로 작성하여, 수렴된 호스트에서 두 번째 실행 시 변경 사항이 0건으로 보고되도록 합니다. 신뢰도: 0.95 - shell 또는 command보다 목적에 맞는 모듈을 선호하며, shell이 불가피한 경우 creates, removes 또는 changed_when을 명시적으로 설정합니다. 신뢰도: 0.90 - 모든 작업에 실행하는 명령이 아니라 보장하는 상태를 나타내는 명확하고 사람이 읽을 수 있는 이름을 지정합니다. 신뢰도: 0.80 - 변수를 group_vars 및 host_vars에 유지하고, 동일한 변수를 두 곳 이상에 설정하지 않도록 합니다. 신뢰도: 0.85 - 역할 변수에 역할 이름을 접두사로 사용하여(예: nginx_worker_processes) 역할 간 충돌을 방지합니다. 신뢰도: 0.85 - 비밀을 Ansible Vault 또는 외부 비밀 관리자 조회에 저장하고, 일반 텍스트로 커밋하지 않습니다. 신뢰도: 0.95 - 핸들러를 사용하여 서비스 재시작을 처리하고, 구성이 실제로 변경된 경우에만 서비스가 끝에 한 번 재시작되도록 합니다. 신뢰도: 0.90 - Jinja2로 구성 파일을 템플릿화하고, 서비스가 지원하는 경우 validate 옵션을 사용하여 교체 전에 검증합니다. 신뢰도: 0.85 - 모든 풀 리퀘스트에서 CI에서 ansible-lint 및 yamllint를 실행합니다. 신뢰도: 0.85 - 지원되는 각 운영 체제에 대해 일회용 컨테이너 또는 VM에서 Molecule로 역할을 테스트합니다. 신뢰도: 0.75 - 프로덕션에 변경 사항을 적용하기 전에 --check 및 --diff를 사용하고, diff를 코드 변경처럼 검토합니다. 신뢰도: 0.85 - serial 배치 및 max_fail_percentage로 프로덕션에 롤아웃하여 잘못된 변경이 모든 호스트에 도달하기 전에 중지되도록 합니다. 신뢰도: 0.85 - 수동으로 편집한 호스트 목록 대신 클라우드 공급자 또는 CMDB의 동적 인벤토리를 유지합니다. 신뢰도: 0.75 - 태그를 드물게 일관되게 사용하며, 주로 하나의 역할이나 하나의 관심사를 실행하는 데 사용하고, 숨겨진 실행 경로를 만들지 않습니다. 신뢰도: 0.70 - ignore_errors를 피하고, 실패가 예상될 때 정확한 조건과 함께 failed_when 또는 rescue가 있는 블록을 사용합니다. 신뢰도: 0.85 - 전체 플레이가 아닌 root가 필요한 작업에만 become을 설정합니다. 신뢰도: 0.75 - SSH 파이프라이닝을 활성화하고 forks를 조정하여 실행 시간을 줄이고, 추가 최적화 전에 profile_tasks 콜백으로 측정합니다. 신뢰도: 0.70 - 개인 노트북이 아닌 CI 또는 AWX와 같은 제어된 러너에서 플레이북을 실행하여 모든 변경 사항이 기록되도록 합니다. 신뢰도: 0.80