운영 Ansible Automation Platform

프로세스

1. 탐색 패널에서 Settings → Automation Execution → System 을 선택합니다.

2. 프록시 IP 허용 목록 필드에 다음 예의 구문을 사용하여 자동화 컨트롤러에 연결할 수 있는 IP 주소를 입력합니다.

   프록시 IP 허용 목록 항목 예

   [
     "example1.proxy.com:8080",
     "example2.proxy.com:8080"
   ]

   Copy to Clipboard Toggle word wrap

   중요
   • 프록시 IP 허용 목록에 있는 프록시는 헤더 입력을 적절히 제거하고 X-Forwarded-For 값을 클라이언트의 실제 소스 IP와 올바르게 설정합니다. 자동화 컨트롤러는 프록시 IP 허용 목록 의 IP 주소 및 호스트 이름을 사용하여 X-Forwarded- for에 스푸핑되지 않은 값을 제공할 수 있습니다.

   • 다음 조건을 모두 충족하지 않는 한 HTTP_X_FORWARDED_FOR 을 원격 호스트 헤더 의 항목으로 구성하지 마십시오.

     • ssl 종료가 있는 프록시된 환경을 사용하고 있습니다.
     • 프록시는 클라이언트 스푸핑을 방지하기 위해 X-Forwarded-For 헤더의 종료 또는 검증을 제공합니다.
     • /etc/tower/conf.d/remote_host_headers.py 는 신뢰할 수 있는 프록시 또는 로드 밸런서의 원래 IP 주소만 포함하는 PROXY_IP_ALLOWED_LIST 를 정의합니다.
3. 저장을 클릭하여 설정을 저장합니다.

프로세스

1. 자동화 컨트롤러 노드에서 다음 단계를 수행합니다. ansible-builder가 아직 설치되지 않은 경우 먼저 설치합니다.

   # subscription-manager repos --enable ansible-automation-platform-2.5-for-rhel-8-x86_64-rpms
   # dnf install ansible-builder

   Copy to Clipboard Toggle word wrap

2. 사용자 정의 실행 환경을 빌드합니다.

   1. 먼저 작업 디렉터리를 생성합니다.

      # su - awx
      $ mkdir -p builder/newee
      $ cd builder/newee

      Copy to Clipboard Toggle word wrap

3. 다음 콘텐츠를 사용하여 execution-environment.yml 파일을 생성합니다.

   version: 1
   
   build_arg_defaults:
     EE_BASE_IMAGE: 'registry.redhat.io/ansible-automation-platform-24/ee-supported-rhel8:latest'
   
   additional_build_steps:
     prepend:
       - RUN microdnf install -y nc

   Copy to Clipboard Toggle word wrap

4. registry.redhat.io에 로그인합니다.

   $ podman login registry.redhat.io

   Copy to Clipboard Toggle word wrap

5. ansible-builder를 실행하여 빌드 프로세스를 시작합니다.

   $ cd /var/lib/awx/builder/newee/
   $ ansible-builder build -t my-env -v 3

   Copy to Clipboard Toggle word wrap
6. 생성한 사용자 정의 실행 환경을 추가합니다.
7. 탐색 패널에서 자동화 실행 인프라 실행환경을 선택합니다.
8. 실행 환경 생성을 클릭합니다.
9. 이미지 필드에 localhost/my-env:latest 를 추가합니다.
10. 실행 환경 생성을 클릭합니다.

11. Ansible Automation Platform 설치 프로그램을 프로젝트 동기화로 사용할 사용자 지정 환경에서 실행 환경을 기본값에서 교체하는 다음 단계로 다시 실행합니다.

    참고

    설치 프로그램을 실행하기 전에 Ansible Automation Platform을 백업합니다.

    # ./setup.sh -b

    Copy to Clipboard Toggle word wrap

12. setup.sh 파일과 동일한 위치에 있는 group_vars 디렉터리에 자동화 컨트롤러 파일을 생성합니다. 파일 내용은 다음과 같습니다.

    control_plane_execution_environment: localhost/my-env

    Copy to Clipboard Toggle word wrap

13. setup.sh실행

    # ./setup.sh

    Copy to Clipboard Toggle word wrap

14. 디렉터리에 ssh_config 를 만듭니다. 예를 들면 다음과 같습니다.

    Host github.com
    Hostname ssh.github.com
    ProxyCommand nc --proxy-type http --proxy proxy.example.com:port %h %p
    User git

    Copy to Clipboard Toggle word wrap
15. 컨테이너 실행 환경에서 ssh_config 파일을 읽을 수 있도록 PATH에 ssh_config 파일의 디렉터리 경로를 추가하여 격리된 작업을 노출합니다.
16. 탐색 패널에서 Settings → Automation Execution → Job 을 선택합니다.
17. 편집을 클릭합니다.

18. ssh_config 파일이 /var/lib/awx/.ssh/ssh_config 로 생성된 경우 격리된 작업에 노출할경로에 이 파일을 추가합니다.

    참고

    ssh_config 가 AWX 사용자가 소유하고 있는지 확인합니다. (#chown awx:awx /var/lib/awx/.ssh/ssh_config)

    [
    "/var/lib/awx/.ssh:/etc/ssh:O"
    ]

    Copy to Clipboard Toggle word wrap

프로세스

1. 자동화 컨트롤러에 로그인합니다.
2. 탐색 패널에서 Settings → Automation Execution → System 을 선택합니다.
3. Automation Analytics에 대한 데이터 수집을 선택하여 자동화 컨트롤러에서 자동화에 대한 데이터를 수집하여 Automation Analytics로 보낼 수 있습니다.

프로세스

1. 인증서 및 키를 준비하려면 다음 방법 중 하나를 선택합니다.

   • 사용자 정의 인증서 제공 - 업데이트된 TLS 인증서가 필요한 각 서비스에 대해 새 인증서와 키를 Ansible Automation Platform 설치 프로그램을 기준으로 경로에 복사합니다. 그런 다음 새 파일의 절대 경로로 인벤토리 파일 변수를 업데이트합니다.

     # Platform gateway
     gateway_tls_cert=<path_to_tls_certificate>
     gateway_tls_key=<path_to_tls_key>
     gateway_pg_tls_cert=<path_to_tls_certificate>
     gateway_pg_tls_key=<path_to_tls_key>
     gateway_redis_tls_cert=<path_to_tls_certificate>
     gateway_redis_tls_key=<path_to_tls_key>
     
     # Automation controller
     controller_tls_cert=<path_to_tls_certificate>
     controller_tls_key=<path_to_tls_key>
     controller_pg_tls_cert=<path_to_tls_certificate>
     controller_pg_tls_key=<path_to_tls_key>
     
     # Automation hub
     hub_tls_cert=<path_to_tls_certificate>
     hub_tls_key=<path_to_tls_key>
     hub_pg_tls_cert=<path_to_tls_certificate>
     hub_pg_tls_key=<path_to_tls_key>
     
     # Event-Driven Ansible
     eda_tls_cert=<path_to_tls_certificate>
     eda_tls_key=<path_to_tls_key>
     eda_pg_tls_cert=<path_to_tls_certificate>
     eda_pg_tls_key=<path_to_tls_key>
     eda_redis_tls_cert=<path_to_tls_certificate>
     eda_redis_tls_key=<path_to_tls_key>
     
     # PostgreSQL
     postgresql_tls_cert=<path_to_tls_certificate>
     postgresql_tls_key=<path_to_tls_key>
     
     # Receptor
     receptor_tls_cert=<path_to_tls_certificate>
     receptor_tls_key=<path_to_tls_key>

     Copy to Clipboard Toggle word wrap

   • 새 인증서를 생성하려면 설치 프로그램에서 서비스에 대한 새 인증서를 생성하거나 기존 인증서 및 키를 삭제하거나 이동합니다.

     Expand

     표 6.1. 서비스당 인증서 및 키 파일 경로

     서비스	인증서 파일 경로	키 파일 경로
     자동화 컨트롤러	~/AAP/controller/etc/tower.cert	~/AAP/controller/etc/tower.key
     이벤트 기반 Ansible	~/aap/eda/etc/eda.cert	~/aap/eda/etc/eda.key
     플랫폼 게이트웨이	~/aap/gateway/etc/gateway.cert	~/aap/gateway/etc/gateway.key
     자동화 허브	~/AAP/hub/etc/pulp.cert	~/AAP/hub/etc/pulp.key
     PostgreSQL	~/aap/postgresql/server.crt	~/aap/postgresql/server.key
     수신기	~/AAP/receptor/etc/receptor.crt	~/AAP/receptor/etc/receptor.key
     Redis	~/AAP/redis/server.crt	~/AAP/redis/server.key

     Show more

2. 인증서를 준비한 후 설치 디렉터리에서 설치 플레이북을 실행합니다.

   ansible-playbook -i <inventory_file_name> ansible.containerized_installer.install

   Copy to Clipboard Toggle word wrap

프로세스

1. 서명된 SSL 인증서 및 키를 보안 위치에 복사합니다.

2. OpenShift 내에 TLS 시크릿을 생성합니다.

   oc create secret tls ${CONTROLLER_INSTANCE}-certs-$(date +%F) --cert=/path/to/ssl.crt --key=/path/to/ssl.key

   Copy to Clipboard Toggle word wrap

3. 자동화 컨트롤러 사용자 정의 리소스를 수정하여 route_tls_secret 및 새 시크릿 이름을 spec 섹션에 추가합니다.

   oc edit automationcontroller/${CONTROLLER_INSTANCE}

   Copy to Clipboard Toggle word wrap

   ...
   spec:
     route_tls_secret: automation-controller-certs-2023-04-06
   ...

   Copy to Clipboard Toggle word wrap

1. 변경 사항을 적용할 때까지 몇 분 정도 기다립니다.

2. 새 SSL 인증서 및 키가 설치되었는지 확인합니다.

   true | openssl s_client -showcerts -connect ${CONTROLLER_FQDN}:443

   Copy to Clipboard Toggle word wrap

프로세스

1. 서명된 SSL 인증서 및 키를 보안 위치에 복사합니다.

2. OpenShift 내에 TLS 시크릿을 생성합니다.

   oc create secret tls ${AUTOMATION_HUB_INSTANCE}-certs-$(date +%F) --cert=/path/to/ssl.crt --key=/path/to/ssl.key

   Copy to Clipboard Toggle word wrap

3. 자동화 허브 사용자 정의 리소스를 수정하여 route_tls_secret 및 새 시크릿 이름을 spec 섹션에 추가합니다.

   oc edit automationhub/${AUTOMATION_HUB_INSTANCE}

   Copy to Clipboard Toggle word wrap

   ...
   spec:
     route_tls_secret: automation-hub-certs-2023-04-06
   ...

   Copy to Clipboard Toggle word wrap

1. 변경 사항을 적용할 때까지 몇 분 정도 기다립니다.

2. 새 SSL 인증서 및 키가 설치되었는지 확인합니다.

   true | openssl s_client -showcerts -connect ${CONTROLLER_FQDN}:443

   Copy to Clipboard Toggle word wrap

프로세스

1. [all:vars] 섹션의 인벤토리 파일에 aap_service_regen_cert=true 를 추가합니다.

   [all:vars]
   aap_service_regen_cert=true

   Copy to Clipboard Toggle word wrap
2. 설치 프로그램을 실행합니다.

프로세스

1. 새 SSL/TLS 인증서 및 키를 Ansible Automation Platform 설치 프로그램 관련 경로에 복사합니다.

2. SSL/TLS 인증서 및 키의 절대 경로를 인벤토리 파일에 추가합니다. 이러한 변수 설정에 대한 지침은 인벤토리 파일 변수를 참조하십시오.

   • 이벤트 기반 Ansible 컨트롤러: automationedacontroller_ssl_cert,automationedacontroller_ssl_key,custom_ca_cert
   • 플랫폼 게이트웨이: automationgateway_ssl_cert,automationgateway_ssl_key,custom_ca_cert
   • 자동화 허브: automationhub_ssl_cert,automationhub_ssl_key,custom_ca_cert

   • 자동화 컨트롤러: web_server_ssl_cert,web_server_ssl_key,custom_ca_cert

     참고

     custom_ca_cert 는 중간 인증 기관에 서명한 루트 인증 기관이어야 합니다. 이 파일은 /etc/pki/ca-trust/source/anchors 에 설치됩니다.

3. 설치 프로그램을 실행합니다.

프로세스

1. 현재 SSL/TLS 인증서를 백업합니다.

   cp <CERT_PATH> <CERT_PATH>-$(date +%F)

   Copy to Clipboard Toggle word wrap

2. 현재 키 파일을 백업합니다.

   cp <KEY_PATH> <KEY_PATH>-$(date +%F)

   Copy to Clipboard Toggle word wrap
3. 새 SSL/TLS 인증서를 인증서 경로에 복사합니다.
4. 새 키를 키 경로에 복사합니다.

5. SELinux 컨텍스트를 복원합니다.

   restorecon -v <CERT_PATH> <KEY_PATH>

   Copy to Clipboard Toggle word wrap

6. 인증서 및 키 파일에 대한 적절한 권한을 설정합니다.

   chown <OWNER>:<GROUP> <CERT_PATH> <KEY_PATH>
   chmod 0600 <CERT_PATH> <KEY_PATH>

   Copy to Clipboard Toggle word wrap

7. NGINX 구성을 테스트합니다.

   nginx -t

   Copy to Clipboard Toggle word wrap

8. NGINX를 다시 로드합니다.

   systemctl reload nginx.service

   Copy to Clipboard Toggle word wrap

9. 새 SSL/TLS 인증서 및 키가 설치되었는지 확인합니다.

   true | openssl s_client -showcerts -connect <COMPONENT_FQDN>:443

   Copy to Clipboard Toggle word wrap
   Expand

   표 6.2. SSL/TLS 인증서 및 서비스당 키 파일 경로

   서비스	인증서 파일 경로	키 파일 경로	소유자:Group
   자동화 컨트롤러	/etc/tower/tower.cert	/etc/tower/tower.key	root:awx
   자동화 허브	/etc/pulp/certs/pulp_webserver.crt	/etc/pulp/certs/pulp_webserver.key	root:pulp
   이벤트 기반 Ansible 컨트롤러	/etc/ansible-automation-platform/eda/server.cert	/etc/ansible-automation-platform/eda/server.key	root:eda
   플랫폼 게이트웨이	/etc/ansible-automation-platform/gateway/gateway.cert	/etc/ansible-automation-platform/gateway/gateway.key	root:gateway

   Show more