ansible-deployment

name	ansible-deployment
description	Automates server configuration and multi-server deployments. Use when writing Ansible playbooks, setting up SSH auth, or checking deployment diffs.

Ansible Deployment Automation

서버 설정 파일 배포 시 안전하고 효율적인 Ansible 패턴을 제공합니다.

핵심 철학:

• 배포 전 diff 확인 필수 (사용자가 변경 내용 검토)
• Ansible 네이티브 기능 우선 (shell 스크립트 최소화)
• 단일 비밀번호 입력으로 전체 워크플로우 완료
• 색상 diff로 가독성 향상

Instructions

워크플로우: 요청 분석 및 리소스 선택

사용자 요청을 분석하여 필요한 리소스만 선택적으로 로드합니다.

1. 키워드 매칭

사용자 요청의 키워드를 분석하여 필요한 리소스를 판단:

Diff 체크 (resources/01-diff-checking.md)

• "diff", "차이", "변경 사항"
• "배포 전 확인", "dry-run"
• "file_diff_checker"
• "copy 모듈"

SSH 인증 (resources/02-ssh-auth.md)

• "SSH", "인증", "비밀번호"
• "vars_prompt"
• "ProxyJump", "Gateway"
• "VPN", "접속"

Copy 모듈 활용 (resources/03-copy-module.md)

• "copy 모듈", "copy module"
• "check_mode", "diff"
• "파일 동기화", "파일 배포"

Playbook 패턴 (resources/04-playbook-patterns.md)

• "playbook", "role"
• "배포", "deploy"
• "서비스 reload", "handler"
• "사용자 확인", "pause"

검증 및 테스트 (resources/05-testing-validation.md)

• "syntax check", "문법 검사"
• "dry-run", "테스트"
• "lint", "검증"
• "justfile"

2. 리소스 로딩 전략

단일 키워드 감지

• User: "배포 전 diff 확인하고 싶어"
• → Read resources/01-diff-checking.md
• → Read resources/03-copy-module.md

복합 요청

• User: "Ansible로 설정 파일 안전하게 배포하는 방법"
• → Read resources/01-diff-checking.md (Diff)
• → Read resources/02-ssh-auth.md (SSH)
• → Read resources/03-copy-module.md (Copy)
• → Read resources/04-playbook-patterns.md (Playbook)

불명확한 요청

• User: "Ansible 배포 설정"
• → REFERENCE.md 확인하여 사용자에게 선택지 제시
• → 선택에 따라 리소스 로드

3. 리소스 적용

1. 현재 프로젝트 구조 파악

   • ansible 디렉토리 위치 확인
   • 기존 playbook, role 확인

2. 리소스 Read

   • 필요한 리소스만 Read
   • 다른 리소스 참조 필요 시 추가 Read

3. 패턴 적용

   • Read한 리소스의 패턴을 프로젝트에 적용
   • 기존 설정이 있으면 수정, 없으면 생성
   • 사용자에게 변경 사항 확인

4. 검증

   • ansible-playbook --syntax-check
   • 가능하면 실행하여 동작 확인
   • 문제 발생 시 사용자에게 보고

예시

예시 1: Diff 체크 Role 생성

User: "배포 전에 변경 내용을 diff로 보고 싶어"

1. 키워드 매칭: "diff", "배포 전" → Diff Checking
2. Read resources/01-diff-checking.md
3. Read resources/03-copy-module.md
4. ansible/roles/file_diff_checker/ 생성
5. copy 모듈 check_mode + diff 패턴 적용
6. 사용자에게 사용법 안내

예시 2: SSH 인증 개선

User: "Ansible 실행할 때 비밀번호 여러 번 입력하기 귀찮아"

1. 키워드 매칭: "비밀번호" → SSH Auth
2. Read resources/02-ssh-auth.md
3. vars_prompt 설정 추가
4. ansible_password + ansible_become_password 설정
5. 테스트 실행 확인

예시 3: 안전한 배포 Playbook

User: "서버 설정 파일을 안전하게 배포하는 playbook 만들어줘"

1. 키워드 매칭: "배포", "안전" → 전체
2. Read resources/01-diff-checking.md
3. Read resources/02-ssh-auth.md
4. Read resources/03-copy-module.md
5. Read resources/04-playbook-patterns.md
6. Playbook 생성 (diff → 확인 → 배포 → reload)
7. 실행 테스트

중요 원칙

1. 토큰 효율: 필요한 리소스만 Read
2. Ansible 네이티브 우선: shell 스크립트 대신 Ansible 모듈 사용
3. 사용자 확인: 배포 전 diff 확인 필수
4. 실행 검증: 가능하면 항상 실행하여 동작 확인
5. 범용성: 프로젝트 특정 내용 없이 패턴만 제공

Technical Details

상세한 설정 및 예제는 각 리소스 파일 참조:

• REFERENCE.md: 리소스 전체 개요
• resources/01-diff-checking.md: 배포 전 diff 확인 패턴
• resources/02-ssh-auth.md: SSH 인증 및 vars_prompt
• resources/03-copy-module.md: copy 모듈 활용법
• resources/04-playbook-patterns.md: 안전한 배포 playbook 구조
• resources/05-testing-validation.md: 검증 및 테스트 워크플로우