실행 환경 생성 및 사용

프로세스

1. 사용자 정의 실행 환경 빌드 아티팩트를 저장할 디렉터리를 생성합니다. 다음 단계로 생성된 새 파일은 이 디렉터리에 생성됩니다.

   $ mkdir $HOME/custom-ee $HOME/custom-ee/files
   $ cd $HOME/custom-ee/

2. 사용자 정의 실행 환경에 대한 요구 사항을 정의하는 execution-environment.yml 파일을 생성합니다.

   참고

   실행 환경 정의 형식의 버전 3이 필요하므로 계속하기 전에 execution-environment.yml 파일에 버전 3 이 명시적으로 포함되어 있는지 확인합니다.

   1. 프라이빗 자동화 허브에서 사용할 수 있는 최소 실행 환경을 가리키도록 기본 이미지를 재정의합니다.
   2. 빌드 프로세스에서 사용할 연결이 끊긴 콘텐츠 소스를 가리키는 데 필요한 추가 빌드 파일을 정의합니다. 사용자 정의 execution-environment.yml 파일은 다음 예와 유사해야 합니다.

   version: 3
   
   images:
     base_image:
       name: private-hub.example.com/ee-minimal-rhel8:latest
   
   dependencies:
     python: requirements.txt
     galaxy: requirements.yml
   
   additional_build_files:
     - src: files/ansible.cfg
       dest: configs
     - src: files/pip.conf
       dest: configs
     - src: files/hub-ca.crt
       dest: configs
     # uncomment if custom RPM repositories are required
     #- src: files/custom.repo
     #  dest: configs
   
   additional_build_steps:
     prepend_base:
       # copy a custom pip.conf to override the location of the PyPI content
       - ADD _build/configs/pip.conf /etc/pip.conf
       # remove the default UBI repository definition
       - RUN rm -f /etc/yum.repos.d/ubi.repo
       # copy the hub CA certificate and update the trust store
       - ADD _build/configs/hub-ca.crt /etc/pki/ca-trust/source/anchors
       - RUN update-ca-trust
       # if needed, uncomment to add a custom RPM repository configuration
       #- ADD _build/configs/custom.repo /etc/yum.repos.d/custom.repo
   
     prepend_galaxy:
       - ADD _build/configs/ansible.cfg ~/.ansible.cfg
   
   ...

3. 개인 자동화 허브를 가리키는 files/ 하위 디렉터리에 ansible.cfg 파일을 생성합니다.

   $ cat files/ansible.cfg
   [galaxy]
   server_list = private_hub
   
   [galaxy_server.private_hub]
   url = /https://private-hub.example.com/api/galaxy/

4. 내부 PyPI 미러(웹 서버 또는 Nexus와 같은 항목)를 가리키는 files/ 하위 디렉터리에 pip.conf 파일을 생성합니다.

   $ cat files/pip.conf
   [global]
   index-url = https://<pypi_mirror_fqdn>/
   trusted-host = <pypi_mirror_fqdn>

5. 선택 사항: bindep.txt 파일을 사용하여 RPM을 사용자 지정 실행 환경을 추가하는 경우, 연결이 끊긴 Satellite 또는 RPM 리포지토리를 호스팅하는 다른 위치를 가리키는 files/ 하위 디렉터리에 custom.repo 파일을 만듭니다. 이 단계가 필요한 경우 custom.repo 파일에 해당하는 execution-environment.yml 파일의 단계 주석을 제거합니다.

   다음 예제는 UBI 리포지토리를 위한 것입니다. 다른 로컬 리포지토리도 이 파일에 추가할 수 있습니다. 웹 서버에 미러 콘텐츠가 있는 위치에 따라 URL 경로를 변경해야 할 수 있습니다.

   $ cat files/custom.repo
   [ubi-8-baseos]
   name = Red Hat Universal Base Image 8 (RPMs) - BaseOS
   baseurl = http://<ubi_mirror_fqdn>/repos/ubi-8-baseos
   enabled = 1
   gpgkey = file:///etc/pki/rpm-gpg/RPM-GPG-KEY-redhat-release
   gpgcheck = 1
   
   [ubi-8-appstream]
   name = Red Hat Universal Base Image 8 (RPMs) - AppStream
   baseurl = http://<ubi_mirror_fqdn>/repos/ubi-8-appstream
   enabled = 1
   gpgkey = file:///etc/pki/rpm-gpg/RPM-GPG-KEY-redhat-release
   gpgcheck = 1

6. 프라이빗 자동화 허브 웹 서버 인증서에 서명하는 데 사용되는 CA 인증서를 추가합니다. 프라이빗 자동화 허브에서 설치 프로그램에서 제공하는 자체 서명된 인증서를 사용하는 경우:

   1. 개인 자동화 허브에서 /etc/pulp/certs/pulp_webserver.crt 파일을 복사하여 이름을 hub-ca.crt 로 지정합니다.
   2. hub-ca.crt 파일을 files/ 하위 디렉터리에 추가합니다.

7. 프라이빗 자동화 허브에서 인증 기관에서 서명한 사용자 제공 인증서를 사용하는 경우:

   1. 해당 CA 인증서의 사본을 만들고 이름을 hub-ca.crt 로 지정합니다.
   2. hub-ca.crt 파일을 files/' 하위 디렉터리에 추가합니다.

8. 이전 단계를 완료하면 사용자 정의 실행 환경 이미지에 필요한 콘텐츠를 사용하여 python requirements.txt 및 ansible collection requirements.yml 파일을 생성합니다.

   참고

   필요한 컬렉션은 이미 프라이빗 자동화 허브에 업로드해야 합니다.

   다음 파일은 bindep.txt 및 files/custom.repo 가 선택인 custom-ee/ 디렉터리에 있어야 합니다.

프로세스

1. setup.sh가 포함된 디렉터리로 이동합니다.

2. 다음 명령을 실행하여 ./group_vars/automationcontroller 를 만듭니다.

   touch ./group_vars/automationcontroller

3. 다음 내용을 ./group_vars/automationcontroller 에 붙여넣습니다. 환경에 맞게 설정을 조정합니다.

   # Automation Hub Registry
   registry_username: 'your-automation-hub-user'
   registry_password: 'your-automation-hub-password'
   registry_url: 'automationhub.example.org'
   registry_verify_ssl: False
   
   ## Execution Environments
   control_plane_execution_environment: 'automationhub.example.org/ee-supported-rhel8:latest'
   
   global_job_execution_environments:
     - name: "Default execution environment"
       image: "automationhub.example.org/ee-supported-rhel8:latest"
     - name: "Minimal execution environment"
       image: "automationhub.example.org/ee-minimal-rhel8:latest"

   참고

   registry_username 및 registry_password 를 얻는 방법에 대한 자세한 내용은 registry_username 및 registry_password 설정을참조하십시오.

4. ./setup.sh 스크립트를 실행합니다.

   $ ./setup.sh

검증

1. 시스템 관리자 액세스 권한이 있는 사용자로 Ansible Automation Platform에 로그인합니다.
2. Automation Execution → Infrastructure → Execution Environments 로 이동합니다.
3. 이미지 열에서 실행 환경 이미지 위치가 < registry url>/ansible-automation-platform-<version>/<image name>:<tag>에서 < automation hub url>:<tag >:<tag > 의 기본값에서 변경되었는지 확인합니다.

1. 기본 빌드 단계에서 지정된 기본 이미지는 Python, pip,ansible-core, ansible-runner 를 포함하여 다른 빌드 단계에 필요한 구성 요소로 사용자 지정된 (선택 사항)입니다. 그런 다음 생성된 이미지를 검증하여 필요한 구성 요소를 사용할 수 있는지 확인합니다(기본 이미지에 이미 있을 수 있음). 생성된 사용자 지정 기본 이미지의 임시 복사본은 다른 모든 빌드 단계의 기반으로 사용됩니다.
2. Galaxy 빌드 단계에서 정의 파일에 지정된 컬렉션이 다운로드되어 최종 빌드 단계에서 나중에 설치할 수 있도록 저장됩니다. 컬렉션에서 선언한 Python 및 시스템 종속 항목은 나중에 분석을 위해 수집됩니다.
3. 빌더 빌드 단계에서 컬렉션에서 선언한 Python 종속성은 정의 파일에 나열된 항목과 병합됩니다. 이 최종 Python 종속 항목 세트는 Python용으로 다운로드 및 빌드되어 최종 빌드 단계에서 나중에 설치를 위해 저장됩니다.
4. 최종 빌드 단계에서 이전에 다운로드한 컬렉션은 컬렉션에 의해 종속성으로 선언되었거나 정의 파일에 나열된 시스템 패키지 및 이전에 빌드된 모든 Python 패키지와 함께 설치됩니다.

프로세스

1. Podman을 사용하여 registry.redhat.io 에 로그인합니다.

   $ podman login -u="[username]" -p="[token/hash]" registry.redhat.io

2. 필요한 자동화 실행 환경 기본 이미지를 가져올 수 있는지 확인합니다.

   podman pull registry.redhat.io/ansible-automation-platform-24/ee-minimal-rhel8:latest

3. 새 실행 환경 이미지에 추가할 필수 기본 이미지 및 추가 콘텐츠를 지정하도록 Ansible Builder 파일을 구성합니다.

   1. 예를 들어 Galaxy의 Kubernetes Core Collection 을 이미지에 추가하려면 Galaxy 항목을 사용합니다.

      collections:
        - kubernetes.core

   2. 정의 파일 및 해당 콘텐츠에 대한 자세한 내용은 정의 파일 콘텐츠 분석 섹션을 참조하십시오.

4. 실행 환경 정의 파일에서 EE_BASE_IMAGE 필드에 원래 ee-minimal 컨테이너의 URL 및 태그를 지정합니다. 이렇게 하면 최종 execution-environment.yml 파일이 다음과 유사합니다.

   예 5.1. 사용자 지정 execution-environment.yml 파일

   version: 3
   
   images:
     base_image: 'registry.redhat.io/ansible-automation-platform-25/ee-minimal-rhel9:latest'
   
   dependencies:
     galaxy:
       collections:
         - kubernetes.core

   참고

   이 예제에서는 자동화 허브의 인증된 컬렉션이 아닌 kubernetes.core 커뮤니티 버전을 사용하므로 정의 파일에서 ansible.cfg 파일을 생성하거나 참조를 참조할 필요가 없습니다.

5. 다음 명령을 사용하여 새 실행 환경 이미지를 빌드합니다.

   $ ansible-builder build -t [username]/new-ee

   여기서 [username] 은 사용자 이름을 지정하고 new-ee 는 새 컨테이너 이미지의 이름을 지정합니다.

   참고

   빌드 와 함께 -t 를 사용하지 않으면 ansible-execution-env 라는 이미지가 생성되어 로컬 컨테이너 레지스트리에 로드됩니다.

   • podman images 명령을 사용하여 새 컨테이너 이미지가 해당 목록에 있는지 확인합니다.

     다음은 new-ee 이미지와 함께 'podman images' 명령의 출력을 보여줍니다.

     REPOSITORY          TAG     IMAGE ID      CREATED        SIZE
     localhost/new-ee    latest  f5509587efbb  3 minutes ago  769 MB

6. 컬렉션이 설치되었는지 확인합니다.

   $ podman run [username]/new-ee ansible-doc -l kubernetes.core

7. 자동화 허브에서 사용할 이미지를 태그합니다.

   $ podman tag [username]/new-ee [automation-hub-IP-address]/[username]/new-ee

8. Podman을 사용하여 자동화 허브에 로그인합니다.

   참고

   컨테이너를 푸시하려면 자동화 허브에 대한 관리자 또는 적절한 컨테이너 리포지토리 권한이 있어야 합니다. 자세한 내용은 프라이빗 자동화 허브에서 컨테이너 관리를 참조하십시오.

   $ podman login -u="[username]" -p="[token/hash]" [automation-hub-IP-address]

9. 자동화 허브의 컨테이너 레지스트리로 이미지를 푸시합니다.

   $ podman push [automation-hub-IP-address]/[username]/new-ee

10. 새 이미지를 자동화 컨트롤러 인스턴스로 가져옵니다.

    1. 자동화 컨트롤러로 이동합니다.
    2. 탐색 패널에서 자동화 실행 인프라 실행환경을 선택합니다.
    3. 추가 를 클릭합니다.

    4. 적절한 정보를 입력한 다음 저장을 클릭하여 새 이미지를 가져옵니다.

       참고

       자동화 허브의 인스턴스가 암호 또는 토큰 보호인 경우 적절한 컨테이너 레지스트리 인증 정보가 설정되어 있는지 확인합니다.

1. 자동화 허브에서 사용할 수 있는 실행 환경 가져오기
2. 자동화 허브에서 사용할 태그 실행 환경
3. 프라이빗 자동화 허브로 실행 환경 푸시
4. 컨테이너 리포지토리 설정
5. 컨테이너 리포지토리에 README 추가
6. 자동화 실행 환경에 대한 액세스 제공
7. 태그 컨테이너 이미지
8. 인증 정보 생성
9. 컨테이너 리포지토리에서 이미지 가져오기
10. 이미지 가져오기
11. 컨테이너 리포지토리에서 이미지 동기화