17. 인벤토리¶

17.1.1. 스마트 호스트 필터¶

검색 필터를 사용하여 인벤토리의 호스트를 채울 수 있습니다. 이 기능은 사실 검색 기능을 활용한 것입니다.

작업 템플릿을 실행하는 동안 Ansible 플레이북에서 생성한 사실은 작업별 템플릿에 use_fact_cache=True``를 설정할 때마다 |at|에서 데이터베이스에 저장합니다. 새 사실은 기존 사실과 병합되고 호스트별로 제공됩니다. 이렇게 저장된 사실은 ``GET 쿼리 매개변수 host_filter``를 사용하여 ``/api/v2/hosts 끝점을 통해 호스트를 필터링하는 데 사용할 수 있습니다. 예를 들면 ``/api/v2/hosts?host_filter=ansible_facts__ansible_processor_vcpus=8``입니다.

host_filter 매개변수를 사용하면 다음 작업이 가능합니다.

• ()을 통한 그룹화

• 부울 및 연산자 사용

  • __ 관계형 필드에서 관련 필드 참조

  • __ JSON 키 경로에서 키를 분리하기 위해 ansible_facts에 사용

  • [] 경로 사양에서 json 배열을 표시하는 데 사용

  • "" 값에 공백이 필요한 경우 값에 사용 가능

• ``host_filter``에 《classic》 Django 쿼리가 포함될 수 있음

예:

/api/v2/hosts/?host_filter=name=localhost
/api/v2/hosts/?host_filter=ansible_facts__ansible_date_time__weekday_number="3"
/api/v2/hosts/?host_filter=ansible_facts__ansible_processor[]="GenuineIntel"
/api/v2/hosts/?host_filter=ansible_facts__ansible_lo__ipv6[]__scope="host"
/api/v2/hosts/?host_filter=ansible_facts__ansible_processor_vcpus=8
/api/v2/hosts/?host_filter=ansible_facts__ansible_env__PYTHONUNBUFFERED="true"
/api/v2/hosts/?host_filter=(name=localhost or name=database) and (groups__name=east or groups__name="west coast") and ansible_facts__an

호스트 이름, 그룹 이름, Ansible 사실로 ``host_filter``를 검색할 수 있습니다.

그룹 검색 형식은 다음과 같습니다.

groups.name:groupA

사실 검색 형식은 다음과 같습니다.

ansible_facts.ansible_fips:false

호스트 이름과 호스트 설명으로 구성된 스마트 검색을 수행할 수도 있습니다.

host_filter=name=my_host

host_filter``의 검색어가 문자열 유형인 경우 숫자(예: ``2.66) 또는 JSON 키워드(예: null, true 또는 false) 값을 유효하게 만들려면 컨트롤러에서 실수로 문자열이 아닌 값으로 구문 분석하지 않도록 값을 큰따옴표로 묶습니다.

host_filter=ansible_facts__packages__dnsmasq[]__version="2.66"

17.1.2. ansible_facts를 사용하여 호스트 필터 정의¶

스마트 인벤토리를 생성할 때 호스트 필터를 정의하는 데 ``ansible_facts``를 사용하려면 다음 단계를 수행합니다.

1. 새 스마트 인벤토리 만들기 화면*에서 **Smart 호스트 필터* 필드 옆에 있는 버튼을 클릭하여 이 인벤토리의 호스트를 필터링하는 팝업 창을 엽니다.

2. 검색 팝업 창에서 검색 기준을 이름 에서 고급**으로 변경하고 **키 필드에서 **ansible_facts**를 선택합니다.

ansible 팩트를 추가하려면 다음을 수행합니다.

/api/v2/hosts/?host_filter=ansible_facts__ansible_processor[]="GenuineIntel"

검색 필드에 ansible_processor[]="GenuineIntel" (값 앞에 추가 공백 또는 __ 없음)을 입력하고 [Enter] 를 누릅니다.

지정된 ansible 팩트에 대한 결과 검색 기준이 창의 아래 부분에 채워집니다.

3. 선택**을 클릭하여 **Smart 호스트 필터 필드에 추가합니다.

4. 저장 을 클릭하여 새 스마트 인벤토리를 저장합니다.

새 스마트 인벤토리의 세부 정보 탭이 열리고 Smart 호스트 필터 필드에 지정된 ansible 팩트가 표시됩니다.

5. 세부 정보 보기에서 편집**을 클릭하고 기존 필터를 지우거나 기존 필터를 지우거나 새 필터를 추가하여 **Smart 호스트 필터 필드를 편집할 수 있습니다.

17.3.1. 권한 추가¶

1. 액세스 탭에서 추가 버튼을 클릭합니다.

2. 추가할 사용자 또는 팀을 선택하고 **다음**을 클릭합니다.

3. 이름 옆에 있는 체크박스를 클릭하여 목록에서 하나 이상의 사용자 또는 팀을 선택하여 멤버로 추가하고 **다음**을 클릭합니다.

이 예에서는 두 명의 사용자를 추가하도록 선택했습니다.

4. 선택한 사용자 또는 팀에 부여할 역할을 선택합니다. 전체 역할 목록을 보려면 아래로 스크롤하십시오. 리소스에 따라 다양한 옵션을 사용할 수 있습니다.

5. 저장 버튼을 클릭하여 선택한 사용자 또는 팀에 역할을 적용하고 멤버로 추가합니다.

사용자/팀 추가 창이 닫히고 각 사용자 및 팀에 할당된 역할이 업데이트되어 표시됩니다.

특정 사용자의 역할을 제거하려면 리소스 옆에 있는 연결 해제(x) 버튼을 클릭합니다.

그러면 연결을 해제할지 묻는 확인 대화 상자가 열립니다.

17.3.2. 그룹 추가¶

인벤토리는 호스트 및 기타 그룹이 포함될 수 있는 그룹과 호스트로 나뉩니다. 그룹은 표준 인벤토리에만 적용할 수 있으며 스마트 인벤토리를 통해 직접 구성할 수 없습니다. 표준 인벤토리와 함께 사용되는 호스트를 통해 기존 그룹을 연결할 수 있습니다. 표준 인벤토리에는 다음과 같은 몇 가지 작업을 수행할 수 있습니다.

• 새 그룹 생성

• 새 호스트 생성

• 선택한 인벤토리에서 명령 실행

• 인벤토리 속성 편집

• 그룹 및 호스트에 대한 활동 스트림 보기

• 인벤토리 빌드에 대한 도움 받기

인벤토리에 대한 새 그룹을 생성하려면 다음을 수행합니다.

1. 추가 버튼을 클릭하여 그룹 생성 창을 엽니다.

2. 필수 및 선택 필드에 적절한 세부 정보를 입력합니다.

• 이름: (필수)

• 설명: 임의의 설명을 적절하게 입력합니다(선택 사항).

• 변수: 이 그룹의 모든 호스트에 적용할 정의 및 값을 입력합니다. JSON 또는 YAML 구문을 사용하여 변수를 입력합니다. 둘 사이를 전환하려면 라디오 버튼을 사용합니다.

3. 완료되면 **저장**을 클릭합니다.

17.3.2.2. 인벤토리 그룹 보기 또는 편집¶

목록 보기는 모든 인벤토리 그룹을 한 번에 표시하거나 루트 그룹만 표시하도록 필터링할 수 있습니다. 다른 그룹의 하위 집합이 아닌 인벤토리 그룹은 루트 그룹으로 간주됩니다.

컨트롤러에서 하위 그룹 또는 호스트와 같은 종속 항목을 찾기 때문에 종속 항목에 대한 걱정 없이 하위 그룹을 삭제할 수도 있습니다. 이러한 항목이 존재하는 경우 루트 그룹과 해당 하위 그룹 그리고 호스트를 모두 삭제할지 또는 하위 그룹이 해당 호스트와 함께 최상위 인벤토리 그룹이 되도록 하위 그룹을 승격할지 선택할 수 있는 확인 대화 상자가 표시됩니다.

17.3.3. 호스트 추가¶

인벤토리뿐만 아니라 그룹 및 그룹 내의 그룹에 대한 호스트를 구성할 수 있습니다. 호스트를 구성하려면 다음을 수행합니다.

1. 호스트 탭을 클릭합니다.

2. 추가 버튼을 클릭하고 구성에 이미 존재하는 호스트를 추가할지 아니면 새 호스트를 생성할지 선택합니다.

3. 새 호스트를 생성하는 경우 버튼을 선택하여 작업을 실행하는 동안 이 호스트를 포함할지의 여부를 지정합니다.

4. 필수 및 선택 필드에 적절한 세부 정보를 입력합니다.

• 호스트 이름: 필수

• 설명: 임의의 설명을 적절하게 입력합니다(선택 사항).

• 변수: 이 그룹의 모든 호스트에 적용할 정의 및 값을 입력합니다. JSON 또는 YAML 구문을 사용하여 변수를 입력합니다. 둘 사이를 전환하려면 라디오 버튼을 사용합니다.

5. 완료되면 **저장**을 클릭합니다.

호스트 생성 창이 닫히고 새로 생성된 호스트가 생성된 해당 그룹과 연결된 호스트 목록에 항목으로 표시됩니다.

기존 호스트를 추가하도록 선택하면 사용 가능한 호스트가 별도의 선택 창에 표시됩니다.

호스트를 선택하면 해당 그룹과 연결된 호스트 목록에 항목으로 표시됩니다. 호스트를 선택하고 연결 해제 버튼을 클릭하여 이 화면에서 호스트를 연결 해제할 수 있습니다.

6. To configure additional groups for the host, click on the name of the host from the list of hosts.

그러면 선택한 호스트의 세부 정보 탭이 열립니다.

7. 그룹 탭을 클릭하여 호스트에 대한 그룹을 구성합니다.

1. 추가 버튼을 클릭하여 호스트를 기존 그룹과 연결합니다.

사용 가능한 그룹이 별도의 선택 창에 나타납니다.

2. 호스트와 연결할 그룹을 선택하려면 클릭하고 **저장**을 클릭합니다.

그룹을 연결하면 해당 호스트와 연결된 그룹 목록에 항목으로 표시됩니다.

8. 호스트가 작업을 실행하는 데 사용된 경우 호스트의 완료된 작업 탭에서 해당 작업에 대한 세부 정보를 보고 **펼치기**를 클릭하여 각 작업에 대한 세부 정보를 볼 수 있습니다.

17.3.4. 소스 추가¶

인벤토리 소스는 그룹과 연결되어 있지 않습니다. 생성된 그룹은 최상위 수준이고 여전히 하위 그룹이 있을 수 있으며, 생성된 이 모든 그룹에 호스트가 있을 수 있습니다. 인벤토리에 소스를 추가하는 작업은 표준 인벤토리에만 적용됩니다. 스마트 인벤토리는 연결된 표준 인벤토리에서 소스를 상속합니다. 인벤토리 소스를 구성하려면 다음을 수행합니다.

1. 소스를 추가하려는 인벤토리에서 소스 탭을 클릭합니다.

2. 추가 버튼을 클릭합니다.

그러면 소스 생성 창이 열립니다.

3. 필수 및 선택 필드에 적절한 세부 정보를 입력합니다.

• 이름: (필수)

• 설명: 임의의 설명을 적절하게 입력합니다(선택 사항).

• 실행 환경: 필요한 경우 인벤토리 가져오기를 실행할 실행 환경의 이름을 검색()하거나 입력합니다. 실행 환경 빌드에 대한 자세한 내용은 Execution Environments 섹션을 참조하십시오.

• 소스: 인벤토리의 소스를 선택합니다. 각 소스에 대한 자세한 내용과 적절한 정보를 입력하는 방법에 대한 세부 사항은 인벤토리 소스 섹션을 참조하십시오.

4. 선택한 :ref:`inventory source <ug_inventory_sources>`에 대한 필수 정보를 작성한 후에는 필요에 따라 상세 정보 표시, 호스트 필터, 변수와 같은 기타 일반 매개변수를 지정할 수 있습니다.

참고

지역, 인스턴스 필터, 그룹별로만 필드는 automation controller 3.8에서 제거되었습니다.

5. 상세 정보 표시 드롭다운 메뉴에서 모든 인벤토리 소스 업데이트 작업에 대한 적절한 출력 수준을 선택합니다.

6. 호스트 필터 필드를 사용하여 컨트롤러로 가져올 일치하는 호스트 이름만 지정합니다.

7. **활성화된 변수**에서 컨트롤러가 지정된 호스트 변수 사전에서 활성화됨 상태를 검색하도록 지정합니다. 활성화된 변수는 〈foo.bar’처럼 점 표기법을 사용하여 지정할 수 있습니다. 이 경우 조회는 ``from_dict.get(〈foo〉, {}).get(〈bar〉, default)``와 같이 중첩된 dict로 이동합니다.

8. 활성화된 변수 필드에서 호스트 변수 사전을 지정한 경우 가져오기에 사용할 값을 제공할 수 있습니다. 예를 들어 enabled_var='status.power_state' 및 ``enabled_value=〉powered_on〉``의 호스트 변수가 다음과 같은 경우 호스트가 활성화됨으로 표시됩니다.

{
"status": {
"power_state": "powered_on",
"created": "2020-08-04T18:13:04+00:00",
"healthy": true
},
"name": "foobar",
"ip_address": "192.168.2.1"
}

``power_state``의 값이 ``powered_on``이 아니면 컨트롤러로 가져올 때 호스트가 비활성화됩니다. 키가 없으면 호스트가 활성화됩니다.

9. 모든 클라우드 인벤토리 소스에는 다음과 같은 업데이트 옵션이 있습니다.

• 덮어쓰기: 선택 시 외부 소스에 이전에 존재했지만 현재는 제거된 모든 호스트와 그룹이 컨트롤러 인벤토리에서 제거됩니다. 인벤토리 소스에서 관리하지 않은 호스트 및 그룹은 수동으로 생성한 다음 그룹으로 승격되거나 승격할 수동으로 생성한 그룹이 없는 경우 인벤토리의 《전체》 기본 그룹에 남게 됩니다.

선택 해제하면 외부 소스에서 찾을 수 없는 로컬 하위 호스트 및 그룹은 인벤토리 업데이트 프로세스에 의해 변경되지 않은 상태로 유지됩니다.

• 변수 덮어쓰기: 이 옵션을 선택하면 하위 그룹 및 호스트의 모든 변수가 제거되고 외부 소스에 있는 변수로 교체됩니다. 선택하지 않으면 병합이 수행되어 로컬 변수와 외부 소스에 있는 변수를 병합합니다.

• 시작 시 업데이트: 이 인벤토리를 사용하여 작업을 실행할 때마다 작업을 실행하기 전에 선택한 소스에서 인벤토리를 새로 고칩니다. 인벤토리에서 동기화할 수 있는 것보다 작업이 더 빨리 생성되는 경우 작업 오버플로를 방지하기 위해 이 옵션을 선택하면 **캐시 제한 시간**을 구성하여 특정 시간 동안 이전 인벤토리 동기화를 캐시할 수 있습니다.

《시작 시 업데이트》 설정은 프로젝트와 인벤토리의 종속 시스템을 나타내며, 두 작업이 동시에 실행되는 것을 특별히 차단하지는 않습니다. 캐시 제한 시간을 지정하면 두 번째 작업의 종속 항목이 생성되고 첫 번째 작업에서 생성한 프로젝트와 인벤토리 업데이트를 사용합니다. 그런 다음 두 작업 모두 해당 프로젝트 및/또는 인벤토리 업데이트가 완료될 때까지 기다린 후 계속합니다. 서로 다른 작업 템플릿의 경우 시스템에 수행할 용량이 있으면 동시에 시작하여 실행할 수 있습니다. 동적 인벤토리 소스에 컨트롤러의 프로비저닝 콜백 기능을 사용하려면 인벤토리 그룹에 대해 《시작 시 업데이트》를 설정해야 합니다.

10. 항목 및 선택을 검토하고 완료되면 **저장**을 클릭합니다. 그러면 스케줄 및 알림과 같은 추가 세부 정보를 구성할 수 있습니다.

11. 이 인벤토리 소스와 관련된 스케줄을 구성하려면 스케줄 탭을 클릭합니다.

1. 스케줄이 이미 설정되어 있는 경우 스케줄 기본 설정을 검토, 편집 또는 활성화/비활성화합니다.

2. 스케줄이 설정되지 않은 경우 :ref:`ug_scheduling`에서 자세한 내용을 참조하십시오.

참고

알림 탭은 새로 생성된 소스를 저장한 후에만 표시됩니다.

12. 소스에 대한 알림을 구성하려면 알림 탭을 클릭합니다.

1. 알림이 이미 설정된 경우 토글을 사용하여 특정 소스에 사용할 알림을 활성화하거나 비활성화합니다. 자세한 내용은 :ref:`ug_notifications_on_off`를 참조하십시오.

2. 알림이 설정되지 않은 경우 자세한 내용은 :ref:`ug_notifications`을 참조하십시오.

13. 항목 및 선택을 검토하고 완료되면 **저장**을 클릭합니다.

소스를 정의하면 해당 인벤토리와 연결된 소스 목록에 항목으로 표시됩니다. 소스 탭에서는 단일 소스에서 동기화를 수행하거나 한 번에 모두 동기화할 수 있습니다. 동기화 프로세스 스케줄링이나 소스를 편집하고 삭제하는 등 추가 작업을 수행할 수 있습니다.

$ awx-manage export_custom_scripts --filename=my_scripts.tar
Dump of old custom inventory scripts at my_scripts.tar

$ mkdir my_scripts
$ tar -xf my_scripts.tar -C my_scripts

$ ls my_scripts
_10__inventory_script_rawhook             _19__                                       _30__inventory_script_listenhospital
_11__inventory_script_upperorder          _1__inventory_script_commercialinternet45   _4__inventory_script_whitestring
_12__inventory_script_eastplant           _22__inventory_script_pinexchange           _5__inventory_script_literaturepossession
_13__inventory_script_governmentculture   _23__inventory_script_brainluck             _6__inventory_script_opportunitytelephone
_14__inventory_script_bottomguess         _25__inventory_script_buyerleague           _7__inventory_script_letjury
_15__inventory_script_wallisland          _26__inventory_script_lifesport             _8__random_inventory_script_
_16__inventory_script_wallisland          _27__inventory_script_exchangesomewhere     _9__random_inventory_script_
_17__inventory_script_bidstory            _28__inventory_script_boxchild
_18__p                                    _29__inventory_script_wearstress

$ ./my_scripts/_11__inventory_script_upperorder
{"group_\ud801\udcb0\uc20e\u7b0e\ud81c\udfeb\ub12b\ub4d0\u9ac6\ud81e\udf07\u6ff9\uc17b": {"hosts":
["host_\ud821\udcad\u68b6\u7a51\u93b4\u69cf\uc3c2\ud81f\uddbe\ud820\udc92\u3143\u62c7",
"host_\u6057\u3985\u1f60\ufefb\u1b22\ubd2d\ua90c\ud81a\udc69\u1344\u9d15",
"host_\u78a0\ud820\udef3\u925e\u69da\ua549\ud80c\ude7e\ud81e\udc91\ud808\uddd1\u57d6\ud801\ude57",
"host_\ud83a\udc2d\ud7f7\ua18a\u779a\ud800\udf8b\u7903\ud820\udead\u4154\ud808\ude15\u9711",
"host_\u18a1\u9d6f\u08ac\u74c2\u54e2\u740e\u5f02\ud81d\uddee\ufbd6\u4506"], "vars": {"ansible_host": "127.0.0.1", "ansible_connection":
"local"}}}

$ ansible-inventory -i ./my_scripts/_11__inventory_script_upperorder --list --export

17.3.5. 완료된 작업 보기¶

인벤토리가 작업을 실행하는 데 사용된 경우 인벤토리의 완료된 작업 탭에서 해당 작업에 대한 세부 정보를 보고 **펼치기**를 클릭하여 각 작업에 대한 세부 정보를 볼 수 있습니다.