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 ...
환경 파일에는 언더클라우드 레지스트리의 IP 주소 및 포트로 설정된 DockerInsecureRegistryAddress
매개변수도 포함되어 있습니다. 이 매개변수는 SSL/TLS 인증서가 없는 언더클라우드 레지스트리에서 이미지에 액세스하도록 오버클라우드 노드를 구성합니다.
가져오기 방법용 컨테이너 이미지 목록 생성
OpenStack Platform 컨테이너 이미지를 다른 레지스트리 소스로 가져오려는 경우 이미지 목록을 생성할 수 있습니다. list 구문은 주로 컨테이너 이미지를 언더클라우드의 컨테이너 레지스트리로 가져오는 데 사용되지만, 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 ...
컨테이너 이미지의 네임스페이스 설정
--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
으로 설정할 수 있으며릴리스
를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
를 자체적으로 사용하면 director에서 컨테이너 이미지를 업데이트하기 위해 태그를 변경해야 하므로 업데이트를 수행할 때 문제가 발생합니다.