CycleCloud CLI

Azure CycleCloud CLI를 사용하면 콘솔 또는 스크립트 파일에서 설치를 관리할 수 있습니다.

전역 CLI 매개 변수

이러한 매개 변수는 모든 명령에 사용할 수 있습니다.

-h, --help

도움말 메시지를 표시하고 종료합니다.

-v, --version

CLI의 버전을 표시합니다.

--config=CONFIG_FILE

이 명령에 사용할 비데폴트 구성 파일의 경로를 지정합니다.

--loglevel=LOG_LEVEL

CLI의 기본 로그 수준을 설정합니다.

cyclecloud 계정

클라우드 공급자 계정을 관리합니다.

cyclecloud account <command> [-o OUTPUT_FILE]
                             [--dry-run]
                             [-f INPUT_FILE]
                             [--force]

하위 명령	description
list	계정을 나열합니다.
show <account_name>	계정에 대한 세부 정보를 표시합니다.
create	새 계정을 만듭니다.
edit <account_name>	기존 계정을 편집합니다.
delete <account_name>	기존 계정을 삭제합니다.

cyclecloud 계정 목록

계정을 나열합니다.

cyclecloud account list

cyclecloud 계정 표시

계정에 대한 세부 정보를 표시합니다.

cyclecloud account show <account_name>

cyclecloud 계정 만들기

새 계정을 만듭니다.

cyclecloud account create [-o OUTPUT_FILE]
                          [--dry-run]
                          [-f INPUT_FILE]

-o OUTPUT_FILE

구성 매개 변수를 디스크에 씁니다.

--dry-run

정보를 표시하고 유효성을 검사하지만 변경 내용은 적용하지 않습니다.

-f INPUT_FILE

메시지를 표시하는 대신 구성 파일에서 정의를 읽습니다.

cyclecloud 계정 편집

기존 계정을 편집합니다.

cyclecloud account edit <account_name> [-o OUTPUT_FILE]
                                       [--dry-run]
                                       [-f INPUT_FILE]

-o OUTPUT_FILE

구성 매개 변수를 디스크에 씁니다.

--dry-run

정보를 표시하고 유효성을 검사하지만 변경 내용을 적용하지는 않습니다.

-f INPUT_FILE

메시지를 표시하는 대신 구성 파일에서 정의를 읽습니다.

cyclecloud 계정 삭제

기존 계정을 삭제합니다.

cyclecloud account delete <account_name> [--force]

--force

true이면 계정을 삭제하라는 메시지가 표시되지 않습니다.

cyclecloud add_node

클러스터에 노드를 더 추가합니다.

cyclecloud add_node <CLUSTER> [--template=TEMPLATE]
                              [--count=COUNT]
                              [--fixed]

-t TEMPLATE, --template=TEMPLATE

이 노드에 사용할 템플릿입니다. 지정하지 않으면 기본값은 사용 가능한 유일한 템플릿을 사용하는 것입니다. 그렇지 않으면 오류가 발생합니다.

-c COUNT, --count=COUNT

시작할 노드 수입니다. 지정되지 않은 경우 기본값은 1입니다.

-f, --fixed

설정된 경우 노드는 클러스터 템플릿에 영구적으로 추가됩니다(제거될 때까지). 그렇지 않으면 노드가 종료될 때 자동으로 제거됩니다.

CycleCloud 구성

cyclecloud 구성 간에 쉽게 전환할 수 있습니다.

cyclecloud config <command>

하위 명령	Description
show	현재 구성을 표시합니다.
list	사용 가능한 구성을 나열합니다.
create <config_name>	새 구성을 만듭니다.
rename <old_name> <new_name>	기존 구성의 이름을 바꿉니다.
use <config_name>	지정된 구성으로 전환합니다.
remove <config_name>	명명된 구성을 제거합니다.

cyclecloud config show (현재 CycleCloud의 설정을 보여줍니다)

현재 구성을 표시합니다.

cyclecloud config show

cyclecloud 구성 목록

사용 가능한 구성을 나열합니다.

cyclecloud config list

cyclecloud config create

새 구성을 만듭니다.

cyclecloud config create <config_name>

cyclecloud config 이름 변경

기존 구성의 이름을 바꿉니다.

cyclecloud config rename <old_name> <new_name>

cyclecloud 구성 사용

지정된 구성으로 전환합니다.

cyclecloud config use <config_name>

cyclecloud config remove

명명된 구성을 제거합니다.

cyclecloud config remove <config_name>

cyclecloud connect

클러스터에서 실행 중인 인스턴스에 연결합니다. 7.8을 기준으로 이름은 노드 이름, 호스트 이름 또는 IP 주소일 수 있습니다.

cyclecloud connect <NAME> [--keyfile=KEYFILE]
                          [--cluster=CLUSTER]
                          [--user=USER]
                          [--bastion-host=BASTION-HOST]
                          [--bastion-port=BASTION-PORT]
                          [--bastion-user=BASTION-USER]
                          [--bastion-key=BASTION-KEY]

-k KEYFILE, --keyfile=KEYFILE

노드에 지정되지 않았거나 노드가 없는 경우 사용할 키페어입니다.

-c CLUSTER, --cluster=CLUSTER

이름이 노드 이름인 경우, 해당 노드가 속한 클러스터. 이름이 같은 노드가 여러 대 있는 경우가 아니면 선택 사항입니다.

-u USER, --user=USER

노드에 로그인할 사용자입니다.

--bastion-host=BASTION-HOST

연결을 경유시키기 위한 SSH 배스천 호스트.

--bastion-port=BASTION-PORT

요새에 연결하기 위한 SSH 포트입니다.

--bastion-user=BASTION-USER

요새에 연결하기 위한 사용자 이름입니다.

--bastion-key=BASTION-KEY

요새에 연결하기 위한 프라이빗 키 파일입니다.

cyclecloud copy_cluster

클러스터의 복사본을 만듭니다.

cyclecloud copy_cluster <source_cluster_name> <new_cluster_name> [--parameters=PARAMETERS]

-p PARAMETERS, --parameters=PARAMETERS

사용할 매개 변수 파일입니다.

cyclecloud 클러스터_생성

기존 템플릿에서 클러스터를 만듭니다.

cyclecloud create_cluster <TEMPLATE> <NAME> [--force]
                                            [--parameters=PARAMETERS]
                                            [--parameter-override=PARAMETER_OVERRIDE]

--force

지정된 경우 클러스터가 존재하면 교체됩니다.

-p PARAMETERS, --parameters=PARAMETERS

사용할 매개 변수 파일입니다.

-P PARAMETER_OVERRIDE, --parameter-override=PARAMETER_OVERRIDE

특정 매개 변수를 추가하거나 재정의합니다. 이 옵션은 에 지정된 -p값보다 우선합니다.

cyclecloud 자격 증명

클라우드 공급자 계정 자격 증명을 관리합니다.

cyclecloud credential <command>

하위 명령	Description
list	자격 증명을 나열합니다.
create	새 자격 증명을 만듭니다.
edit <account_name>	기존 자격 증명을 편집합니다.
delete <account_name>	기존 자격 증명을 삭제합니다.

cyclecloud 자격 증명 목록

자격 증명을 나열합니다.

cyclecloud credential list

cyclecloud 자격 증명 만들기

새 자격 증명을 만듭니다.

cyclecloud credential create

cyclecloud 자격 증명 편집

기존 자격 증명을 편집합니다.

cyclecloud credential edit <account_name>

cyclecloud 자격 증명 삭제

기존 자격 증명을 삭제합니다.

cyclecloud credential delete <account_name>

cyclecloud delete_cluster

실행하지 않는 클러스터를 삭제합니다.

cyclecloud delete_cluster <CLUSTER> [--recursive]
                                    [--force]

-r, --recursive

이 클러스터와 모든 하위 클러스터를 재귀적으로 삭제합니다.

--force

이 클러스터를 강제로 삭제합니다. 클라우드 공급자의 모든 리소스가 이미 종료된 경우에만 이 옵션을 사용합니다.

cyclecloud delete_template 명령어를 사용하여 템플릿을 삭제합니다.

클러스터 템플릿을 삭제합니다.

cyclecloud delete_template <TEMPLATE>

cyclecloud 매개변수 내보내기

지정된 클러스터에 대한 매개 변수를 내보냅니다.

cyclecloud export_parameters <cluster_name> [-o OUTPUT_FILE]
                                            [--format=OUTPUT_FORMAT]

-o OUTPUT_FILE

만들기를 위해 클러스터 매개 변수를 디스크에 씁니다.

--format=OUTPUT_FORMAT

출력 형식

CycleCloud 이미지

사용자 지정 이미지를 관리합니다.

cyclecloud image <command> [--account=ACCOUNTS]
                           [--name=NAME]
                           [--label=LABEL]
                           [--package-version=PACKAGE_VERSION]
                           [--bump-version=BUMP_VERSION]
                           [--os=OS]
                           [--jetpack-version=JETPACK_VERSION]
                           [--install-jetpack]
                           [--jetpack-platform=JETPACK_PLATFORM]
                           [--dry-run]

하위 명령	Description
add <image_name> [...]	하나 이상의 이미지를 추가합니다.

cyclecloud 이미지 추가

하나 이상의 이미지를 추가합니다.

cyclecloud image add <image_name> [...] [--account=ACCOUNTS]
                                        [--name=NAME]
                                        [--label=LABEL]
                                        [--package-version=PACKAGE_VERSION]
                                        [--bump-version=BUMP_VERSION]
                                        [--os=OS]
                                        [--jetpack-version=JETPACK_VERSION]
                                        [--install-jetpack]
                                        [--jetpack-platform=JETPACK_PLATFORM]
                                        [--dry-run]

--account=ACCOUNTS

이 계정만 검색합니다. 여러 계정에 대해 이 옵션을 반복할 수 있습니다.

--name=NAME

만들 패키지의 이름입니다. 이 매개 변수는 필수입니다.

--label=LABEL

생성할 패키지의 레이블입니다.

--package-version=PACKAGE_VERSION

기본값인 1.0.0 대신 새 이미지에 이 버전을 사용합니다.

--bump-version=BUMP_VERSION

--bump-version minor을 사용하여 최신 부 버전을 1씩 증가시키거나(예: 1.1에서 1.2로), --bump-version major 또는 --bump-version patch을 사용하세요.

--os=OS

이미지에서 운영 체제를 지정하는 데 사용합니다 --os linux/windows .

--jetpack-version=JETPACK_VERSION

설치되었거나 이미지에 설치해야 하는 Jetpack의 버전입니다.

--install-jetpack

이 이미지의 런타임에 Jetpack을 설치합니다.

--jetpack-platform=JETPACK_PLATFORM

이미지에 사용되는 Jetpack 플랫폼(예: centos-7, ubuntu-14.04, windows).

--dry-run

일치하는 이미지를 찾지만 이미지 정보는 저장하지 않습니다.

cyclecloud import_cluster

텍스트 파일에서 클러스터를 만듭니다. CLUSTER가 제공되지 않고 파일에 단일 클러스터가 포함된 경우 해당 클러스터의 이름이 사용됩니다.

cyclecloud import_cluster [CLUSTER] [-c TEMPLATE]
                                    [--force]
                                    [--as-template]
                                    [--file=FILE]
                                    [--parameters=PARAMETERS]
                                    [--parameter-override=PARAMETER_OVERRIDE]
                                    [--recursive]

-c TEMPLATE

가져올 파일의 클러스터입니다. 지정하지 않으면 새 클러스터의 이름이 사용됩니다.

--force

지정된 경우 클러스터가 존재하면 교체됩니다.

-t, --as-template

지정된 경우 클러스터는 다른 클러스터를 만드는 데만 사용할 수 있는 템플릿으로 저장됩니다.

-f FILE, --file=FILE

템플릿을 가져오기 위한 파일입니다.

-p PARAMETERS, --parameters=PARAMETERS

사용할 매개 변수 파일입니다.

-P PARAMETER_OVERRIDE, --parameter-override=PARAMETER_OVERRIDE

특정 매개 변수를 추가하거나 재정의합니다. -p에 지정된 값을 우선합니다.

-r, --recursive

명명된 클러스터와 해당 클러스터가 부모인 파일의 모든 클러스터를 가져옵니다.

cyclecloud import_template

텍스트 파일에서 클러스터 템플릿을 가져옵니다. NAME이 지정되지 않고 파일에 단일 클러스터가 있는 경우 해당 클러스터의 이름이 사용됩니다.

cyclecloud import_template [NAME] [-c TEMPLATE]
                                  [--force]
                                  [--file=FILE]

-c TEMPLATE

가져올 파일의 템플릿입니다. 지정하지 않으면 새 템플릿의 이름이 사용됩니다.

--force

템플릿이 지정되어 있고 존재하는 경우, 교체됩니다.

-f FILE, --file=FILE

템플릿을 가져오기 위한 파일입니다.

cyclecloud 초기화

CycleCloud 설정을 초기화합니다.

cyclecloud initialize [--batch]
                      [--force]
                      [--url=URL]
                      [--username=USERNAME]
                      [--password=PASSWORD]
                      [--verify-ssl=VERIFY-SSL]
                      [--name=NAMED_CONFIG]

--batch

지정한 경우 명령줄에서 인수를 제공해야 합니다. 질문은 '아니오'로 간주됩니다.

--force

유효한 구성 파일을 사용할 수 있는 경우에도 강제로 다시 초기화합니다.

--url=URL

CycleServer 설치의 기본 URL입니다.

--username=USERNAME

CycleServer 설치의 사용자 이름입니다.

--password=PASSWORD

CycleServer 설치에 대한 암호입니다.

--verify-ssl=VERIFY-SSL

CycleServer 설치 시 SSL 인증서를 확인할지 여부를 (true 또는 false) 선택합니다.

--name=NAMED_CONFIG

구성 명령과 함께 사용할 수 있는 명명된 구성을 만듭니다.

사이클클라우드 락커

CycleCloud 사물함을 관리합니다.

cyclecloud locker <command>

하위 명령	Description
list	사물함을 나열하시오.
show <locker>	사물함에 대한 세부 정보를 표시합니다.

cyclecloud 로커 목록

사물함을 나열하시오.

cyclecloud locker list

cyclecloud locker show

사물함에 대한 세부 정보를 표시합니다.

cyclecloud locker show <locker>

cyclecloud 프로젝트

CycleCloud 프로젝트를 관리합니다.

cyclecloud project <command> [--skip-teardown]
                             [--output-json=JSON_FILE]
                             [--junit-xml=JUNIT_FILE]
                             [--extra-var=EXTRA_VARS]
                             [--template=TEMPLATE]
                             [--name=CLUSTER_NAME]
                             [--global]
                             [--project-version=PROJECT_VERSION]
                             [--build-dir=BUILD_DIR]

하위 명령	Description
init <name>	빈 프로젝트를 새로 만듭니다.
fetch <url> <path>	GitHub <URL>에서 경로<로 >프로젝트를 가져옵니다.
info	프로젝트 정보를 표시합니다.
add_spec <spec>	프로젝트에 사양을 추가합니다.
default_locker <locker>	업로드할 기본 로커를 설정합니다.
test	지정된 클러스터 정의에 대한 통합 테스트를 실행합니다.
build	프로젝트를 빌드합니다.
upload [locker]	지정된 사물함을 빌드하고 업로드합니다(지정하지 않은 경우 기본값 사용).
download [locker]	지정된 사물함에서 프로젝트 Blob을 다운로드합니다(지정하지 않은 경우 기본값 사용).
generate_template <file>	프로젝트에 대한 클러스터 템플릿을 <파일에 기록합니다>.

cyclecloud project init

빈 프로젝트를 새로 만듭니다.

cyclecloud project init <name>

CycleCloud 프로젝트 가져오기

GitHub <url>에서 <path>로 프로젝트를 가져옵니다.

cyclecloud project fetch <url> <path>

cyclecloud 프로젝트 정보

프로젝트 정보를 표시합니다.

cyclecloud project info

cyclecloud 프로젝트 "add_spec" 추가

프로젝트에 사양을 추가합니다.

cyclecloud project add_spec <spec>

cyclecloud 프로젝트 기본 잠금 장치

업로드의 기본 락커를 설정합니다.

cyclecloud project default_locker <locker> [--global]

--global

프로젝트별 값 대신 전역 기본값을 설정합니다.

cyclecloud 프로젝트 테스트

클러스터 정의에 대한 통합 테스트를 실행합니다.

cyclecloud project test [--skip-teardown]
                        [--output-json=JSON_FILE]
                        [--junit-xml=JUNIT_FILE]
                        [--extra-var=EXTRA_VARS]
                        [--template=TEMPLATE]
                        [--name=CLUSTER_NAME]

--skip-teardown

테스트용으로 생성된 클러스터 해체 생략.

--output-json=JSON_FILE

지정된 json 파일에 결과를 출력합니다.

--junit-xml=JUNIT_FILE

지정된 json 파일에 결과를 junit-xml 형식으로 출력합니다.

-e EXTRA_VARS, --extra-var=EXTRA_VARS

테스트 중인 클러스터 템플릿을 매개 변수화하는 데 사용되는 임의의 키=값 쌍입니다.

-t TEMPLATE, --template=TEMPLATE

클러스터 템플릿 파일의 경로입니다.

-n CLUSTER_NAME, --name=CLUSTER_NAME

테스트할 클러스터 정의의 이름입니다.

cyclecloud 프로젝트 빌드

프로젝트를 빌드합니다.

cyclecloud project build [--project-version=PROJECT_VERSION]
                         [--build-dir=BUILD_DIR]

--project-version=PROJECT_VERSION

project.ini 파일에 있는 프로젝트 버전을 덮어씁니다.

--build-dir=BUILD_DIR

빌드 디렉터리입니다.

cyclecloud 프로젝트 업로드

지정된 사물함을 빌드하고 업로드합니다(지정하지 않은 경우 기본값 사용).

cyclecloud project upload [locker] [--project-version=PROJECT_VERSION]

--project-version=PROJECT_VERSION

project.ini에 있는 프로젝트 버전을 재정의합니다.

cyclecloud 프로젝트 다운로드

지정된 사물함에서 프로젝트 Blob을 다운로드합니다. 사물함을 지정하지 않으면 명령에서 기본 사물함을 사용합니다.

cyclecloud project download [locker]

cyclecloud 프로젝트 generate_template

프로젝트에 대한 클러스터 템플릿을 생성합니다. 이 명령은 템플릿을 <file>에 씁니다.

cyclecloud project generate_template <file>

cyclecloud reboot_node

실행 중인 노드를 다시 부팅합니다.

cyclecloud reboot_node <CLUSTER> <NODE_NAME>

cyclecloud 노드 제거

클러스터에서 노드를 제거합니다. 이 명령은 노드가 이미 시작된 경우 종료합니다.

cyclecloud remove_node <CLUSTER> <NODE_NAME> [--filter=FILTER]
                                             [--instance-filter=INSTANCE_FILTER]
                                             [--creds=CREDS]
                                             [--no-prompt]
                                             [--force]

-f FILTER, --filter=FILTER

전체 클래스 광고 식과 일치하는 노드를 제거합니다.

--instance-filter=INSTANCE_FILTER

전체 클래스 광고 식과 일치하는 활성 인스턴스가 있는 노드를 제거합니다.

--creds=CREDS

명명된 자격 증명 집합을 사용하여 시작한 노드를 제거합니다.

--no-prompt

지정한 경우 필터를 기반으로 노드를 종료하기 전에 확인을 요청하지 않습니다.

--force

종료되지 않더라도 이 노드를 강제로 제거합니다. 클라우드 공급자의 이 노드에 대한 리소스가 이미 종료된 경우에만 이 옵션을 사용합니다.

cyclecloud 다시 시도

명명된 클러스터에 대한 초기화 작업을 다시 시도합니다.

cyclecloud retry <CLUSTER> [--recursive]

-r, --recursive

이 클러스터 및 모든 하위 클러스터에서 재귀적으로 옵션을 다시 시도합니다.

cyclecloud show_cluster

CycleCloud의 클러스터 또는 클러스터를 표시합니다.

cyclecloud show_cluster <CLUSTER> [--recursive]
                                  [--long]
                                  [--templates]

-r, --recursive

이 클러스터와 모든 하위 클러스터를 표시합니다.

-l, --long

요약을 표시하는 대신 각 노드를 나열합니다.

-t, --templates

출력에 클러스터 템플릿을 포함합니다.

cyclecloud show_nodes 명령어 실행

선택한 노드 또는 인스턴스의 세부 정보를 표시합니다.

cyclecloud show_nodes [NAME] [--attrs=ATTRS]
                             [--filter=FILTER]
                             [--instance-filter=INSTANCE_FILTER]
                             [--output=OUTPUT]
                             [--format=FORMAT]
                             [--creds=CREDS]
                             [--cluster=CLUSTER]
                             [--states=STATES]
                             [--long]
                             [--summary]

-a ATTRS, --attrs=ATTRS

지정된 특성 집합(쉼표로 구분된 목록)을 표시합니다.

-f FILTER, --filter=FILTER

전체 클래스 광고 식과 일치하는 노드만 표시합니다.

--instance-filter=INSTANCE_FILTER

전체 클래스 광고 식과 일치하는 활성 인스턴스가 있는 노드만 표시합니다.

--output=OUTPUT

Python 스타일의 명명된 매개 변수 형식 문자열에서 설명하는 일치하는 노드 특성을 출력합니다. 예: --output="Name: %(Name)s\t(ID: %(InstanceId)s)\n Cluster: %(ClusterName)s\n".

--format=FORMAT

출력 표시 형식 [xml | json | text]를 변경합니다.

--creds=CREDS

명명된 자격 증명 집합을 사용하여 시작된 노드만 표시합니다.

-c CLUSTER, --cluster=CLUSTER

지정된 클러스터에 노드만 표시합니다.

--states=STATES

지정된 상태(쉼표로 구분된 목록)에 노드만 표시합니다.

-l, --long

노드의 전체 클래스 광고 표현을 표시합니다.

-s, --summary

노드의 최소 표현을 표시합니다.

cyclecloud start_cluster

명명된 클러스터를 시작합니다.

cyclecloud start_cluster <CLUSTER> [--recursive]
                                   [--test]

-r, --recursive

이 클러스터와 모든 하위 클러스터를 재귀적으로 시작합니다.

-t, --test

테스트 모드에서 클러스터를 시작합니다.

cyclecloud start_node

실행 중인 클러스터에서 종료된 노드를 시작합니다.

cyclecloud start_node <CLUSTER> <NODE_NAME>

사이클클라우드 terminate_cluster (클러스터 종료)

명명된 클러스터를 종료합니다.

cyclecloud terminate_cluster <CLUSTER> [--recursive]

-r, --recursive

이 클러스터와 모든 하위 클러스터를 재귀적으로 종료합니다.

cyclecloud terminate_node (사이클클라우드 노드 종료)

실행 중인 노드를 종료하지만 클러스터에 남겨 둡니다.

cyclecloud terminate_node <CLUSTER> <NODE_NAME> [--filter=FILTER]
                                                [--instance-filter=INSTANCE_FILTER]
                                                [--creds=CREDS]
                                                [--no-prompt]

-f FILTER, --filter=FILTER

전체 클래스 광고 식과 일치하는 노드를 종료합니다.

--instance-filter=INSTANCE_FILTER

전체 클래스 광고 식과 일치하는 활성 인스턴스로 노드를 종료합니다.

--creds=CREDS

명명된 자격 증명 집합을 사용하여 노드를 종료합니다.

--no-prompt

지정한 경우 필터를 기반으로 노드를 종료하기 전에 확인을 요청하지 않습니다.