사용자 지정 모듈을 만들 시점
기존 모듈이 해결하지 못하는 부분을 파악합니다.
사용자 지정 모듈을 만들 시점은(는) CoddyKit의 무료 Ansible Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Ansible Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Ansible Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
기본 제공 기능으로 부족할 때
Ansible에는 수천 개의 모듈이 포함되어 있지만 필요에 맞는 모듈이 없을 때도 있습니다. 바로 그럴 때 사용자 지정 모듈을 만들 가치가 있습니다.
만들기 전에 검색하기
항상 먼저 Galaxy와 문서를 확인하십시오. 커뮤니티 컬렉션이 이미 까다로운 API를 감싸고 있을 수 있으므로 코드를 전혀 작성하지 않아도 됩니다.
shell 모듈을 의심해야 할 때
플레이북이 command와 shell 호출로 출력을 해석하는 내용으로 가득하다면 신호로 받아들여야 합니다. 모듈을 사용하면 그런 복잡한 처리를 깔끔한 인수 뒤에 숨길 수 있습니다.
ansible.builtin.command: myapp create --name web얻을 수 없는 멱등성
원시 shell 작업은 실행할 때마다 변경되었다고 보고합니다. 실제 모듈은 먼저 현재 상태를 확인하므로, shell로는 얻을 수 없는 멱등성을 제공합니다.
사용자 지정 API 감싸기
아직 모듈이 없는 내부 도구나 REST API를 사용하고 있을 수도 있습니다. 사용자 지정 모듈을 만들면 해당 통합을 깔끔하고 재사용 가능한 하나의 작업으로 바꿀 수 있습니다.
모듈은 대상에서 실행됩니다
모듈은 제어 컴퓨터가 아니라 관리 대상 노드에서 실행된다는 점을 기억하십시오. 따라서 모듈의 Python과 필요한 라이브러리가 원격 호스트에 있어야 합니다.
필터와 플러그인은 다릅니다
모든 부족한 기능에 모듈이 필요한 것은 아닙니다. 템플릿에서 데이터를 변환하는 일은 필터 플러그인의 역할이고, 모듈은 호스트에서 실제 작업을 수행합니다.
모듈이 위치할 곳
플레이북 옆의 library 폴더에 파일 하나를 넣으면 Ansible이 자동으로 찾습니다. 시작할 때 패키징할 필요는 없습니다.
myproject/
library/
my_module.py
playbook.yml기본 언어는 Python입니다
대부분의 모듈은 Ansible이 Python용 도우미 라이브러리를 제공하기 때문에 Python으로 작성합니다. 다른 언어도 사용할 수 있지만 이러한 지원은 받을 수 없습니다.
모듈 하나에 집중하기
기본 제공 모듈과 마찬가지로 사용자 모듈도 한 가지 작업을 잘 수행해야 합니다. 서로 관련 없는 작업 다섯 가지를 하나의 거대한 파일에 억지로 넣지 마십시오.
모듈 계약
모든 모듈은 계약을 따릅니다. JSON 인수를 받고, 작업을 수행한 다음, JSON 결과를 반환합니다. 이를 익히면 무엇이든 만들 수 있습니다.
빠른 확인
직접 모듈을 작성해야 할 진짜 이유가 무엇인지 생각해 보십시오.
복습
검색을 먼저 수행한 뒤, shell과 기본 제공 기능으로는 얻을 수 없는 멱등적이고 재사용 가능한 작업이 필요할 때만 사용자 지정 모듈을 만드십시오. 모듈의 역할을 명확히 유지하십시오. 🛠️
자주 묻는 질문
“사용자 지정 모듈을 만들 시점” 강의는 무료인가요?
네 — “사용자 지정 모듈을 만들 시점” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Ansible Academy 강의 전체를 잠금 해제할 수 있습니다. Ansible Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“사용자 지정 모듈을 만들 시점”에서 뭘 배우나요?
기존 모듈이 해결하지 못하는 부분을 파악합니다. 브라우저에서 직접 실행하는 실습 코드로 Ansible Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Ansible Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Ansible Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.
“사용자 지정 모듈을 만들 시점” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Ansible Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Ansible Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 사용자 지정 모듈을 만들 시점
- AnsibleModule 및 인수 사양
- JSON 반환 및 changed 준수
- 모듈에서 검사 모드 지원하기