2.2. 컨테이너 이미지 준비 명령 사용
이 섹션에서는 명령의 다양한 옵션에 대한 개념적 정보를 포함하여 openstack overcloud container image prepare 명령을 사용하는 방법에 대한 개요를 제공합니다.
오버클라우드용 컨테이너 이미지 환경 파일 생성
openstack overcloud container image prepare 명령의 주요 사용 중 하나는 오버클라우드에서 사용하는 이미지 목록이 포함된 환경 파일을 생성하는 것입니다. openstack overcloud deploy 와 같은 오버클라우드 배포 명령에 이 파일을 추가합니다. openstack overcloud container image prepare 명령은 이 기능에 대해 다음 옵션을 사용합니다.
--output-env-file- 결과 환경 파일 이름을 정의합니다.
다음 스니펫은 이 파일의 내용의 예입니다.
parameter_defaults: DockerAodhApiImage: registry.redhat.io/rhosp13/openstack-aodh-api:13.0-34 DockerAodhConfigImage: registry.redhat.io/rhosp13/openstack-aodh-api:13.0-34 ...
parameter_defaults:
DockerAodhApiImage: registry.redhat.io/rhosp13/openstack-aodh-api:13.0-34
DockerAodhConfigImage: registry.redhat.io/rhosp13/openstack-aodh-api:13.0-34
...
환경 파일에는 언더클라우드 레지스트리의 IP 주소 및 포트로 설정된 DockerInsecureRegistryAddress 매개변수도 포함되어 있습니다. 이 매개변수는 SSL/TLS 인증 없이 언더클라우드 레지스트리에서 이미지에 액세스하도록 오버클라우드 노드를 설정합니다.
가져오기 메서드의 컨테이너 이미지 목록 생성
OpenStack Platform 컨테이너 이미지를 다른 레지스트리 소스로 가져오려면 이미지 목록을 생성할 수 있습니다. 목록의 구문은 주로 컨테이너 이미지를 언더클라우드의 컨테이너 레지스트리로 가져오는 데 사용되지만 Red Hat Satellite 6과 같은 다른 가져오기 방법에 맞게 이 목록의 형식을 수정할 수 있습니다.
openstack overcloud container image prepare 명령은 이 기능에 대해 다음 옵션을 사용합니다.
--output-images-file- 가져오기 목록의 결과 파일 이름을 정의합니다.
다음은 이 파일의 내용의 예입니다.
container_images: - imagename: registry.redhat.io/rhosp13/openstack-aodh-api:13.0-34 - imagename: registry.redhat.io/rhosp13/openstack-aodh-evaluator:13.0-34 ...
container_images:
- imagename: registry.redhat.io/rhosp13/openstack-aodh-api:13.0-34
- imagename: registry.redhat.io/rhosp13/openstack-aodh-evaluator:13.0-34
...
컨테이너 이미지의 네임스페이스 설정
--output-env-file 및 --output-images-file 옵션 모두 결과 이미지 위치를 생성하기 위해 네임스페이스가 필요합니다. openstack overcloud container image prepare 명령은 다음 옵션을 사용하여 가져올 컨테이너 이미지의 소스 위치를 설정합니다.
--namespace- 컨테이너 이미지의 네임스페이스를 정의합니다. 일반적으로 디렉터리가 있는 호스트 이름 또는 IP 주소입니다.
--prefix- 이미지 이름 앞에 추가할 접두사를 정의합니다.
결과적으로 director는 다음 형식을 사용하여 이미지 이름을 생성합니다.
-
[NAMESPACE]/[PREFIX][IMAGE NAME]
컨테이너 이미지 태그 설정
--tag 및 --tag-from-label 옵션을 함께 사용하여 각 컨테이너 이미지에 태그를 설정합니다.
--tag-
소스의 모든 이미지에 대한 특정 태그를 설정합니다. 이 옵션만 사용하는 경우 director는 이 태그를 사용하여 모든 컨테이너 이미지를 가져옵니다. 그러나
--tag-from-label과 함께 이 옵션을 사용하는 경우 director는--tag를 소스 이미지로 사용하여 레이블을 기반으로 특정 버전 태그를 확인합니다.--tag옵션은 기본적으로latest로 설정됩니다. --tag-from-label-
지정된 컨테이너 이미지 레이블의 값을 사용하여 모든 이미지에 대해 버전 지정된 태그를 검색하고 가져옵니다. director는
--tag에 설정한 값으로 태그된 각 컨테이너 이미지를 검사한 다음 컨테이너 이미지 레이블을 사용하여 director가 레지스트리에서 가져오는 새 태그를 구성합니다. 예를 들어--tag-from-label {version}-{release}를 설정하면 director는version및release레이블을 사용하여 새 태그를 구성합니다. 한 컨테이너의 경우version을13.0으로 설정하고release를34으로 설정할 수 있으며, 이로 인해 태그13.0-34가 생성됩니다.
Red Hat Container Registry는 특정 버전 형식을 사용하여 모든 Red Hat OpenStack Platform 컨테이너 이미지에 태그를 지정합니다. 이 버전 형식은 {version}-{release} 이며 각 컨테이너 이미지는 컨테이너 메타데이터에 레이블로 저장됩니다. 이 버전 형식은 {release} 에서 다음 버전으로의 업데이트를 원활하게 수행할 수 있도록 지원합니다. 따라서 openstack overcloud container image prepare 명령을 실행할 때 항상 --tag-from-label {version}-{release} 를 사용해야 합니다. 컨테이너 이미지를 가져오기 위해 자체적으로 --tag 만 사용하지 마십시오. 예를 들어 --tag latest 를 사용하면 컨테이너 이미지를 업데이트하려면 태그를 변경해야 하므로 업데이트를 수행할 때 문제가 발생합니다.