7.15. 배포 명령 옵션

다음 표에는 openstack overcloud deploy 명령의 추가 매개변수가 나열되어 있습니다.

중요

일부 옵션은 이번 릴리스에서 기술 프리뷰로 제공되므로 Red Hat에서 완전히 지원되지 않습니다. 테스트 용도로만 사용해야 하며 프로덕션 환경에서 사용해서는 안 됩니다. 기술 프리뷰 기능에 대한 자세한 내용은 적용 범위 상세 정보를 참조하십시오.

표 7.1. 배포 명령 옵션

매개변수설명

--templates [TEMPLATES]

배포하려는 heat 템플릿이 포함된 디렉터리입니다. 비어 있을 경우 배포 명령은 /usr/share/openstack-tripleo-heat-templates/를 기본 템플릿 위치로 사용합니다.

--stack STACK

만들거나 업데이트하려는 스택의 이름입니다.

-t [TIMEOUT], --timeout [TIMEOUT]

배포 제한 시간(분)입니다.

--libvirt-type [LIBVIRT_TYPE]

하이퍼바이저에 사용할 가상화 유형입니다.

--ntp-server [NTP_SERVER]

시간 동기화에 사용할 NTP(Network Time Protocol) 서버입니다. 콤마로 구분된 목록에 여러 개의 NTP 서버를 지정할 수도 있습니다(예: --ntp-server 0.centos.pool.org,1.centos.pool.org). 고가용성 클러스터 배포를 위해서는 컨트롤러 노드가 동일한 시간 소스를 일관되게 참조해야 합니다. 일반적인 환경에는 기존의 사례대로 이미 지정된 NTP 시간 소스가 있을 수 있습니다.

--no-proxy [NO_PROXY]

환경 변수 no_proxy의 사용자 지정 값을 정의합니다. 이 변수는 프록시 통신에서 특정 호스트 이름을 제외합니다.

--overcloud-ssh-user OVERCLOUD_SSH_USER

오버클라우드 노드에 액세스할 SSH 사용자를 정의합니다. 일반적으로 SSH 액세스는 heat-admin 사용자를 통해 실행됩니다.

--overcloud-ssh-key OVERCLOUD_SSH_KEY

오버클라우드 노드에 대한 SSH 액세스의 키 경로를 정의합니다.

--overcloud-ssh-network OVERCLOUD_SSH_NETWORK

오버클라우드 노드에 대한 SSH 액세스에 사용할 네트워크 이름을 정의합니다.

-e [EXTRA HEAT TEMPLATE], --environment-file [ENVIRONMENT FILE]

오버클라우드 배포에 전달하려는 추가 환경 파일입니다. 이 옵션을 두 번 이상 지정할 수 있습니다. openstack overcloud deploy 명령에 전달하는 환경 파일의 순서가 중요합니다. 예를 들어 순차적으로 전달되는 각 환경 파일의 매개변수는 이전 환경 파일의 동일한 매개변수를 재정의합니다.

--environment-directory

배포에 추가하려는 환경 파일이 들어 있는 디렉터리입니다. 배포 명령은 이러한 환경 파일을 먼저 숫자순으로 처리한 다음, 알파벳순으로 처리합니다.

-r ROLES_FILE

역할 파일을 정의하고 --templates 디렉터리의 기본 roles_data.yaml을 덮어씁니다. 파일 위치는 절대 경로이거나 --templates의 상대 경로일 수 있습니다.

-n NETWORKS_FILE

네트워크 파일을 정의하고 --templates 디렉터리의 기본 network_data.yaml을 덮어씁니다. 파일 위치는 절대 경로이거나 --templates의 상대 경로일 수 있습니다.

-p PLAN_ENVIRONMENT_FILE

plan 환경 파일을 정의하고 --templates 디렉터리의 기본 plan-environment.yaml을 덮어씁니다. 파일 위치는 절대 경로이거나 --templates의 상대 경로일 수 있습니다.

--no-cleanup

배포 후 임시 파일을 삭제하지 않고 해당 위치를 기록하려면 이 옵션을 사용합니다.

--update-plan-only

실제 배포를 수행하지 않고 계획을 업데이트하려면 이 옵션을 사용합니다.

--validation-errors-nonfatal

오버클라우드 생성 프로세스에서는 일련의 사전 배포 검사를 수행합니다. 이 옵션은 사전 배포 검사에서 치명적이지 않은 오류가 발생할 경우에만 종료됩니다. 오류가 있으면 배포에 실패할 수 있으므로 이 옵션을 사용하는 것이 좋습니다.

--validation-warnings-fatal

오버클라우드 생성 프로세스에서는 일련의 사전 배포 검사를 수행합니다. 이 옵션은 사전 배포 검사에서 심각하지 않은 경고가 발생할 경우에만 종료됩니다. openstack-tripleo-validations

--dry-run

오버클라우드를 생성하지 않고 오버클라우드에서 검증을 수행하려면 이 옵션을 사용합니다.

--run-validations

openstack-tripleo-validations 패키지에서 외부 검증을 실행하려면 이 옵션을 사용합니다.

--skip-postconfig

오버클라우드 배포 후 구성을 건너뛰려면 이 옵션을 사용합니다.

--force-postconfig

오버클라우드 배포 후 구성을 강제 적용하려면 이 옵션을 사용합니다.

--skip-deploy-identifier

배포 명령이 DeployIdentifier 매개변수의 고유 ID를 생성하지 않게 하려면 이 옵션을 사용합니다. 소프트웨어 구성 배포 단계는 구성이 실제로 변경되는 경우에만 트리거됩니다. 특정 역할 확장과 같은 소프트웨어 구성을 실행할 필요가 없다는 확신이 있을 때만 이 옵션을 신중하게 사용합니다.

--answers-file ANSWERS_FILE

인수 및 매개변수를 사용한 YAML 파일의 경로입니다.

--disable-password-generation

오버클라우드 서비스의 암호 생성을 비활성화하려면 이 옵션을 사용합니다.

--deployed-server

사전 프로비저닝된 오버클라우드 노드를 배포하려면 이 옵션을 사용합니다. --disable-validations와 함께 사용됩니다.

--no-config-download, --stack-only

config-download 워크플로우를 비활성화하고 스택과 관련 OpenStack 리소스만 생성하려면 이 옵션을 사용합니다. 이 명령은 오버클라우드에 소프트웨어 구성을 적용하지 않습니다.

--config-download-only

오버클라우드 스택 생성을 비활성화하고 config-download 워크플로우만 실행하여 소프트웨어 구성을 적용하려면 이 옵션을 사용합니다.

--output-dir OUTPUT_DIR

저장된 config-download 출력에 사용할 디렉터리입니다. 이 디렉터리는 mistral 사용자만 쓸 수 있어야 합니다. 지정되지 않으면 director에서 기본값인 /var/lib/mistral/overcloud를 사용합니다.

--override-ansible-cfg OVERRIDE_ANSIBLE_CFG

Ansible 설정 파일의 경로입니다. 파일의 설정이 config-download에서 기본적으로 생성하는 설정을 덮어씁니다.

--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT

config-download 단계에 사용하려는 제한 시간(분)입니다. 설정되지 않으면 director는 스택 배포 작업 후에 --timeout 매개변수에서 남은 시간을 기본값으로 설정합니다.

--limit NODE1,NODE2

config-download 플레이북 실행을 특정 노드 또는 노드 세트로 제한하려면 쉼표로 구분된 노드 목록과 함께 이 옵션을 사용합니다. 예를 들어 --limit 옵션은 확장 작업 중 새 노드에서만 config-download를 실행하려는 경우 유용합니다. 이 인수로 인해 호스트 간 인스턴스 실시간 마이그레이션이 실패할 수 있습니다. ansible-playbook-command.sh 스크립트를 사용하여 config-download 실행을 참조하십시오.

--tags TAG1,TAG2

(기술 프리뷰) 이 옵션을 config-download 플레이북의 콤마로 구분된 태그 목록과 함께 사용하여 특정 config-download 작업 세트를 통해 배포를 실행합니다.

--skip-tags TAG1,TAG2

(기술 프리뷰) 이 옵션을 config-download 플레이북에서 건너뛰고자 하는 태그 목록 (콤마로 구분)과 함께 사용합니다.

전체 옵션 목록을 보려면 다음 명령을 실행합니다.

(undercloud) $ openstack help overcloud deploy

일부 명령행 매개변수는 오래되었거나 더 이상 사용되지 않으며, 대신 환경 파일의 parameter_defaults 섹션에 포함하는 heat 템플릿 매개변수가 사용됩니다. 다음 표에는 더 이상 사용되지 않는 매개변수가 해당하는 heat 템플릿 매개변수에 매핑되어 있습니다.

표 7.2. 더 이상 사용되지 않는 CLI 매개변수와 해당하는 heat 템플릿 매개변수 매핑

매개변수설명heat 템플릿 매개변수

--control-scale

확장할 컨트롤러 노드 수

ControllerCount

--compute-scale

확장할 컴퓨팅 노드 수

ComputeCount

--ceph-storage-scale

확장할 Ceph Storage 노드 수

CephStorageCount

--block-storage-scale

확장할 Block Storage(cinder) 노드 수

BlockStorageCount

--swift-storage-scale

확장할 Object Storage(swift) 노드 수

ObjectStorageCount

--control-flavor

컨트롤러 노드에 사용하려는 플레이버

OvercloudControllerFlavor

--compute-flavor

컴퓨팅 노드에 사용하려는 플레이버

OvercloudComputeFlavor

--ceph-storage-flavor

Ceph Storage 노드에 사용하려는 플레이버

OvercloudCephStorageFlavor

--block-storage-flavor

Block Storage(cinder) 노드에 사용하려는 플레이버

OvercloudBlockStorageFlavor

--swift-storage-flavor

Object Storage(swift) 노드에 사용하려는 플레이버

OvercloudSwiftStorageFlavor

--validation-errors-fatal

오버클라우드 생성 프로세스에서는 일련의 사전 배포 검사를 수행합니다. 이 옵션은 사전 배포 확인에서 치명적인 오류가 발생할 경우에만 종료됩니다. 오류가 있으면 배포에 실패할 수 있으므로 이 옵션을 사용하는 것이 좋습니다.

매개변수 매핑 없음

--disable-validations

사전 배포 검증을 완전히 비활성화합니다. 이러한 검증은 openstack-tripleo-validations 패키지에서 외부 검증으로 대체된 기본 제공 사전 배포 검증입니다.

매개변수 매핑 없음

--config-download

config-download 메커니즘을 사용하여 배포를 실행합니다. 이제 이 값이 기본값이며 이 CLI 옵션은 나중에 제거될 수 있습니다.

매개변수 매핑 없음

--rhel-reg

오버클라우드 노드를 고객 포털 또는 Satellite 6에 등록하려면 이 옵션을 사용합니다.

RhsmVars

--reg-method

오버클라우드 노드에 사용할 등록 방법을 정의하려면 이 옵션을 사용합니다. Red Hat Satellite 6 또는 Red Hat Satellite 5에는 satellite를 고객 포털에는 portal을 사용합니다.

RhsmVars

--reg-org [REG_ORG]

등록에 사용하려는 조직입니다.

RhsmVars

--reg-force

시스템이 이미 등록되어 있어도 시스템을 등록하려면 이 옵션을 사용합니다.

RhsmVars

--reg-sat-url [REG_SAT_URL]

오버클라우드 노드를 등록할 Satellite 서버의 기본 URL입니다. Satellite HTTPS URL 대신 HTTP URL을 이 매개변수에 사용합니다. 예를 들어 https://satellite.example.com 대신 http://satellite.example.com을 사용합니다. 오버클라우드 생성 프로세스에서는 이 URL을 사용하여 서버가 Red Hat Satellite 5 서버인지 아니면 Red Hat Satellite 6 서버인지 확인합니다. Red Hat Satellite 6 서버인 경우 오버클라우드는 katello-ca-consumer-latest.noarch.rpm 파일을 가져오고 subscription-manager에 등록한 다음, katello-agent를 설치합니다. Red Hat Satellite 5 서버인 경우 오버클라우드는 RHN-ORG-TRUSTED-SSL-CERT 파일을 가져오고 rhnreg_ks에 등록합니다.

RhsmVars

--reg-activation-key [REG_ACTIVATION_KEY]

등록에 사용할 활성화 키를 정의하려면 이 옵션을 사용합니다.

RhsmVars

이러한 매개변수는 Red Hat OpenStack Platform의 이후 버전에서 삭제될 예정입니다.