메인 콘텐츠로 건너뛰기
Ansible AWX 서버를 연결하면 CloudThinker 에이전트가 작업 템플릿을 실행하고, 작업을 모니터링하며, 인벤토리와 호스트를 관리하고, 프로젝트를 동기화하며, 자동화 워크플로를 오케스트레이션할 수 있습니다. AWX는 읽기 또는 쓰기 작업 범위의 사용자 액세스 토큰으로 인증합니다.

​
사전 요구사항

  • CloudThinker에서 HTTPS로 접근 가능한 자체 호스팅 AWX 또는 Ansible Automation Platform(Controller/Tower) 인스턴스.
  • CloudThinker가 접근해야 하는 조직 및 인벤토리에 대한 접근 권한을 가진 AWX 사용자.

​
설정

1

AWX에 로그인

AWX 웹 인터페이스에 로그인합니다. CloudThinker가 필요로 하는 조직과 인벤토리에만 범위가 제한된 전용 사용자를 사용하세요.
2

액세스 토큰 생성

Access → Users로 이동하여 사용자를 열고, Tokens 탭을 선택한 후 Add를 클릭합니다:
  • Application: 비워둡니다
  • Scope: 전체 작업의 경우 Write, 모니터링 전용의 경우 Read
토큰을 복사합니다 — AWX는 토큰을 한 번만 표시합니다.
3

CloudThinker에서 연결 추가

Connections → AWX로 이동하여 다음을 입력합니다:
  • TOWER_HOST: AWX 주소, 예: https://awx.your-domain.com
  • TOWER_OAUTH_TOKEN: 이전 단계에서 생성한 토큰
Connect를 클릭합니다. CloudThinker가 자격 증명을 확인하고 Connected 상태를 표시합니다.

​
연결 세부 정보

필드설명예시
TOWER_HOSTAWX 인스턴스의 기본 URLhttps://awx.your-domain.com
TOWER_OAUTH_TOKENAWX 사용자 액세스 토큰—

​
필요 권한

에이전트가 수행할 수 있는 작업은 토큰 범위에 따라 다릅니다.
  • Read — 작업 목록 조회, 인벤토리 검사, 프로젝트 상태 확인, 스케줄 검토, 구성 확인.
  • Write — 모든 읽기 작업에 더해 작업 실행, 임시 명령 실행, 실행 중인 작업 제어, 프로젝트 동기화, 호스트·그룹·스케줄 관리.
모니터링 전용에는 Read 범위 토큰을 사용하고, 에이전트가 리소스를 실행하거나 수정해야 할 경우에만 Write 범위를 추가하세요. Write 작업은 CloudThinker에서 승인 게이트를 설정하여 관리하세요.

​
에이전트 기능

에이전트가 수행할 수 있는 작업은 토큰 범위에 따라 다릅니다. Read — 모니터링 및 검사:
기능설명
작업 모니터링작업 및 워크플로 실행 목록 조회, 상태 확인, 출력 읽기
인벤토리 검사인벤토리, 호스트, 그룹 확인; 접근 불가능하거나 비활성화된 호스트 탐지
프로젝트 상태 확인동기화 상태 및 소스 컨트롤 상태 검토
스케줄 검토스케줄 목록 및 예정된 실행 확인
구성 검사작업 템플릿, 워크플로 템플릿, 인벤토리 소스, 자격 증명 유형 확인
Write — 추가 작업(승인 필요):
기능설명
작업 실행추가 변수와 함께 작업 템플릿 실행 및 완료까지 모니터링
임시 명령 실행템플릿 없이 호스트에 일회성 명령 실행
실행 중인 작업 제어진행 중인 작업 취소 및 실패한 작업 재실행
프로젝트 및 인벤토리 동기화소스 컨트롤에서 프로젝트 업데이트 가져오기 및 동적 인벤토리 갱신
호스트·그룹·스케줄 관리추가, 수정, 삭제 및 호스트 활성화 전환
워크플로 오케스트레이션워크플로 작업 템플릿 실행 및 승인 노드 허용/거부
관리 리소스(조직, 팀, 사용자, RBAC)는 에이전트 작업 범위에 포함되지 않습니다.

​
연결 확인

@alex list all AWX inventories and show any unreachable hosts

​
예시 프롬프트

@kai list failed AWX jobs in the last 24 hours and #report their output
@kai launch the deploy-production job template with version=2.1.0 and monitor it
@alex check all AWX projects for sync failures and #recommend updates

​
트러블슈팅

AWX URL이 HTTPS를 통해 CloudThinker에서 접근 가능한지 확인합니다. 토큰이 만료되거나 폐기되지 않았는지 확인하세요 — 필요한 경우 새 토큰을 생성하고 다시 연결합니다.
토큰 범위가 요청한 작업을 허용하지 않습니다. 실행, 동기화 또는 관리 작업에는 Write 범위 토큰을 사용하고, 사용자가 대상 조직 또는 인벤토리에 대한 접근 권한을 가지고 있는지 확인합니다.
토큰 사용자가 요청한 리소스를 볼 수 없습니다. AWX에서 관련 조직 및 인벤토리에 대한 접근 권한을 부여한 후 다시 시도합니다.

​
보안

  • 최소 권한 — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
  • 기본 읽기 전용 — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
  • 자격증명 교체 — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
  • 오프보딩 시 취소 — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.
  • 필요할 때만 Write 범위 사용 — 모니터링에는 Read 범위 토큰을 사용하고, 에이전트가 리소스를 실행하거나 수정해야 할 경우에만 Write 범위를 활성화합니다.
  • HTTPS만 사용 — 항상 HTTPS AWX URL을 사용하세요; 일반 텍스트 연결은 액세스 토큰을 노출합니다.

​
관련 항목

https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/argocd.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=34c7a30ed3772de41da3c56cb43396b3

ArgoCD 연결

GitOps 운영 및 애플리케이션 관리
https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/jenkins.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=871f9df2f5553b663f1b5c33f11bf5da

Jenkins 연결

CI/CD 파이프라인 모니터링 및 작업 운영