1. ansible-navigator 개요

이 게시글에서는 ansible navigator 개념 및 설치 방법에 대한 예시만 안내드리는 글입니다.

ansible-navigator는 Red Hat이 제공하는 텍스트 기반 TUI 툴로, 기존에 ansible-playbook이나 ansible-lint처럼 개별 명령을 일일이 실행하던 방식에서 한 단계 진화한 작업 흐름을 제공합니다. 실행 환경 execution environment(이하 EE) 이미지를 적극 활용하므로 운영체제 의존성과 파이썬 패키지 충돌 이슈를 최소화하며, 플레이북 실행·결과 열람·플러그인 문서 조회·인벤토리 탐색을 한 화면에서 해결할 수 있습니다.

1.1. execution environment가 중요한 이유

EE는 컨테이너화된 Ansible 런타임입니다. EE 안에는 ansible-core, ansible-lint, 필수 파이썬 라이브러리, collections, 그리고 ssh client까지 한데 들어 있어 “작동이 보장된” 실행 단위를 만들 수 있습니다. 따라서 개발 노트북, CI 러너, 스테이징 서버 어디에서 돌리든 결과가 일관됩니다. 또한 이미지 태깅을 통해 ee:v1.2.3 처럼 버전 관리를 하면 인프라 코드의 재현성이 CI/CD 파이프라인 수준에서 확보됩니다.

2. 설치 전 체크리스트

본격적인 설치에 앞서 시스템 요건을 점검합니다.

• 리눅스 배포판: 최신 Fedora, CentOS Stream, RHEL, Ubuntu LTS 등
• 컨테이너 엔진: Podman 또는 Docker 중 택 1
• Python 3.9 이상, pip, 그리고 인터넷 연결(EE 이미지 최초 다운로드 시 필요)

2.1. Podman과 Docker 선택 가이드

Podman은 데몬리스 구조라 systemd 서비스 충돌이 없고 rootless 모드를 기본 지원합니다. 반면 Docker는 생태계가 넓고 Mac·Windows에서도 동일 UX를 제공합니다. 팀 내 표준에 맞춰 선택하되, 이후 예시는 Podman 기준으로 설명합니다.

2.1.1. Podman 설치 예시(Fedora 계열)

```bash

sudo dnf install -y podman

```

>해당 명령을 실행할 시 Podman 바이너리와 의존 패키지가 설치되어 EE 이미지 실행이 가능합니다.

2.1.2. Docker 설치 예시(Ubuntu LTS)

```bash

sudo apt-get update

sudo apt-get install -y docker.io

sudo systemctl enable --now docker

```

>해당 명령을 실행할 시 Docker 데몬이 부팅 시 자동 시작되며 EE 이미지를 바로 받을 수 있습니다.

3. ansible-navigator 설치 절차

3.1. Python pip 설치

```bash

sudo dnf install python3-pip -y

```

>해당 명령을 실행할 시 시스템 패키지 저장소에서 pip가 설치되어 파이썬 패키지 관리가 가능해집니다.

3.2. ansible-navigator 패키지 설치

```bash

python3 -m pip install ansible-navigator --user

```

>해당 명령을 실행할 시 사용자의 홈 디렉터리 하위 경로에 ansible-navigator가 설치되어 시스템 전역 라이브러리 충돌을 피할 수 있습니다.

3.3. PATH 환경 변수 반영

```bash

echo 'export PATH=$HOME/.local/bin:$PATH' >> ~/.profile

source ~/.profile

```

>해당 명령을 실행할 시 쉘 재시작 없이 ansible-navigator 바이너리를 즉시 인식합니다.

4. ansible-navigator 최초 실행 및 EE 다운로드

```bash

ansible-navigator

```

>해당 명령을 실행할 시 quay.io에 호스팅된 ansible-runner-demo-ee 이미지가 한 번만 자동 다운로드되고, 이후부터는 로컬 캐시를 사용해 빠르게 구동됩니다.

첫 화면에서는 메뉴 구성이 직관적으로 표시됩니다. e 키로 플레이북 실행, i 키로 인벤토리 브라우저, d 키로 collections Docsite 보기 등 대부분의 작업을 키 한두 번으로 접근할 수 있습니다.

5. Troubleshooting 및 최적화 팁

컨테이너 네트워크 오류

사내 프록시 뒤에 있다면 podman pull --tls-verify=false 옵션으로 인증서 오류를 일시 우회하거나, system-wide CA 번들에 내부 루트를 추가합니다.

플러그인 경로 충돌
동일 호스트에 기존 ansible-core가 설치돼 있더라도 EE 안의 버전이 우선 적용됩니다. 만약 호스트 collections를 함께 쓰고 싶다면 -eei 플래그에 볼륨 옵션을 지정해 로컬 디렉터리를 EE /runner/project 경로에 마운트합니다.

```bash

ansible-navigator run site.yml -m stdout -eei my-ee:latest -eev /home/test/collections:/usr/share/ansible/collections

```

>해당 명령을 실행할 시 커스텀 EE 이미지와 로컬 컬렉션을 함께 사용해 테스트와 운영 환경 간 동작 차이를 제거할 수 있습니다.

6. 마무리 및 다음 단계

ansible-navigator는 단순한 CLI 런처가 아니라, 실행·검증·문서화 일체형 인터페이스입니다. EE로 표준화된 런타임, 키보드 기반 TUI, 그리고 풍부한 옵션 덕분에 복잡한 하이브리드 인프라에서도 배포 품질을 일정하게 유지할 수 있습니다. 지금까지 소개한 기본 설치를 완료했다면, 다음 단계로는

• ansible-navigator config dump 로 현재 설정 확인
• ansible-builder 를 사용해 조직 맞춤 EE 이미지 제작
• CI 단계에 ansible-navigator run 을 넣어 인프라 코드 테스트 자동화
• toc 모드로 collections 문서 생성 자동화

까지 확장해보시길 권해드립니다.