Ansible에서 'UNREACHABLE' 오류 해결하기: 실무 가이드

안녕하세요, Fixlog 노트에 오신 것을 환영합니다. 오늘은 Ansible을 사용하시면서 마주칠 수 있는 대표적인 오류 중 하나인 'UNREACHABLE' 오류에 대해 다뤄보겠습니다. 이 오류는 Ansible을 사용하는 개발자라면 한 번쯤은 마주칠 수 있는 흔한 문제 중 하나입니다.

오류 메시지 소개

Ansible에서 'UNREACHABLE' 오류는 주로 Ansible이 타깃 호스트에 접근할 수 없을 때 발생합니다. 이 오류는 다음과 같은 메시지로 나타날 수 있습니다:

"msg": "FAILED! => {"changed": false, "msg": "Failed to connect to the host via ssh: ssh: connect to host x.x.x.x port 22: Connection timed out", "unreachable": true}"

발생 원인

'UNREACHABLE' 오류의 주요 원인은 다음과 같습니다:

• SSH 설정 문제: 타깃 호스트에 SSH 접근이 제대로 설정되지 않았을 수 있습니다.
• 네트워크 문제: 타깃 호스트와의 네트워크 연결이 불안정하거나 방화벽 설정이 문제일 수 있습니다.
• 잘못된 호스트 정보: 인벤토리 파일에 잘못된 IP 주소나 도메인이 설정되어 있을 수 있습니다.

해결 방법

이 문제를 해결하기 위해서는 다음 단계를 따르시면 됩니다:

1. SSH 설정 확인: SSH 키가 타깃 호스트에 올바르게 등록되어 있는지 확인합니다. 또한, SSH 포트(기본 22번)가 열려 있는지 방화벽 설정을 점검합니다.
2. 네트워크 확인: 타깃 호스트와의 네트워크 연결이 안정적인지 확인하세요. 네트워크 연결이 불안정하다면 네트워크 관리자와 협의하여 문제를 해결합니다.
3. 호스트 정보 점검: 인벤토리 파일에 등록된 호스트 정보(IP 주소, 도메인 등)가 정확한지 확인합니다.

코드 예제

다음은 인벤토리 파일 설정 예시입니다. 올바른 IP 주소와 SSH 설정을 점검해보세요:

all:
  hosts:
    webserver:
      ansible_host: 192.168.1.10
      ansible_user: ubuntu
      ansible_ssh_private_key_file: /path/to/private/key

위 예제에서 ansible_host는 타깃 호스트의 IP 주소입니다. ansible_user는 SSH 접속에 사용할 사용자명이며, ansible_ssh_private_key_file는 SSH에 사용할 프라이빗 키 경로입니다.

마무리

오늘은 Ansible에서 자주 발생하는 'UNREACHABLE' 오류에 대해 알아보았습니다. 실무에서 이 오류가 발생했을 때 위의 방법들을 순차적으로 적용해 보시면 문제를 해결하는 데 도움이 될 것입니다. Ansible을 사용하면서 발생하는 다양한 오류에 대해 더 알고 싶으시다면, Fixlog 노트를 계속 지켜봐 주세요. 감사합니다!