일부만 돌렸는데 왜 최종 상태가 아닌가

목표

태그로 플레이북의 일부만 돌리는 법을 익히고, 그 편의가 어떤 위험과 짝을 이루는지 직접 재 봅니다. 마지막에는 어떤 태그 선택이 완주할 수 있는지 판정하는 도구를 만듭니다.

왜 중요한가

플레이북은 자랍니다. 태스크가 여든 개인데 설정 한 줄만 고치고 싶은 날이 오고, 태그는 그 자리에 놓인 도구입니다. 문법이 쉬워서 사람들은 배운 다음 날부터 운영에서 씁니다. 사고는 거기서 납니다 — 태그는 실행을 자르는 칼인데, 플레이북은 잘려도 되게 설계되어 있지 않기 때문입니다. 앞 태스크가 만든 디렉터리를 뒤 태스크가 쓰고, 설정을 바꾼 태스크가 핸들러를 부릅니다. 일부만 고르면 그 연결이 끊어지고, 운이 나쁘면 실패조차 하지 않은 채 반쯤 맞는 상태가 남습니다. 그래서 이 실습은 태그 문법을 익히는 절반과, 자른 실행이 무엇을 보장하지 못하는지 눈으로 보는 절반으로 되어 있습니다.

단계

1. /root/anstags/hosts.ini 를 만드세요 — [web] 에 web1(ansible_host=127.0.0.1, ansible_port=2222), [all:vars] 로 ansible_user=root. /root/anstags/site.yml 을 만드세요: 플레이 변수 app_env(기본 lab), 핸들러 reload app(/root/anstags/out/reload.marker 에 reloaded 한 줄을 씁니다), 그리고 태스크 넷입니다 — /root/anstags/app 디렉터리를 0755 로 만드는 배포 자리를 만든다(태그 setup), /root/anstags/app/app.conf 에 env=<app_env> 한 줄을 0644 로 쓰고 핸들러를 notify 하는 설정을 쓴다(태그 config), release_id 를 r-2026 으로 정하는 배포 번호를 정한다(태그 prep, set_fact), /root/anstags/app/release.txt 에 release_id 를 0644 로 쓰는 배포 번호를 기록한다(태그 deploy). 전체를 한 번 수렴시켜 출력을 /root/anstags/out/full.txt 에 저장하고, 이어서 --tags config 로 한 번 더 돌려 /root/anstags/out/config.txt 에 저장하세요.
2. ansible-playbook -i hosts.ini site.yml --list-tags 의 출력을 /root/anstags/out/list-tags.txt 에 저장하세요. 그다음 --list-tasks --tags config 의 출력을 /root/anstags/out/list-config.txt 에 저장하세요. 두 번째 파일에는 설정을 쓴다 는 있고 배포 번호를 기록한다 는 없어야 합니다.
3. --skip-tags prep,deploy 로 플레이북을 실제로 돌려 출력을 /root/anstags/out/skip.txt 에 저장하세요. 출력에는 배포 자리를 만든다 와 설정을 쓴다 의 TASK [...] 줄이 있고, 배포 번호를 정한다 와 배포 번호를 기록한다 의 줄은 없어야 합니다. 그리고 --list-tasks --skip-tags prep,deploy 의 출력을 /root/anstags/out/list-skip.txt 에 저장하세요.
4. 플레이 자체에 태그 platform 을 거세요. 그리고 설정을 검증한다 라는 이름의 블록을 태스크 끝에 더하고 그 블록에 태그 verify 를 다세요 — 블록 안에는 태그를 달지 않은 태스크 둘이 들어갑니다: /root/anstags/app/app.conf 의 상태를 읽어 conf_stat 으로 register 하는 설정 파일의 상태를 읽는다, 그 결과로 파일이 있는지 단언하는 설정 파일이 있는지 단언한다. --list-tasks 전체 출력을 /root/anstags/out/inherit.txt 에, --list-tasks --tags verify 출력을 /root/anstags/out/block.txt 에 저장하세요.
5. 태스크 둘을 더하세요. 어떤 선택에서도 남기는 표식 은 /root/anstags/out/always.marker 에 always 한 줄을 0644 로 쓰고 태그는 always 하나입니다. 함부로 돌면 안 되는 태스크 는 /root/anstags/out/never.marker 에 danger 한 줄을 0644 로 쓰고 태그는 never 와 danger 둘입니다. --tags config 로 실제로 돌려 출력을 /root/anstags/out/always.txt 에 저장하세요 — 어떤 선택에서도 남기는 표식 이 함께 돌아야 합니다. 그리고 --list-tasks --tags danger 출력을 /root/anstags/out/danger.txt 에 저장하세요. /root/anstags/out/never.marker 는 이 실습이 끝날 때까지 만들어지면 안 됩니다.
6. /root/anstags/tasks/common.yml 을 만드세요 — 태스크 둘입니다. 공통 점검 하나 는 common-one 을 출력하고 태그가 없습니다. 공통 점검 둘 은 common-two 를 출력하고 태그 deep 을 갖습니다. 그다음 site.yml 끝에 태스크 둘을 더하세요 — import 로 공통 점검을 끌어온다(import_tasks 로 그 파일을 끌어오고 태그 imported)와 include 로 공통 점검을 끌어온다(include_tasks 로 같은 파일을 끌어오고 태그 included). --list-tasks --tags imported 출력을 /root/anstags/out/reuse-import.txt 에, --list-tasks --tags included 출력을 /root/anstags/out/reuse-include.txt 에 저장하세요.
7. 먼저 /root/anstags/out/reload.marker 를 지우세요. 그다음 --start-at-task "배포 번호를 정한다" -e app_env=prod 로 플레이북을 실제로 돌리고 출력을 /root/anstags/out/startat.txt 에 저장하세요. 끝난 뒤 /root/anstags/app/app.conf 의 내용과 /root/anstags/out/reload.marker 의 존재 여부를 이어서 /root/anstags/out/aftermath.txt 에 남기세요 — 첫 줄은 conf=<app.conf 의 env 줄>, 둘째 줄은 marker=<yes 또는 no> 입니다.
8. /root/anstags/tag-check.sh <태그목록> 을 만드세요. 그 선택으로 site.yml 을 점검 모드로 돌려 보고, 정상으로 끝나면 첫 줄에 SAFE <태그목록> 을 내고 0 으로, 끝나지 않으면 첫 줄에 UNSAFE <태그목록> rc=<종료코드> 를 내고 1 로 끝냅니다. 그다음 ./tag-check.sh deploy 와 ./tag-check.sh prep,deploy 를 차례로 돌려 두 줄을 /root/anstags/out/tagcheck.txt 에 이어 저장하세요. 앞은 UNSAFE, 뒤는 SAFE 여야 합니다.

참고

• 먼저 1단계에서 인벤토리와 플레이북을 만들고 전체를 한 번 수렴시키세요. 태그는 그다음부터 쓰는 도구입니다.
• 명령 힌트: --list-tags 는 어떤 태그가 있는지, --list-tasks [--tags X] 는 그 선택으로 무엇이 돌지 알려 줍니다. 둘 다 대상에 붙지 않아 운영에서도 안전합니다.
• 명령 힌트: 태스크 이름에 공백이 있으므로 --start-at-task '배포 번호를 정한다' 처럼 따옴표로 감쌉니다.
• 흔한 실수: --tags 로 걸러진 태스크가 skipping 으로 표시될 것이라고 기대하는 것. 걸러진 태스크는 출력에서 통째로 빠지고 요약의 skipped 도 0 으로 남습니다.
• 흔한 실수: include_tasks 에 태그를 달고 그 태그로 돌린 뒤 '아무 일도 안 일어난다' 고 당황하는 것.
• 흔한 실수: 중간부터 돌린 실행이 failed=0 으로 끝난 것을 보고 배포가 끝났다고 판단하는 것.
• --step 은 사람이 키를 눌러야 진행하는 대화형 모드라 이 실습에서는 다루지 않습니다. 롤에 태그를 거는 이야기도 롤 자체가 다음 코스의 주제라 여기서는 다루지 않습니다.
• [태그로 일부만 실행하기](https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_tags.html) · [중간부터 실행하기](https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_startnstep.html) · [import 와 include](https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_reuse.html) · [핸들러](https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_handlers.html) · [ansible-playbook 옵션](https://docs.ansible.com/ansible/latest/cli/ansible-playbook.html)

단계 8개

1. 태스크에 태그를 달고 전체를 한 번 수렴시킨다
2. 돌리기 전에 무엇이 돌지 목록으로 먼저 본다
3. 빼는 쪽으로 고른다
4. 블록과 플레이에 건 태그가 아래로 흐른다
5. 언제나 도는 태스크와 절대 안 도는 태스크
6. import 는 태그를 물려주고 include 는 물려주지 않는다
7. 중간부터 돌리면 핸들러도 돌지 않는다
8. 어떤 태그 선택이 완주할 수 있는지 판정하는 도구