# 9-AWX 사용메뉴얼 ### 대쉬보드
1. AWX로그인 후 첫 페이지, 작업상태 및 호스트상태, 최근 사용한 템플릿과 최근 실행한 작업 요약 확인 가능 ( ACCESS → DASHBOARD ) [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-cz2ozbjq.png)](http://igoni.kr/uploads/images/gallery/2022-09/EoFimage.png)
### 최근 실행 작업
1. 최근에 실행한 템플릿의 요약정보 확인 ( ACCESS → Jobs ) [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-divmhjqy.png)](http://igoni.kr/uploads/images/gallery/2022-09/wwcimage.png) 2. Job결과 확인 1. 아이콘 확인 1. [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-nyscnatk.png)](http://igoni.kr/uploads/images/gallery/2022-09/audimage.png) : 정상 작업 완료 2. [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-e54auwdb.png)](http://igoni.kr/uploads/images/gallery/2022-09/DCiimage.png) : 작업 실패 2. 작업관리 1. [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-6xukiuky.png)](http://igoni.kr/uploads/images/gallery/2022-09/gjXimage.png) : 동일한 vars값으로 재실행 2. [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-wisqk265.png)](http://igoni.kr/uploads/images/gallery/2022-09/3Cuimage.png) : 작업이력 삭제
### 스케쥴 확인
1. 스케쥴링 설정된 작업 리스트 (ACCESS → Schedules ) [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-bejouy2w.png)](http://igoni.kr/uploads/images/gallery/2022-09/WmIimage.png) 2. 스케쥴 작업 관리 (왼쪽에서부터)
**항목****설 명**
활성화체크+파란색 아이콘 : 활성화 체크X + 회색 아이콘 : 비활성화
NAME스케쥴 이름
TYPETemplate 유형
NEXT RUN다음 실행 시간 (빈칸일 경우 스케쥴링 실행되지 않음)
ACTION[![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-wl0p5hfs.png)](http://igoni.kr/uploads/images/gallery/2022-09/Essimage.png) : 스케쥴 정보 수정 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-s169iotk.png)](http://igoni.kr/uploads/images/gallery/2022-09/HrQimage.png): 스케쥴 정보 삭제
## 관리 메뉴 ### 조직관리
1. 사용자 / 팀 / 프로젝트 / 인벤토리를 관리하는 최 상단 그룹( ACCESS → ORGANIZATIONS)\\ 2. 조직 계층 구조 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-wuajyhuv.png)](http://igoni.kr/uploads/images/gallery/2022-09/PsYimage.png) 3. 조직생성 ([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-syg1dztr.png)](http://igoni.kr/uploads/images/gallery/2022-09/Sefimage.png) 버튼 선택) 1. 조직 생성 입력 화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-gxtvsxoe.png)](http://igoni.kr/uploads/images/gallery/2022-09/wK0image.png) 2. 항목별 상세설명
**항 목****값 설명****비 고**
NAME조직이름필수
DESCRIPTION조직에 대한 설명옵션
INSTANCE GROUPS인스턴스 그룹옵션
4. 조직 관리 1. USERS : 조직에 소속시킬 사용자 (계정명 선택) 2. PERMISSIONS : 조직의 권한설정
**항 목****설 명**
Admin전체 권한 부여
Execute프로젝트 실행만 가능
Project Admin프로젝트 생성 / 수정 / 읽기 가능
Inventory Admin인벤토리 생성 / 수정 / 읽기 가능
Credential Admin자격증명 생성 / 수정 / 읽기 가능
Workflow Admin워크 플로우 생성
Notification Admin알림 할당
Auditor읽기 전용 권한
Member템플릭을 제외한 모든 기능 읽기 가능
Read읽기 전용 권한
3. NOTIFICATIONS : 알람정책 관리 : 알람생성은 ( {{ 참조 }} )
### 사용자 관리
1. AWX에 접근하는 사용자의 관리 ( ACCESS → Users) 2. 사용자 생성 ([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-gax3xo7b.png)](http://igoni.kr/uploads/images/gallery/2022-09/AFuimage.png) 버튼 선택) 1. 사용자 입력 화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-k6b973p6.png)](http://igoni.kr/uploads/images/gallery/2022-09/LGeimage.png) 2. 항목별 상세 설명
**항 목****값 설명****비 고**
FIRST NAME사용자 이름 정보옵션
LAST NAME사용자 이름 정보옵션
ORGANIZATION계정 소속 조직필수
EMAIL해당 계정 이메일주소필수
USERNAME계정명필수
PASSWORD계정 패스워드필수
CONFIRM PASSWORD계정 패스워드 확인필수
USER TYPE계정 권한옵션
3. 사용자 관리 1. USER TYPE별 권한 정보
**권한명****설 명**
Normal User사용이 제한된 권한, 권한 정책에 따라 읽기/쓰기 가능
System Auditor모든 속성에 대해 읽기 권한
System Administrator모든 속성에 대해 읽기/쓰기 권한 (= superuser)
### 팀 관리
1. 사용자 / 프로젝트 권한을 설정할 수 있는 조직단위의 세부 구성 ( ACCESS → TEAM) 2. 팀 생성 1. 팀 생성 입력 화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-clga5m0m.png)](http://igoni.kr/uploads/images/gallery/2022-09/9alimage.png) 2. 항목별 상세설명
**항 목****값 설명****비 고**
NAME팀 이름필수
DESCRIPTION팀 설명옵션
ORGANIZAION소속된 조직필수
3. 팀 관리 1. USER : 팀 소속 사용자 2. PERMISSION : 템플릿 / 워크플로우 / 프로젝트 / 인벤토리 / 인증 / 조직별 권한 설정 1. 템플릿 권한
**항 목****설 명**
Admin선택한 템플릿의 전체 권한
Execute선택한 템플릿의 실행 / 점검권한
Read선택한 템플릿의 읽기 권한
2. 워크플로우 권한
**항 목****설 명**
Admin 선택한 템플릿의 전체 권한
Execute 선택한 템플릿의 실행 / 점검 권한
Read 선택한 템플릿의 읽기 권한
Approve작업승인여부 관리
3. 프로젝트 권한
**항 목****설 명**
Admin 선택한 프로젝트의 전체 권한
Execute 선택한 프로젝트의 설정 / 점검권한
Read 선택한 프로젝트의 읽기 권한
4. 인벤토리 권한
**항 목****설 명**
Admin 선택한 인벤토리의 전체권한
Update 인벤토리 업데이트 권한
Ad Hoc임시명령 (ping, win\_ping 등) 실행 가능 권한
Use 인벤토리 사용 권한
Read 인벤토리 읽기 권한
5. 조직 권한
**항 목****설 명**
Execute실행 / 점검 권한
Project Admin프로젝트 생성 / 수정 / 읽기 가능
Inventory Admin인벤토리 생성 / 수정 / 읽기 가능
Credential Admin자격증명 생성 / 수정 / 읽기 가능
Workflow Admin워크 플로우 생성
Notification Admin알림 할당
Job Template Admin템플릿 관리 권한
Auditor읽기 전용 권한
Read읽기 전용 권한
## 인증정보
1. AWX 사용에 필요한 계정정보 (RESOURCES → Credentials) 2. 인증정보 생성 ([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-4imidkd8.png)](http://igoni.kr/uploads/images/gallery/2022-09/RWOimage.png) 버튼 선택) 1. Machine 타입으로 인증생성 입력화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-rcrlkzdx.png)](http://igoni.kr/uploads/images/gallery/2022-09/XBmimage.png) 2. 항목별 상세설명
**항 목****설 명****비 고**
NAME 계정이름필수
DESCRIPTION 계정설명옵션
ORGANIZATION 소속 조직옵션
CREDENTIAL TYPE (Machine )winrm / ssh 등 장비로그인시 사용필수
USERNAME 실제 로그인하는 계정명필수
비밀번호 로그인시 사용하는 패스워드필수
PRIVILEGE ESCALATION METHOD상위 계정(root)을 권한 상승 방식옵션
PRIVILEGE ESCALATION USERNAME권한상승시 필요한 계정옵션
PRIVILEGE ESCALATION PASSWORD권한 상승하기 위한 패스워드 입력옵션
3. Source control 타입으로 인증생성 입력화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-ngqk2luf.png)](http://igoni.kr/uploads/images/gallery/2022-09/xvkimage.png) 4. 항목별 상세설명
**항 목****설 명****비 고**
NAME 계정이름필수
DESCRIPTION 계정설명옵션
ORGANIZATION 소속 조직옵션
CREDENTIAL TYPE (Machine )Git / subversion 로그인시 사용필수
USERNAME 실제 로그인하는 계정명필수
5.
### 프로젝트
1. playbook이 저장된 위치 설정 (RESOURCES → Project) 2. 프로젝트 생성 방법 ([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-ke9hv2ho.png)](http://igoni.kr/uploads/images/gallery/2022-09/RWOimage.png) 버튼 선택) 1. 프로젝트 생성 입력 화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-el0ai32b.png)](http://igoni.kr/uploads/images/gallery/2022-09/Bm5image.png) - 항목별 상세설명
**항 목****설 명****비 고**
NAME 프로젝트 이름필수
DESCRIPTION 프로젝트 설명옵션
ORGANIZATION 프로젝트 조직필수
SCM TYPE- Manual : 배포서버의 파일형태로 관리 (awx\_task 컨테이너 /var/lib/awx/project에 playbook이 저장되어 있어야 함) - git : git을 통해 관리 - subversion : subversion 을 통해 관리필수 배포시스템은 git을 통해 playbook 관리
SCM URLgit / subversion URL필수
SCM BRANCH/TAG/COMMIT특정 브랜치/태그를 이용해야 하는 경우 입력옵션 (공란인 경우 master / head)
GIT REFSPEC URLgit기반에서 원격 저장소 다운로드할 경로 참조시 입력옵션 (공란인경우 사용하지 않음)
SCM CREDENTIALgit / subversion 접근을 위한 계정정보필수 (인증정보에서 생성된 계정선택)
SCM UPDATE OPTIONS- CLEAN : 업데이트하기 전에 로컬 데이터 삭제 - DELETE ON UPDATE : 업데이트를 수행하기 전에 로컬저장소 전체 삭제 - UPDATE REVISION ON LAUNCH : 작업시작전에 업데이트 수행 - ALLOW BRANCH OVERRIDE : branch 변경이 필요할때 사용선택 선택 선택 선택안함
CACHE TIMEOUT (SECONDS)프로젝트를 최신상태로 인지하는 시간(초단위), 타임마아웃을 초과한 경우 프로젝트 소스를 다시 업데이트 함옵션 (0인 경우 사용안함)
### 인벤토리
1. 작업을 위한 호스트 모음 (RESOURCES → Inventories) 2. 인벤토리 생성 방법 ([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-3mz7ffac.png)](http://igoni.kr/uploads/images/gallery/2022-09/RWOimage.png) 버튼 선택) 1. 인벤토리 생성 입력화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-2sporp3x.png)](http://igoni.kr/uploads/images/gallery/2022-09/hcSimage.png) 2. 항목별 상세설명
**항 목****설 명****비 고**
NAME 인벤토리 이름필수
DESCRIPTION 인벤토리 설명옵션
ORGANIZATION 소속 조직필수
INSIGHTS CREDENTIALredhat Insights 계정선택옵션 (redhat Insightst사용시 선택)
Instance Group인벤토리의 인스턴스 그룹옵션 (사용하지 않음)
3. 인벤토리 추가 설정 1. 권한 설정 방법 ([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-v4i8jnqp.png)](http://igoni.kr/uploads/images/gallery/2022-09/RWOimage.png) 버튼 선택) 2. 권한설정 입력화면 : 추가할 계정명 선택 후 설정할 권한 정보 선택 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-brexusuq.png)](http://igoni.kr/uploads/images/gallery/2022-09/F00image.png) 3. 정책별 상세 설명
**항 목****설 명**
Admin모든 권한 부여
UpdateSCM업데이트시 프로젝트 업데이트 가능
Ad Hoc임시 명령 사용가능
Use템플릿에서 해당 인벤토리 접근 가능
Read읽기전용
1. 호스트 추가방법 ([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-dhhtnlsd.png)](http://igoni.kr/uploads/images/gallery/2022-09/RWOimage.png) 버튼 선택) 2. 호스트 추가 입력화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-r6qxjzlj.png)](http://igoni.kr/uploads/images/gallery/2022-09/e9Simage.png) 3. 항목별 상세설명
**항 목****설 명****비 고**
HOSTNAME타켓호스트 IP입력(호스트네임 입력 무방)필수 (호스트네임 입력시 ip와 매핑할 수 있는 정보 필요)
DESCRIPTION타켓호스트 설명옵션
VARIABLESssh포트, 접속 방법 등 해당 호스트의 추가 설정값 입력옵션 (기본은 ssh, tcp/22로 접근수행)
4. PERMISSIONS : 접근계정 권한설정 5. GROUPS : 각 호스트에 소속된 그룹정보 입력 1. 그룹추가 방법 ([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-8sic7cvk.png)](http://igoni.kr/uploads/images/gallery/2022-09/RWOimage.png) 버튼 선택) 2. 그룹추가 입력화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-pxif5xpt.png)](http://igoni.kr/uploads/images/gallery/2022-09/Aqmimage.png) 3. 항목별 상세설명
**항 목****설 명****비 고**
NAME그룹이름필수
DESCRIPTION그룹설명옵션
VALIABLES이 그룹에 소속된 모든 호스트에 적용할 값 입력(yaml / json 지원 가능)옵션
4. 생성된 그룹에 하위 그룹 생성 방법 (생성된 그룹 → GROUPS, [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-thrrzv93.png)](http://igoni.kr/uploads/images/gallery/2022-09/RWOimage.png) 버튼 선택) 1. 기존에 생성된 그룹의 경우 Existing Group 선택) 2. 하위그룹으로 관리할 그룹 명 선택 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-dgddcjeq.png)](http://igoni.kr/uploads/images/gallery/2022-09/nIlimage.png) 3. 새로운 그룹인 경우 New Group 선택 후 그룹정보 입력 5. 생성된 그룹에 소속시킬 호스트 등록 (생성된 그룹 → HOSTS) 1. 기존에 생성된 호스트의 경우 Existing HOSTS 선택) 2. 소속된 호스트 선택 6. 새로운 호스트의 경우 New HOSTS 선택 후 호스트정보 입력 6. HOTS : 해당 인벤토리에 등록할 호스트정보 등록 1. 호스트 추가방법 ([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-kiqjxuio.png)](http://igoni.kr/uploads/images/gallery/2022-09/RWOimage.png) 버튼 선택) 2. 호스트 추가 입력화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-eby6gvww.png)](http://igoni.kr/uploads/images/gallery/2022-09/GTrimage.png) 3. 항목별 상세설명
항 목설 명비 고
HOSTNAME타켓호스트 IP입력(호스트네임 입력 무방)필수 (호스트네임 입력시 ip와 매핑할 수 있는 정보 필요)
DESCRIPTION타켓호스트 설명옵션
VARIABLESssh포트, 접속 방법 등 해당 호스트의 추가 설정값 입력옵션 (기본은 ssh, tcp/22로 접근수행)
4. 4. 다수서버 등록시 방법 1. 인벤토리 신규 생성 2. AWX Task Container 로그인 ``` $> docker exec -i -t awx_task /bin/bash ``` 3. Inventory에 등록한 호스트파일 작성 ```bash $> vi add_list.txt [node] 1.2.3.4 5.6.7.8 [master] 10.20.30.40 50.60.70.80 [DB] 11.22.33.44 55.66.77.88 ``` 4. 작성한 호스트파일로 awx inventory 등록 ```bash bash-4.4# awx-manage inventory_import --inventory-name {{ 인벤토리명 }} --source list --force 2.703 INFO Updating inventory 15: {{ 인벤토리명 }} 3.443 INFO Reading Ansible inventory source: /var/lib/awx/list 3.446 INFO Using VIRTUAL_ENV: /var/lib/awx/venv/ansible 3.446 INFO Using PATH: /var/lib/awx/venv/ansible/bin:/usr/pgsql-10/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin: /bin 3.446 INFO Using PYTHONPATH: /var/lib/awx/venv/ansible/lib/python3.6/site-packages: 4.056 INFO Processing JSON output... 4.057 INFO Loaded 33 groups, 15 hosts 2020-07-17 02:12:40,663 DEBUG awx.main.models.inventory Going to update inventory computed fields, pk=15 2020-07-17 02:12:40,680 DEBUG awx.main.models.inventory Finished updating inventory computed fields, pk=15, in 0.014 seconds 4.305 INFO Inventory import completed for ({{ 인벤토리명 }} - 49) in 1.6s ```
### 템플릿
1. 실제 배포작업을 실행하기 위해 생성 (RESOURCES → Templates) 2. 기본 템플릿 생성방법([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-2kcpkvvz.png)](http://igoni.kr/uploads/images/gallery/2022-09/RWOimage.png) 버튼 선택 → Job Template 선택) 1. 템플릿 생성 입력화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-fby8mjda.png)](http://igoni.kr/uploads/images/gallery/2022-09/PoEimage.png) 2. 항목별 상세설명 PROMPT ON LAUNCH : 플레이북 실행시 선택창 출력
**항 목****설 명****비 고**
NAME템플릿 이름필수
DESCRIPTION템플릿 설명옵션
JOB TYPE- run : 실제 배포 수행 - check: 구문 오류테스트필수 (run 선택)
INVENTORY 템플릿에서 적용할 인벤토리 설정필수
PROJECT 템플릿에서 적용할 프로젝트 설정필수
PLAYBOOK템플릿에서 수행할 플레이북 선택필수
CREDENTIALS 템플릿에서 적용할 인증값 설정옵션
FORKS 플레이북 실행시 동시 프로세스옵션 (1 입력)
LIMIT 호스트 목록 제한시 입력옵션
VERBOSITY 로그 출력 레벨 (숫자가 높을수록 상세로그)0 선택 \* 디버깅 로그시 브라우저 탭이 잠기면서 작업완료 지연 보고 이슈 있음
JOB TAGS배포 작업별 설정되는 태그 입력템플릿별 고유의 태그 입력 필요
SKIP TAGS작업을 수행하지 않을 태그 입력옵션
LABELS템플릿을 설명하는 레이블 입력옵션
INSTANCE GROUPS템플릿을 실행할 인스턴스 그룹 선택옵션
JOB SLICING작업 슬라이스(다중 호스트 작업시 작업수를 분산) 설정옵션
TIMEOUT배포작업 최대 소요시간옵션 2400 입력
SHOW CHANGES작업시 변경되는 내용들 확인활성화
OPTIONS- ENABLE PRIVILEGE ESCALATION : 권한 상승이필요한 경우 선택 - ENABLE PROVISIONING CALLBACKS : awx api를 통해 작업 호출 허용시 선택 - ENABLE WEBHOOK : 웹 후크 사용시 선택 - ENABLE CONCURRENT JOBS : 템플릿 자체의 중복실행 허용시 선택 - ENABLE FACT CACHE : 배포 작업시 팩트 캐쉬를 사용할 경우 선택선택 미선택 미선택 선택 미선택
EXTRA VARIABLES추가로 설정해야할 변수 입력상기 이미지 내용 추가
3. WorkFlow 템플릿 생성방법([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-ps29wzm9.png)](http://igoni.kr/uploads/images/gallery/2022-09/RWOimage.png) 버튼 선택 → Workflow Template 선택) 1. 탬플릿 생성 입력화면 2. [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-hmjqsfeh.png)](http://igoni.kr/uploads/images/gallery/2022-09/Ngximage.png) 3. 항목별 상세 설명
**항 목****설 명****비 고**
NAME템플릿 이름필수
DESCRIPTION템플릿 설명옵션
ORGANIZATION템플릿 조직옵션
INVENTORY 템플릿에서 적용할 인벤토리 설정필수
LIMIT 호스트 목록 제한시 입력옵션
SCM BRANCH특정 branch / tag에서 가지고 와와야할 경우 입력옵션
LABELS템플릿을 설명하는 레이블 입력옵션
OPTIONS- ENABLE CONCURRENT JOBS : 템플릿 자체의 중복실행 허용시 선택 - ENABLE WEBHOOK : 웹 후크 사용시 선택선택 미선택
4. 템플릿 설정 1. PERMISSION (Templates → Permission , [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-swmopequ.png)](http://igoni.kr/uploads/images/gallery/2022-09/RWOimage.png) 버튼 선택) 1. 템플릿 접근권한 설정 방법 2. 접근할 계정 선택 3. 권한설정 입력 화면 4. [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-bgucivhe.png)](http://igoni.kr/uploads/images/gallery/2022-09/drzimage.png) 5. 권한별 상세 설명
**권 한****설 명**
Admin전체 권한
Execute실행/수정 권한
Read읽기모드 권한 (실행 불가)
2. NOTIFICATIONS 1. 템플릿 알람 수신 방법설정 (Templates → NOTIFICATION) 2. 생성된 notification 방식에 따라 알람 수신여부 설정 3. notification 설정 화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-aebywykp.png)](http://igoni.kr/uploads/images/gallery/2022-09/Bmqimage.png) 4. 항목별 상세 설명
**항목****설 명****비 고**
START템플릿 실행시 알람 전송[![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-jfmfk6hh.png)](http://igoni.kr/uploads/images/gallery/2022-09/PUAimage.png) : 활성화 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-28uwhncr.png)](http://igoni.kr/uploads/images/gallery/2022-09/mKyimage.png) : 비활성화
SUCCESS템플릿이 정상 종료된 경우 전송[![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-7rq0ever.png)](http://igoni.kr/uploads/images/gallery/2022-09/PUAimage.png) : 활성화 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-syoaefre.png)](http://igoni.kr/uploads/images/gallery/2022-09/mKyimage.png) : 비활성화
FAILURE템플릿이 실패한 경우 전송[![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-ycxeyr4r.png)](http://igoni.kr/uploads/images/gallery/2022-09/PUAimage.png) : 활성화 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-ycmyt6xg.png)](http://igoni.kr/uploads/images/gallery/2022-09/mKyimage.png) : 비활성화
3. COMPLETED JOBS 1. 해당 템플릿으로 수행한 작업이력 확인 (Templates → COMPLETED JOBS) 4. SCHEDULES 1. 해당 템플릿을 스케쥴로 수행할 때 선택 2. 스케쥴 생성 방법 (Templates → SCHEDULES, [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-mphkpu8e.png)](http://igoni.kr/uploads/images/gallery/2022-09/RWOimage.png) 버튼 선택) 3. 스케쥴 설정 화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-tbrwcts4.png)](http://igoni.kr/uploads/images/gallery/2022-09/ARkimage.png) 4. 항목별 상세 설명
**항 목****설 명****비 고**
NAME스케쥴 이름필수
START DATE시작 날짜필수
START TIME시작 시간필수
LOCAL TIME ZONE지역 시간대0OS에 설정된 시간대역에 맞추어 자동 표시, 수정 가능
REPEAT FREQUENCY반복 빈도 - none : 1회성 - Minute : 분단위 반복 - Hour : 시간단위 반복 - Day : 일 단위 반복 - Week : 주 단위 반복 - Month : 월 단위 반복 - Year : 년 단위 반복필수
Every반복 주기 설정반복설정시 화면에 노출 (필수)
END종료조건 - after : OCCURRENCES 횟수까지 실행 후 종료 - On Date : 특정날짜/시간 까지 실행 후 종료필수
5. EDIT SURVEY 1. 배포 작업시 추가 변수 전달이 필요한 경우 작성 (Templates → ADD SURVEY) 2. 서베이 설정화면 3. [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-ffldbxmw.png)](http://igoni.kr/uploads/images/gallery/2022-09/4lximage.png) 4. 항목별 세부설명
**항 목****설 명****비 고**
PROMPT사용자에 확인할 질문사항필수
DESCRIPTIONprompt에 대한 추가 설명옵션
ANSWER VARIABLE NAMEansible에 전달할 변수 이름필수
ANSWER TYPE답변 유형 선택 - text - textarea - Password - Multiple Choice (single Select) - Multiple Choice (Multiple Select) - integer - Float 일반 문자열 (1줄) 여러줄의 문자열 패스워드 형태 입력시 선택 1개만 선택할 수 있는 리스트 목록 여러개 선택할 수 있는 리스트 목록 숫자값 10진수
MININUM LENGTH최소 문자열text, textarea, password, integer, float 선택시 보임
MAXIMUM LENGTH최대 문자열text, textarea, password, integer, float 선택시 보임
DEFAULT ANSWER기본 항목prompt에 대한 기본값
REQUIRED필수여부선택시 배포작업시 필수항목으로 분류됨
5. 서베이 변경 1. 항목 수정시 : [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-wujspots.png)](http://igoni.kr/uploads/images/gallery/2022-09/vc3image.png) 아이콘 선택 후 항목 변경 후 SAVE 선택 2. 항목 삭제시 : [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-j7qki8fr.png)](http://igoni.kr/uploads/images/gallery/2022-09/Z88image.png) 아이콘 선택 후 삭제 후 SAVE 선택 3. 서베이 자체 삭제시 : DELETE SURVEY 선택 6. WORKFLOW VISUALIZER 1. 템플릿 유형이 workflow인 경우에만 출력하며, WebUI기반에서 생성 (Templates → WORKFLOW VISUALIZER) 2. Workflow 생성 화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-11dioskf.png)](http://igoni.kr/uploads/images/gallery/2022-09/pSTimage.png) 3. Add a NODE 세부 항목
**항 목****설 명****비 고**
Template생성된 템플릿 추가시
Project Sync프로젝트 동기화 시
Inventory Sync인벤토리 동기화 시
Approval작업건 승인여부 확인시webui noti항목에 출력됨
TIMEOUT승인여부 타임아웃 (타임아웃 초과시 거부됨)옵션, 0인 경우 무제한
RUN- Always : 성공 / 실패에 상관없이 계속 실행 - On Success : 앞 작업이 정상적으로 수행된 경우 실행 - On Failure : 앞 작업이 실패된 경우 실행필수, 최초 Node는 Alway만 표기됨
CONVERGENCE- Any : 앞 작업이 하나라도 완료되면 수행 - All : 앞 작업이 모두 완료되면 수행필수, Any가 기본
4. WorkFlow 생성 1. [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-rvugaqvu.png)](http://igoni.kr/uploads/images/gallery/2022-09/en9image.png) : 작업 생성 2. [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-glitzhmu.png)](http://igoni.kr/uploads/images/gallery/2022-09/VZJimage.png) : 기존 FLow(link) 수정 3. [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-kxjevv6i.png)](http://igoni.kr/uploads/images/gallery/2022-09/Ufmimage.png) : 현재 작업 삭제 5. Approval 화면 1. WEBUI 우측 상단 아이콘에 Approval 기능 제공 2. Approval 선택 화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-zjitzmhn.png)](http://igoni.kr/uploads/images/gallery/2022-09/3uMimage.png) 5. Template을 이용한 배포작업 수행 1. 배포수행하려는 템플릿의 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-30runtae.png)](http://igoni.kr/uploads/images/gallery/2022-09/07Gimage.png)아이콘 선택 2. Template별 생성된 서베이에 맞추어 선택후 마지막 PREVIEW 항목 확인 후 Launch 선택 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-gzlhnck2.png)](http://igoni.kr/uploads/images/gallery/2022-09/YC1image.png) 3. 작업결과 확인 (정상종료인 경우 좌측 상단에 STATUS에 Successful )표기 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-zdgpmtxl.png)](http://igoni.kr/uploads/images/gallery/2022-09/Aoximage.png) 4. 오류가 발생하는 경우 : 동일 위치에 FAILED로 표기, FAILED 발생 원인 분석 필요 5. [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-hc2aq1cd.png)](http://igoni.kr/uploads/images/gallery/2022-09/ITximage.png)
### 자격증명 관리 기존에 생성된 인증절차방식 외에 추가할경우 사용 (SSH / winrm / aws 등 대부분 내장된 기능으로 사용가능)
1. 인증정책 관리 (ADMINISTRATION → CREDENTIAL TYPES) 2. 인증절차 생성([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-t2jslu2u.png)](http://igoni.kr/uploads/images/gallery/2022-09/RWOimage.png) 버튼 선택) 1. 인증절차 사용자 입력화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-q741twgv.png)](http://igoni.kr/uploads/images/gallery/2022-09/TkVimage.png) 2. 항목별 상세 설명
**항 목****값 설명****비 고**
NAME자격증명 이름필수
DESCRIPTION자격증명 설명옵션
INPUT CONFIGURATION인증시 사용할 필드 구성옵션
INJECTION CONFIGURATION인증시 전달할 환경변수 구성옵션
### 알람관리 AWX에서 수행하는 Template에 대한 알람수신 방법 관리
1. 알람 정책 관리 (ADMINISTRATION → NOTIFICATION TEMPLATES) 2. 알람방법 생성([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-e0cwmfpl.png)](http://igoni.kr/uploads/images/gallery/2022-09/RWOimage.png) 버튼 선택) 1. 알람정책 사용자 입력화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-beskptyu.png)](http://igoni.kr/uploads/images/gallery/2022-09/y0pimage.png) 2. 항목별 상세 설명
**항 목****값 설명****비 고**
NAME알람정책 이름필수
DESCRIPTION정책 설명옵션
ORGANIZAION소속 조직필수
TYPE설정가능한 알람리스트 - Email - Grafana - HipChat - IRC - Mattermost - PagerDuty - Rocket.Chat - Slack - Twilio - Webhook필수
CUSTOMIZE MESSAGES메세지 발송시 작성되는 내용 변경시 선택 후 수정옵션
3. 알람설정 1. 이메일 설정 1. 이메일 정책 사용자 입력화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-8nybkkro.png)](http://igoni.kr/uploads/images/gallery/2022-09/W4Timage.png) 2. 항목별 상세설명
**항 목****설 명****비 고**
USERNAME발송계정 이름옵션
PASSWORD발송계정 패스워드옵션
HOST발송서버필수
RECIPIENT LIST수신자필수
SENDER EMAIL발송메일주소필수
PORT메일발송 포트필수
TIMEOUT발송최대 시간(초기준)필수, 최대 120초까지 설정 가능
EMAIL OPTIONSUSE TLS / USE SSL옵션TLS 나 SSL 사용시 선택
2. 그라파나 설정 1. 그라파나 정책 사용자 입력화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-vkd7tw9q.png)](http://igoni.kr/uploads/images/gallery/2022-09/XRGimage.png) 2. 항목별 상세설명
**항 목****설 명****비 고**
GRAFANA URL그라파나 api서비스 url필수
GRAFANA API KEY그라파나에서 할당받은 api key필수
ID OF THE DASHBOARD그라파나 계정에 대해 api키 만들때 고유한 ID로 대쉬보드 설정옵션
ID OF THE PANEL그라파나에서 패널/그래프를 추가한 경우 해당 ID옵션
TAGS FOR THE ANNOTATION이벤트 유형을 기재옵션
DISABLE SSL VERIFICATION그라파나 접속시 SSL 인증서 확인절차 제외 여부옵션
3. 힙챗 1. 힙챗 정책 사용자 입력화면 ㅂ 2. 항목별 상세설명
### 관리작업 Cleanup 작업 관리 (ADMINISTRATION → MANAGEMENT JOBS)
1. Cleanup Activity Stream (활동내역 삭제) 1. 수동 실행 ([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-hj9oxgdn.png)](http://igoni.kr/uploads/images/gallery/2022-09/o2Oimage.png)) 선택, 기본값은 별도 스케쥴링 없음[![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-3l3tuikk.png)](http://igoni.kr/uploads/images/gallery/2022-09/rooimage.png) 2. 보관기간 입력 후 LAUNCH 선택 3. 스케쥴 등록 ([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-hxne1mhl.png)](http://igoni.kr/uploads/images/gallery/2022-09/Rjaimage.png))선택, 기본값은 별도 스케쥴링 없음 필요한 스케쥴 등록 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-rm1pauja.png)](http://igoni.kr/uploads/images/gallery/2022-09/KO6image.png) 2. Cleanup Expired OAuth 2 Tokens (만료된 2차 토큰정보 삭제) 1. 수동 실행 ([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-j4bqgiiv.png)](http://igoni.kr/uploads/images/gallery/2022-09/yaXimage.png)) 2. 스케쥴 등록 ([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-aormnzhy.png)](http://igoni.kr/uploads/images/gallery/2022-09/Mjrimage.png))선택, 기본값은 별도 스케쥴링 없음 필요한 스케쥴 등록 3. Cleanup Expired Sessions (만료된 인증정보 삭제) 1. 수동 실행 ([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-tyvvrkxa.png)](http://igoni.kr/uploads/images/gallery/2022-09/yaXimage.png)) 2. 스케쥴 등록 ([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-vi2zaac5.png)](http://igoni.kr/uploads/images/gallery/2022-09/Mjrimage.png))선택, 기본값은 별도 스케쥴링 없음 필요한 스케쥴 등록 4. Cleanup Job Details (작업 내역 삭제) 1. 수동 실행 ([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-41s7s6dy.png)](http://igoni.kr/uploads/images/gallery/2022-09/yaXimage.png)) 보관기간 입력 후 LAUNCH 선택 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-cb8rwtwh.png)](http://igoni.kr/uploads/images/gallery/2022-09/Gmcimage.png) 2. 스케쥴 등록 ([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-i0vkz9bw.png)](http://igoni.kr/uploads/images/gallery/2022-09/Mjrimage.png))선택, 필요한 스케쥴 등록 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-iat2lzi6.png)](http://igoni.kr/uploads/images/gallery/2022-09/6WPimage.png)
### 인스턴스 그룹 인스턴스별 동작방식 및 작업 실행 방식 설정
1. 인스턴스 그룹 관리 (ADMINISTRATION → INSTANCE GROUPS) 2. 인스턴스 그룹 생성([![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-8jr9e3zc.png)](http://igoni.kr/uploads/images/gallery/2022-09/mrFimage.png) 버튼 선택 → CREATE INSTANCE GROUP) 1. 사용자 입력 화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-ymupjrjt.png)](http://igoni.kr/uploads/images/gallery/2022-09/xymimage.png) 2. 항목별 세부설명
**항 목****값 설명****비 고**
NAME인스턴스명필수
POLICY INSTANCE MINIMUM그룹내에 유지할 최소 인스턴스 수기본값 : 0
POLICY INSTANCE PERCENTAGE신규 인스턴스가 소속될 있는 최대 가용가능한 인스턴스 수 (백분율)기본값 : 0 (무제한)
3. INSTANCES 설정화면 (다수의 AWX-UI 관리시 사용) [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-w5tz9kao.png)](http://igoni.kr/uploads/images/gallery/2022-09/wugimage.png) 1. 최대로 사용햘 Forks 갯수 설정 4. JOBS 1. 해당 인스턴스에 수행한 Job정보 확인
### AWX-UI 설정 UI기능 설정
1. Authentication 1. Azure / github / Google / LDAP / RADIUS 계정을 통해 로그인시 사용 2. Jobs 1. Ad hoc 을 사용할 수 있는 모듈 구성, 예약 작업 수 설정 가능 2. 설정 화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-ao0vuxsw.png)](http://igoni.kr/uploads/images/gallery/2022-09/LC3image.png) 3. 항목별 상세설명
**항 목****값 설명****비 고**
ANSIBLE MODULES ALLOWED FOR AD HOC JOBS임시작업으로 사용할 수 있는 명령어 종류
JOB EXECUTION PATH작업수행을 위한 임시 경로/tmp
MAXIMUM SCHEDULED JOBS최대 예약작업 갯수10
PATHS TO EXPOSE TO ISOLATED JOBS격리된 작업시 허용되는 경로 (전체 경로 정보 입력필요격리 작업 미사용
PATHS TO HIDE FROM ISOLATED JOBS격리된 작업시 숨길 경로 (전체 경로 정보 입력필요격리 작업 미사용
ENABLE JOB ISOLATION작업 격리기능 사용여부미설정
DEFAULT JOB TIMEOUT최대 작업 시간 (초단위)0(무제한)
DEFAULT INVENTORY UPDATE TIMEOUT최대 인벤토리 업데이트 시간 (초단위)0(무제한)
RUN PROJECT UPDATES WITH HIGHER VERBOSITY프로젝트 업데이트 실행시 자세한 정보 출력미설정
PER-HOST ANSIBLE FACT CACHE TIMEOUT호스트 단위로 팩트캐쉬 시간 (초단위)0(무제한)
PRIMARY GALAXY SERVER URL기본 ANSIBLE-GALAXY URL 변경시 사용galaxy.ansible.com
PRIMARY GALAXY SERVER NAMEprivate galaxy 접근시 사용하는 계정PRIVATE GALAXY 미사용
PRIMARY GALAXY SERVER PASSWORDprivate galaxy 접근시 사용하는 계정 패스워드PRIVATE GALAXY 미사용
PRIMARY GALAXY SERVER TOKENprivate galaxy 접근시 사용하는 토큰정보PRIVATE GALAXY 미사용
PRIMARY GALAXY AUTHENTICATION URLprivate galaxy 접근시 사용하는 인증경로PRIVATE GALAXY 미사용
ALLOW ACCESS TO PUBLIC GALAXY공개된 Galaxy사용여부활성화
ISOLATED HOST KEY CHECKING격리된 호스트 키 확인여부비활성화 격리 작업 미사용
ISOLATED STATUS CHECK INTERVAL격리정보 확인 (초단위)30
ISOLATED LAUNCH TIMEOUT최대 격리된 작업 실행 시간 (초단위)600 격리 작업 미사용
ISOLATED CONNECTION TIMEOUT최대 격리호스트 연결시간 (초단위)10 격리 작업 미사용
ENABLE DETAILED RESOURCE PROFILING ON ALL PLAYBOOK RUNS플래이북 실행시 리소스 프로파일링 설정여부비활성화
EXTRA ENVIRONMENTVARIABLESAWX-UI에서 사용할 추가 환경 변수
ANSIBLE CALLBACK PLUGINSansible에서 사용할 콜백용 플러그인
3. system 1. AWX-UI의 기본URL, URL및 기본 가시정보 설정 2. 설정화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-eylawwtd.png)](http://igoni.kr/uploads/images/gallery/2022-09/iqlimage.png) 3. 항목별 상세설명
**항 목****값 설명****비 고**
BASE URL OF THE TOWER HOSTAWX-UI URL정보
ALL USER VISIBLE TO ORGANIZATION ADMINS관리자가 모든 사용자 확인 가능 여부활성화
ORGANIZATION ADMINS CAN MANAGE USERS AND TEAMS관리자가 사용자 및 팀 관리 허용 여부활성화
IDLE TIME FORCE LOG OUT유휴세션 강제 로그아웃 (초단위)1800
MAXIMUM NUMBER OF SIMULTANEOUS LOGGED IN SESSIONS최대 동시 로그인 세션수-1 (비활성화)
ENABLE HTTP BASIC AUTHHTTP 인증기능 허용여부활성화
ALLOW EXTERNAL USERS TO CREATE OAUTH2 TOKENS외부사용자가 OATUTH2 토큰 생성 허용여부비활성화
LOGIN REDIRECT OVERRIDE URL미로그인 사용자가 로그인 하도록 리다이렉션 URL공란인 경우 기본 로그인 페이지
ACCESS TOKEN EXPIRATION엑세스 토큰 유효기간 (초단위)31536000000
REFRESH TOKEN EXPIRATION토큰 만료시 지속시간 (초단위)2628000
AUTHORIZATION CODE EXPIRATION로그인시 생서되는 인증코드 유효기간 (초단위)600
REMOTE HOST HEADER원격 호스트 IP / 호스트이름 추가기본값 : REMOTE\_ADDR, REMOTE\_HOST 리버스 프록시ip가 있는 경우 HTTP\_X\_FORWARDED\_FOR 추가
CUSTOM VIRTUAL ENVIRONMENT PATHS가상의 환경값 설정 경로비활성화
GATHER DATA FOR AUTOMATION ANAYTICSAWX-UI에서 수집된 데이터를 Redhat으로 전달비활성화
RED HAT CUSTOMER USERNAMEredhat 고객 IDRedhat과 별도 계약시 사용가능
RED HAT CUSTOMER PASSWORDredhat 고객 passwordRedhat과 별도 계약시 사용가능
AUTOMATION ANALYTICS UPLOAD URL자동화 분석을 위한 업로드 URL자동화 분석 미사용
AUTOMATION ANALYTICS GATHER INTERVAL자동화 분석을 위한 수집간격자동화 분석 미사용
4. User Interface 1. API-UI 기능 설정 2. 설정 화면 [![image.png](http://igoni.kr/uploads/images/gallery/2024-01/embedded-image-yc7o0rnr.png)](http://igoni.kr/uploads/images/gallery/2022-09/AtKimage.png) 3. 항목별 상세설명
**항 목****설 명****비 고**
USER ANALYTICS TRACKING STATE사용자 분석 추적기능 활성화미사용
CUSTOM LOGO사용자 로그인시 노출될 이미지필요시 이미지 추가
CUSTOM LOGIN INFO로그인시 추가 텍스트 입력필요시 입력