실행 환경 생성 및 사용

절차

1. 터미널에서 다음 명령을 실행하여 Ansible Automation Platform 리포지터리를 활성화합니다.

   #  dnf install --enablerepo=ansible-automation-platform-2.4-for-rhel-9-x86_64-rpms ansible-builder

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-minimal 컨테이너의 URL과 EE_BASE_IMAGE 필드에 태그를 지정합니다. 이렇게 하면 최종 execution-environment.yml 파일이 다음과 같이 표시됩니다.

   예 4.1. 사용자 정의된 execution-environment.yml 파일

   version: 3
   
   images:
     base_image: 'registry.redhat.io/ansible-automation-platform-24/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 명령을 사용하여 새 컨테이너 이미지가 해당 목록에 있는지 확인합니다.

     예 4.2. 이미지 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. registry.redhat.io 인증 정보를 사용하여 Podman에 로그인합니다.

   $ podman login registry.redhat.io

2. 사용자 이름과 암호를 입력합니다.

3. 컨테이너 이미지를 가져옵니다.

   $ podman pull registry.redhat.io/<container_image_name>:<tag>

1. 로컬 스토리지에 이미지를 나열합니다.

   $ podman images

2. 이미지 이름을 확인하고 태그가 올바른지 확인합니다.

검증

1. 로컬 스토리지에 이미지를 나열합니다.

   $ podman images

2. 최근 자동화 허브 정보에 태그된 이미지가 목록에 포함되어 있는지 확인합니다.

절차

1. 자동화 허브 위치 및 인증 정보를 사용하여 Podman에 로그인합니다.

   $ podman login -u=<username> -p=<password> <automation_hub_url>

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

   $ podman push <automation_hub_url>/<container_image_name>

검증

1. 자동화 허브에 로그인합니다.
2. 컨테이너 레지스트리로 이동합니다.
3. 컨테이너 리포지토리 목록에서 컨테이너를 찾습니다.

절차

1. 자동화 허브에 로그인합니다.
2. 탐색 패널에서 실행 환경 실행 환경을선택합니다.
3. 컨테이너 리포지토리를 선택합니다.
4. 자세한 정보 탭에서 추가 를 클릭합니다.
5. Raw Markdown 텍스트 필드에 Markdown에 README 텍스트를 입력합니다.
6. 완료되면 저장 을 클릭합니다.

절차

1. 자동화 허브에 로그인합니다.
2. 탐색 패널에서 실행 환경 실행 환경을선택합니다.
3. 컨테이너 리포지토리를 선택합니다.
4. 액세스 탭에서 그룹 선택을 클릭합니다.
5. 액세스 권한을 부여할 그룹 또는 그룹을 선택하고 다음을 클릭합니다.
6. 이 실행 환경에 추가할 역할을 선택하고 다음을 클릭합니다.
7. 추가 를 클릭합니다.

절차

1. 탐색 패널에서 실행 환경 실행 환경을선택합니다.
2. 컨테이너 리포지토리를 선택합니다.
3. 이미지 탭을 클릭합니다.
4. More Actions 아이콘 Cryostat 를 클릭하고 태그 관리를 클릭합니다.
5. 텍스트 필드에 새 태그를 추가하고 추가 를 클릭합니다.
6. 선택 사항: 해당 이미지에 대한 태그 중 x 를 클릭하여 현재 태그를 제거합니다.
7. 저장을 클릭합니다.

절차

1. 자동화 컨트롤러로 이동합니다.
2. 탐색 패널에서 리소스 자격증명을 선택합니다.
3. 추가 를 클릭하여 새 자격 증명을 생성합니다.
4. 권한 부여 이름, 설명, 조직을 입력합니다.
5. 자격 증명 유형을 선택합니다.
6. 인증 URL 을 입력합니다. 이는 컨테이너 레지스트리 주소입니다.
7. 컨테이너 레지스트리에 로그인하는 데 필요한 사용자 이름 및 암호 또는 토큰 을 입력합니다.
8. 선택 사항: SSL 확인을 활성화하려면 SSL 확인을 선택합니다.
9. 저장을 클릭합니다.

절차

1. 암호 또는 토큰 보호 레지스트리에서 컨테이너 이미지를 가져오는 경우 이미지를 가져오기 전에 자동화 컨트롤러에 인증 정보를 생성합니다.
2. 탐색 패널에서 실행 환경 실행 환경을선택합니다.
3. 컨테이너 리포지토리를 선택합니다.
4. Pull this image 항목에서 Copy to 클립보드 를 클릭합니다.
5. 터미널에서 명령을 붙여넣고 실행합니다.

절차

1. 탐색 패널에서 실행 환경 실행 환경을선택합니다.
2. 레지스트리에 https://registry.redhat.io 를 추가합니다.

3. 인증에 필요한 인증 정보를 추가합니다.

   참고

   일부 컨테이너 레지스트리는 속도 제한으로 공격적입니다. Advanced Options 에서 유량 제한을 설정합니다.

4. 탐색 패널에서 실행 환경 실행 환경을선택합니다.
5. 페이지 헤더에서 실행 환경 추가 를 클릭합니다.

6. 가져올 레지스트리를 선택합니다. 이름 필드에는 로컬 레지스트리에 표시되는 이미지의 이름이 표시됩니다.

   참고

   Upstream 이름 필드는 원격 서버의 이미지 이름입니다. 예를 들어 업스트림 이름이 "alpine"로 설정되고 Name 필드가 "local/alpine"인 경우 alpine 이미지가 원격에서 다운로드되고 "local/alpine"로 이름이 변경됩니다.

7. 포함하거나 제외할 태그 목록을 설정합니다. 많은 수의 태그와 이미지를 동기화하는 것은 시간이 많이 소요되며 많은 디스크 공간을 사용합니다.