7장. 컨테이너 이미지 사용자 정의

프로세스

1. containers-prepare-parameter.yaml 파일을 편집하고 ceph_images: false 매개변수를 추가합니다.

   다음은 매개 변수가 굵은 이 파일의 예입니다.

   parameter_defaults:
     ContainerImagePrepare:
     - tag_from_label: {version}-{release}
       set:
         name_prefix: rhosp17-openstack-
         name_suffix: ''
         tag: 17.1_20231214.1
         rhel_containers: false
         neutron_driver: ovn
         ceph_images: false
       push_destination: true

2. containers-prepare-parameter.yaml 파일을 저장합니다.

3. 오버클라우드 배포에서 사용할 새 컨테이너 이미지 파일을 생성합니다.

   sudo openstack tripleo container image prepare -e containers-prepare-parameter.yaml --output-env-file <new_container_images_file>

   • & lt;new_container_images_file& gt;을 새 매개변수가 포함된 출력 파일로 바꿉니다.
4. 새 컨테이너 이미지 파일을 오버클라우드 배포 환경 파일 목록에 추가합니다.

프로세스

1. 컨테이너 이미지에 설치할 RPM 패키지를 다운로드합니다.

2. containers-prepare-parameter.yaml 파일을 편집하여 컨테이너 이미지의 모든 패키지를 업데이트합니다.

   ContainerImagePrepare:
   - push_destination: true
     ...
     modify_role: tripleo-modify-image
     modify_append_tag: "-updated"
     modify_vars:
       tasks_from: yum_update.yml
       compare_host_packages: true
       yum_repos_dir_path: /etc/yum.repos.d
     ...

3. containers-prepare-parameter.yaml 파일을 저장합니다.
4. openstack overcloud deploy 명령을 실행할 때 containers-prepare-parameter.yaml 파일을 포함합니다.

절차

1. 다음 예제에서는 nova-compute 이미지에 대해 사용자 지정 Dockerfile을 실행합니다.

   ContainerImagePrepare:
   - push_destination: true
     ...
     includes:
     - nova-compute
     modify_role: tripleo-modify-image
     modify_append_tag: "-hotfix"
     modify_vars:
       tasks_from: modify_image.yml
       modify_dir_path: /home/stack/nova-custom
     ...

2. /home/stack/nova-custom/Dockerfile 파일의 예는 다음과 같습니다. USER root 지시문을 실행한 후에는 원본 이미지의 기본 사용자로 다시 전환해야 합니다.

   FROM registry.redhat.io/rhosp-rhel9/openstack-nova-compute:latest
   
   USER "root"
   
   COPY customize.sh /tmp/
   RUN /tmp/customize.sh
   
   USER "nova"

절차

1. 모든 컨테이너 이미지 목록을 생성합니다.

   $ sudo podman search --limit 1000 "registry.redhat.io/rhosp-rhel9" --format="{{ .Name }}" | grep "rhosp-rhel9/" | sort > satellite_images
   $ sudo podman search --limit 1000 "registry.redhat.io/rhceph" | grep <ceph_dashboard_image_file>
   $ sudo podman search --limit 1000 "registry.redhat.io/rhceph" | grep <ceph_image_file>
   $ sudo podman search --limit 1000 "registry.redhat.io/openshift4" | grep ose-prometheus

   • & lt;ceph_dashboard_image_file >을 배포에서 사용하는 Red Hat Ceph Storage 버전의 이미지 파일로 바꿉니다.

     • Red Hat Ceph Storage 5: rhceph-5-dashboard-rhel8
     • Red Hat Ceph Storage 6: rhceph-6-dashboard-rhel9

   • & lt;ceph_image_file >을 배포에서 사용하는 Red Hat Ceph Storage 버전의 이미지 파일로 바꿉니다.

     • Red Hat Ceph Storage 5: rhceph-5-rhel8

     • Red Hat Ceph Storage 6: rhceph-6-rhel9

       참고

       openstack-ovn-bgp-agent 이미지는 registry.redhat.io/rhosp-rhel9/openstack-ovn-bgp-agent-rhel9:17.1 에 있습니다.

   • Ceph를 설치하고 Ceph 대시보드를 활성화하려면 다음 ose-prometheus 컨테이너가 필요합니다.

     registry.redhat.io/openshift4/ose-prometheus-node-exporter:v4.12
     registry.redhat.io/openshift4/ose-prometheus:v4.12
     registry.redhat.io/openshift4/ose-prometheus-alertmanager:v4.12

2. satellite_images_names 파일을 Satellite 6 hammer 툴이 포함된 시스템으로 복사합니다. 또는 Hammer CLI 가이드의 지침에 따라 hammer 툴을 언더클라우드에 설치합니다.

3. 다음 hammer 명령을 실행하여 Satellite 조직에 새 제품(OSP Containers)을 생성합니다.

   $ hammer product create \
     --organization "ACME" \
     --name "OSP Containers"

   이 사용자 지정 제품에 이미지를 저장합니다.

4. satellite_images 파일에서 오버클라우드 컨테이너 이미지를 추가합니다.

   $ while read IMAGE; do \
     IMAGE_NAME=$(echo $IMAGE | cut -d"/" -f3 | sed "s/openstack-//g") ; \
     IMAGE_NOURL=$(echo $IMAGE | sed "s/registry.redhat.io\///g") ; \
     hammer repository create \
     --organization "ACME" \
     --product "OSP Containers" \
     --content-type docker \
     --url https://registry.redhat.io \
     --docker-upstream-name $IMAGE_NOURL \
     --upstream-username USERNAME \
     --upstream-password PASSWORD \
     --name $IMAGE_NAME ; done < satellite_images

5. Ceph Storage 컨테이너 이미지를 추가합니다.

   $ hammer repository create \
     --organization "ACME" \
     --product "OSP Containers" \
     --content-type docker \
     --url https://registry.redhat.io \
     --docker-upstream-name rhceph/<ceph_image_name> \
     --upstream-username USERNAME \
     --upstream-password PASSWORD \
     --name <ceph_image_name>

   • & lt;ceph_image_file >을 배포에서 사용하는 Red Hat Ceph Storage 버전의 이미지 파일로 바꿉니다.

     • Red Hat Ceph Storage 5: rhceph-5-rhel8

     • Red Hat Ceph Storage 6: rhceph-6-rhel9

       참고

       Ceph 대시보드를 설치하려면 hammer repository create 명령에 --name <ceph_dashboard_image_name >을 포함합니다.

       $ hammer repository create \
         --organization "ACME" \
         --product "OSP Containers" \
         --content-type docker \
         --url https://registry.redhat.io \
         --docker-upstream-name rhceph/<ceph_dashboard_image_name> \
         --upstream-username USERNAME \
         --upstream-password PASSWORD \
         --name <ceph_dashboard_image_name>

       • & lt;ceph_dashboard_image_file >을 배포에서 사용하는 Red Hat Ceph Storage 버전의 이미지 파일로 바꿉니다.

         • Red Hat Ceph Storage 5: rhceph-5-dashboard-rhel8
         • Red Hat Ceph Storage 6: rhceph-6-dashboard-rhel9

6. 컨테이너 이미지를 동기화합니다.

   $ hammer product synchronize \
     --organization "ACME" \
     --name "OSP Containers"

   Satellite 서버가 동기화를 완료할 때까지 기다립니다.

   참고

   설정에 따라 hammer에서 Satellite 서버 사용자 이름과 암호가 필요할 수 있습니다. hammer를 구성한 후 구성 파일을 사용하여 자동으로 로그인할 수 있습니다. 자세한 내용은 Hammer CLI Guide의 "Authentication" 섹션을 참조하십시오.

7. Satellite 6 서버에서 콘텐츠 뷰를 사용하는 경우, 새로운 콘텐츠 뷰 버전을 생성하여 이미지를 통합하고 애플리케이션 라이프사이클의 환경에 따라 승격합니다. 이 과정은 대체로 애플리케이션 라이프사이클을 구조화한 방법에 따라 달라집니다. 예를 들어 라이프사이클에 production이라는 환경이 있고 해당 환경에서 컨테이너 이미지를 사용할 수 있도록 하려면 컨테이너 이미지가 포함된 콘텐츠 뷰를 생성하고 해당 콘텐츠 뷰를 production 환경으로 승격합니다. 자세한 내용은 Managing Content Views를 참조하십시오.

8. base 이미지에 사용 가능한 태그를 확인합니다.

   $ hammer docker tag list --repository "base" \
     --organization "ACME" \
     --lifecycle-environment "production" \
     --product "OSP Containers"

   이 명령을 수행하면 OpenStack Platform 컨테이너 이미지의 태그가 특정 환경의 콘텐츠 뷰에 표시됩니다.

9. 언더클라우드로 돌아가서 Satellite 서버를 소스로 사용하여 이미지를 준비하는 기본 환경 파일을 생성합니다. 다음 예제 명령을 실행하여 환경 파일을 생성합니다.

   $ sudo openstack tripleo container image prepare default \
     --output-env-file containers-prepare-parameter.yaml

   • --output-env-file은 환경 파일 이름입니다. 이 파일의 콘텐츠에는 언더클라우드의 컨테이너 이미지를 준비하는 데 필요한 매개변수가 포함되어 있습니다. 이 경우 파일 이름은 containers-prepare-parameter.yaml입니다.

10. containers-prepare-parameter.yaml 파일을 편집하여 다음 매개변수를 수정합니다.

    • push_destination - 선택한 컨테이너 이미지 관리 전략에 따라 이 값을 true 또는 false로 설정합니다. 이 매개변수를 false로 설정하면 오버클라우드 노드는 Satellite에서 직접 이미지를 가져옵니다. 이 매개변수를 true로 설정하면 director가 Satellite에서 언더클라우드 레지스트리로 이미지를 가져오고 오버클라우드는 언더클라우드 레지스트리에서 이미지를 가져옵니다.
    • namespace - Satellite 서버에 있는 레지스트리의 URL입니다.

    • name_prefix - 접두사는 Satellite 6 규칙을 기반으로 하며, 콘텐츠 뷰 사용 여부에 따라 달라집니다.

      • 콘텐츠 뷰를 사용하는 경우 구조는 [org]-[environment]-[content view]-[product]-입니다. 예: acme-production-myosp17-osp_containers-.
      • 콘텐츠 뷰를 사용하지 않는 경우 구조는 [org]-[product]-입니다. 예: acme-osp_containers-.
    • ceph_namespace, ceph_image, ceph_tag - Ceph Storage를 사용하는 경우 추가 매개변수를 포함하여 Ceph Storage 컨테이너 이미지 위치를 정의합니다. 이제 ceph_image에는 Satellite별 접두사가 포함됩니다. 이 접두사는 name_prefix 옵션과 동일한 값입니다.

프로세스

1. 오버클라우드의 새 컨테이너 이미지 파일을 생성합니다.

   $ sudo openstack tripleo container image prepare default \
       --local-push-destination \
       --output-env-file containers-prepare-parameter-dellemc.yaml

2. containers-prepare-parameter-dellemc.yaml 파일을 편집합니다.

3. 기본 Red Hat OpenStack Platform 컨테이너 이미지의 전략에 exclude 매개변수를 추가합니다. 벤더 컨테이너 이미지가 교체할 컨테이너 이미지를 제외하려면 이 매개변수를 사용합니다. 이 예제에서 컨테이너 이미지는 cinder-volume 이미지입니다.

   parameter_defaults:
     ContainerImagePrepare:
       - push_destination: true
         excludes:
     	   - cinder-volume
         set:
           namespace: registry.redhat.io/rhosp-rhel9
           name_prefix: openstack-
           name_suffix: ''
           tag: 17.1
           ...
         tag_from_label: "{version}-{release}"

4. 공급자 플러그인의 대체 컨테이너 이미지가 포함된 ContainerImagePrepare 매개변수에 새 전략을 추가합니다.

   parameter_defaults:
     ContainerImagePrepare:
       ...
       - push_destination: true
         includes:
           - cinder-volume
         set:
           namespace: registry.connect.redhat.com/dellemc
           name_prefix: openstack-
           name_suffix: -dellemc-rhosp16
           tag: 16.2-2
           ...

5. registry.connect.redhat.com 레지스트리의 인증 세부 정보를 ContainerImageRegistryCredentials 매개변수에 추가합니다.

   parameter_defaults:
     ContainerImageRegistryCredentials:
       registry.redhat.io:
         [service account username]: [service account password]
       registry.connect.redhat.com:
         [service account username]: [service account password]

6. containers-prepare-parameter-dellemc.yaml 파일을 저장합니다.

7. openstack overcloud deploy 와 같은 모든 배포 명령을 사용하여 containers-prepare-parameter-dellemc.yaml 파일을 포함합니다.

   $ openstack overcloud deploy --templates
       ...
       -e containers-prepare-parameter-dellemc.yaml
       ...

   director가 오버클라우드를 배포할 때 오버클라우드는 표준 컨테이너 이미지 대신 벤더 컨테이너 이미지를 사용합니다.

   중요

   containers-prepare-parameter-dellemc.yaml 파일은 오버클라우드 배포의 표준 containers-prepare-parameter.yaml 파일을 대체합니다. 오버클라우드 배포에 표준 containers-prepare-parameter.yaml 파일을 포함하지 마십시오. 언더클라우드 설치 및 업데이트에 대한 표준 containers-prepare-parameter.yaml 파일을 유지합니다.