AnsibleModule 및 인수 사양
모듈 입력을 정의하고 검증합니다.
AnsibleModule 및 인수 사양은(는) CoddyKit의 무료 Ansible Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Ansible Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Ansible Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
AnsibleModule 알아보기
AnsibleModule 클래스는 여러분의 도구 모음입니다. Ansible이 보내는 인수를 해석하고 검증하며 결과를 반환하는 도우미를 제공합니다.
from ansible.module_utils.basic import AnsibleModuleargument_spec 매핑
모듈이 허용하는 모든 입력을 argument_spec 딕셔너리에 설명합니다. Ansible은 이를 읽어 사용자가 전달한 값을 검증합니다.
argument_spec=dict(
name=dict(type='str', required=True)
)각 인수에 유형 지정하기
str, int, bool, list 또는 dict와 같은 type을 설정하십시오. Ansible은 코드가 실행되기 전부터 잘못된 입력을 변환하거나 거부합니다.
count=dict(type='int', default=1)필수 항목 표시하기
required=True를 추가하면 사용자가 해당 인수를 빠뜨렸을 때 Ansible이 명확한 오류와 함께 실패합니다. 별도의 방어적 검사가 필요하지 않습니다.
path=dict(type='str', required=True)합리적인 기본값 제공하기
default를 사용하면 선택적 인수에 값이 자동으로 지정됩니다. 사용자는 변경하려는 항목만 설정하면 됩니다.
state=dict(type='str', default='present')유효한 선택지로 제한하기
choices 목록은 인수를 허용된 값으로 제한합니다. 다른 값은 처음부터 유용한 메시지와 함께 거부됩니다.
state=dict(choices=['present', 'absent'])모듈 객체 만들기
사양을 AnsibleModule에 전달하여 객체를 만드십시오. 이제부터 모든 입력은 module.params에 안전하게 저장됩니다.
module = AnsibleModule(argument_spec=argument_spec)검증된 입력 읽기
module.params라는 일반 딕셔너리를 통해 인수에 접근하십시오. 값은 이미 유형이 지정되고 검증되었으므로 바로 사용하면 됩니다.
name = module.params['name']인수 간 규칙
두 인수를 함께 사용해야 하거나 절대로 함께 사용하면 안 되나요? required_together 또는 mutually_exclusive와 같은 규칙을 AnsibleModule에 전달하면 해당 규칙을 적용합니다.
mutually_exclusive=[['src', 'content']]no_log로 비밀 숨기기
민감한 입력에 no_log=True를 표시하면 비밀번호가 Ansible 로그나 자세한 출력에 절대 나타나지 않습니다.
password=dict(type='str', no_log=True)사양에 작업 맡기기
좋은 argument_spec은 수많은 수동 검사를 대신합니다. 입력을 한 번만 설명하면 Ansible이 형식, 오류, 문서까지 자동으로 처리해 줍니다.
빠른 확인
사용자 입력이 모듈 코드에 어떻게 전달되는지 생각해 보십시오.
복습
형식, 기본값, 필수 여부, 선택지를 사용해 argument_spec에 입력을 정의하고, AnsibleModule을 만든 다음 module.params에서 정리된 값을 읽으십시오. ✅
자주 묻는 질문
“AnsibleModule 및 인수 사양” 강의는 무료인가요?
네 — “AnsibleModule 및 인수 사양” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Ansible Academy 강의 전체를 잠금 해제할 수 있습니다. Ansible Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“AnsibleModule 및 인수 사양”에서 뭘 배우나요?
모듈 입력을 정의하고 검증합니다. 브라우저에서 직접 실행하는 실습 코드로 Ansible Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Ansible Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Ansible Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“AnsibleModule 및 인수 사양” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Ansible Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Ansible Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 사용자 지정 모듈을 만들 시점
- AnsibleModule 및 인수 사양
- JSON 반환 및 changed 준수
- 모듈에서 검사 모드 지원하기