모듈에서 검사 모드 지원하기
사용자 지정 코드를 시험 실행에 안전하게 만듭니다.
모듈에서 검사 모드 지원하기은(는) CoddyKit의 무료 DevOps Bootcamp 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 DevOps Bootcamp 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. DevOps Bootcamp 강의에는 총 4개의 강의가 포함되어 있습니다.
검사 모드란
검사 모드에서는 사용자가 --check를 사용해 플레이북을 실행하고 변경 사항을 미리 확인합니다. 호스트에서는 실제로 아무것도 수정되지 않습니다.
ansible-playbook site.yml --check모듈에서 명시적으로 활성화해야 합니다
검사 모드는 자동으로 적용되지 않습니다. 이 모드를 지원한다고 선언해야 Ansible이 모듈이 이 모드에서 변경하지 않을 것임을 알 수 있습니다.
AnsibleModule에서 선언하기
모듈을 만들 때 supports_check_mode=True로 설정하십시오. 이 플래그는 코드가 시험 실행 요청을 준수한다는 것을 Ansible에 알립니다.
module = AnsibleModule(
argument_spec=spec,
supports_check_mode=True)module.check_mode 읽기
실행 중에는 module.check_mode를 확인하십시오. 사용자가 --check를 전달하면 True가 되며, 이 값에 따라 로직을 분기합니다.
if module.check_mode:
module.exit_json(changed=True)계산만 하고 적용하지 않기
검사 모드에서도 변경이 필요한지 계산해야 합니다. 다만 시스템에 무엇인가를 쓰기 전에 실행을 멈추면 됩니다.
변경 예정 사항 보고
올바른 changed 값으로 일찍 종료하여, 아무 일도 일어나지 않았더라도 시험 실행 미리 보기가 정직하게 표시되도록 하십시오.
if module.check_mode:
module.exit_json(changed=needs_change)읽기는 항상 안전합니다
현재 상태를 수집하는 것은 읽기가 아무것도 변경하지 않으므로 검사 모드에서도 괜찮습니다. 건너뛰어야 하는 것은 쓰기 단계뿐입니다.
잊으면 위험합니다
검사 모드 지원을 생략하면 시험 실행 중에도 모듈이 호스트를 여전히 수정할 수 있습니다. 그러면 사용자의 기대를 저버리게 됩니다.
실제 실행 로직과 맞추기
검사 모드의 변경 감지는 일반 실행과 정확히 일치해야 합니다. 잘못된 미리 보기는 미리 보기가 전혀 없는 것보다 더 나쁩니다.
두 경로 모두 테스트
--check를 사용한 경우와 사용하지 않은 경우 모두 모듈을 실행하십시오. 시험 실행에서도 동일한 changed 결과를 보고하면서 시스템은 건드리지 않는지 확인하십시오.
검사 모드가 신뢰를 만듭니다
검사 모드를 준수하는 모듈을 사용하면 팀이 적용 전에 안전하게 미리 확인할 수 있습니다. 이런 완성도가 장난감 모듈과 운영 환경용 모듈을 구분합니다.
빠른 확인
검사 모드를 지원하려면 모듈에 어떤 두 가지가 필요한지 떠올려 보십시오.
복습
supports_check_mode=True를 전달하고, module.check_mode에 따라 분기하며, 변경 사항은 계산하되 쓰기는 건너뛰고, changed를 정직하게 보고하십시오. 이제 모듈이 시험 실행에서도 안전하게 동작합니다. 🔍
자주 묻는 질문
“모듈에서 검사 모드 지원하기” 강의는 무료인가요?
네 — “모듈에서 검사 모드 지원하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 DevOps Bootcamp 강의 전체를 잠금 해제할 수 있습니다. DevOps Bootcamp 강의에는 총 4개의 강의가 포함되어 있습니다.
“모듈에서 검사 모드 지원하기”에서 뭘 배우나요?
사용자 지정 코드를 시험 실행에 안전하게 만듭니다. 브라우저에서 직접 실행하는 실습 코드로 DevOps Bootcamp을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
DevOps Bootcamp을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 DevOps Bootcamp은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“모듈에서 검사 모드 지원하기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 DevOps Bootcamp 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 DevOps Bootcamp 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 사용자 지정 모듈을 만들 시점
- AnsibleModule 및 인수 사양
- JSON 반환 및 changed 준수
- 모듈에서 검사 모드 지원하기