최신판 |
당신의 편집 |
1번째 줄: |
1번째 줄: |
| ==개요== | | ==개요== |
| [[분류: OpenStackClient]] | | [[분류: OpenStackClient]] |
| [[분류: Man page]]
| |
| ;openstack | | ;openstack |
| ;OpenStack 커맨드 라인 | | ;OpenStack 커맨드 라인 |
| ;OpenStackClient 매뉴얼 페이지 | | ;OpenStackClient 매뉴얼 페이지 |
| https://docs.openstack.org/python-openstackclient/2024.1/cli/man/openstack.html | | https://docs.openstack.org/python-openstackclient/2024.1/cli/man/openstack.html |
| | {{작성중}} |
|
| |
|
| ==SYNOPSIS== | | ==SYNOPSIS== |
261번째 줄: |
261번째 줄: |
|
| |
|
| ===로깅 세팅=== | | ===로깅 세팅=== |
| '''openstack'''은 설정 파일의 로그 세팅을 통해 작업 내역을 기록할 수 있습니다. 사용자 작업을 기록함으로써, 리소스 변경사항을 식별할 수 있으며, 이는 트러블슈팅에 유용한 정보가 됩니다.
| |
|
| |
| 로그 세팅에 대한 자세한 내용은 [[OpenStackClient 설정|설정]]을 참조하십시오.
| |
|
| |
|
| ==참고== | | ==참고== |
| 도움말 출력에 표시되는 명령어 목록은 선택된 API 버전을 반영합니다. 예를 들어, Identity v3 명령어를 보려면 <code>OS_IDENTITY_API_VERSION</code>이 <code>3</code>으로 세팅되어야 합니다.
| |
|
| |
| ==예시== | | ==예시== |
| 서버 <code>appweb01</code>에 대한 상세 정보를 표시하는 예시:
| |
|
| |
| <syntaxhighlight lang='bash'>
| |
| openstack \
| |
| --os-project-name ExampleCo \
| |
| --os-username demo --os-password secret \
| |
| --os-auth-url http://localhost:5000:/v2.0 \
| |
| server show appweb01
| |
| </syntaxhighlight>
| |
|
| |
| keystone에서 openid를 사용하여 인증하는 동일한 명령어:
| |
|
| |
| <syntaxhighlight lang='bash'>
| |
| openstack \
| |
| --os-project-name ExampleCo \
| |
| --os-auth-url http://localhost:5000:/v2.0 \
| |
| --os-auth-plugin openid \
| |
| --os-auth-type v3oidcpassword \
| |
| --os-username demo-idp \
| |
| --os-password secret-idp \
| |
| --os-identity-provider google \
| |
| --os-client-id the-id-assigned-to-keystone-in-google \
| |
| --os-client-secret 3315162f-2b28-4809-9369-cb54730ac837 \
| |
| --os-openid-scope 'openid email profile'\
| |
| --os-protocol openid \
| |
| --os-access-token-type access_token \
| |
| --os-discovery-endpoint https://accounts.google.com/.well-known/openid-configuration \
| |
| server show appweb01
| |
| </syntaxhighlight>
| |
|
| |
| 인증 환경변수(<code>OS_AUTH_URL</code>, <code>OS_PROJECT_NAME</code>, <code>OS_USERNAME</code>, <code>OS_PASSWORD</code>)가 설정된 경우의 동일한 명령어:
| |
|
| |
| <syntaxhighlight lang='bash'>
| |
| openstack server show appweb01
| |
| </syntaxhighlight>
| |
|
| |
| 새 이미지를 생성하는 명령어:
| |
|
| |
| <syntaxhighlight lang='bash'>
| |
| openstack image create \
| |
| --disk-format=qcow2 \
| |
| --container-format=bare \
| |
| --public \
| |
| --copy-from http://somewhere.net/foo.img \
| |
| foo
| |
| </syntaxhighlight>
| |
|
| |
| ==파일== | | ==파일== |
| ;<code>~/.config/openstack/clouds.yaml</code>
| |
| :<code>--os-cloud</code> 전역 옵션에 의해 사용되는 설정 파일입니다.
| |
|
| |
| ;<code>~/.config/openstack/clouds-public.yaml</code>
| |
| :인증 URL 및 서비스 정의와 같은 공개 클라우드 제공자 정보를 포함하는 설정 파일입니다. 이 파일의 내용은 공개적이고 공유가능해야 합니다. <code>clouds.yaml</code> 파일은 여기 정의된 클라우드를 참조하여 단축키로 사용할 수 있습니다.
| |
|
| |
| ;<code>/.openstack</code>
| |
| :미래의 로컬 상태 디렉토리를 위한 플레이스홀더입니다. 이 디렉토리는 여러 OpenStack 관련 애플리케이션 간에 공유되도록 의도되었으며, 내용에는 해당 애플리케이션에서 식별자를 사용하여 네임스페이스가 지정됩니다. 공유된 내용(<code>/.openstack/cache</code>와 같은)에는 접두어가 없으며, 컨텐츠는 포터블이어야 합니다.
| |
|
| |
| ==환경변수== | | ==환경변수== |
| 다음 환경변수를 세팅하면 '''openstack'''의 동작을 변경할 수 있습니다. 대부분의 환경변수는 세팅된 경우 우선순위를 갖는 해당 명령줄 옵션이 있습니다.
| |
|
| |
| ;<code>OS_CLOUD</code>
| |
| :<code>clouds.yaml</code>에 있는 클라우드 설정의 이름입니다.
| |
|
| |
| ;<code>OS_AUTH_PLUGIN</code>
| |
| :Identity 서비스에 연결할 때 사용할 인증 플러그인입니다. 플러그인의 버전은 Identity API 버전과 일치해야 합니다.
| |
|
| |
| ;<code>OS_AUTH_URL</code>
| |
| :인증 URL
| |
|
| |
| ;<code>OS_AUTH_TYPE</code>
| |
| :인증 과정을 처리하는 데 사용될 인증 플러그인을 정의합니다. 다음 중 하나입니다:
| |
| :* <code>v2password</code>
| |
| :* <code>v2token</code>
| |
| :* <code>v3password</code>
| |
| :* <code>v3token</code>
| |
| :* <code>v3oidcclientcredentials</code>
| |
| :* <code>v3oidcpassword</code>
| |
| :* <code>v3oidcauthorizationcode</code>
| |
| :* <code>v3oidcaccesstoken</code>
| |
| :* <code>v3totp</code>
| |
| :* <code>v3tokenlessauth</code>
| |
| :* <code>v3applicationcredential</code>
| |
| :* <code>v3multifactor</code>
| |
|
| |
| ;<code>OS_ENDPOINT</code>
| |
| :(서비스 토큰을 사용할 때의) 서비스 엔드포인트입니다.
| |
|
| |
| ;<code>OS_DOMAIN_NAME</code>
| |
| :도메인 수준의 인증 범위 (이름 또는 ID)
| |
|
| |
| ;<code>OS_PROJECT_NAME</code>
| |
| :프로젝트 수준의 인증 범위 (이름 또는 ID)
| |
|
| |
| ;<code>OS_PROJECT_DOMAIN_NAME</code>
| |
| :프로젝트가 포함된 도메인 이름 또는 ID
| |
|
| |
| ;<code>OS_USERNAME</code>
| |
| :인증 사용자명
| |
|
| |
| ;<code>OS_TOKEN</code>
| |
| :인증된 또는 서비스 토큰
| |
|
| |
| ;<code>OS_PASSWORD</code>
| |
| :인증 패스워드
| |
|
| |
| ;<code>OS_USER_DOMAIN_NAME</code>
| |
| :사용자가 포함된 도메인의 이름 또는 ID
| |
|
| |
| ;<code>OS_TRUST_ID</code>
| |
| :신뢰할 수 있는 사용자로 사용할 트러스트 ID
| |
|
| |
| ;<code>OS_DEFAULT_DOMAIN</code>
| |
| :기본 도메인 ID (기본값: ‘default’)
| |
|
| |
| ;<code>OS_REGION_NAME</code>
| |
| :인증 리전 이름
| |
|
| |
| ;<code>OS_CACERT</code>
| |
| :CA 인증서 번들 파일
| |
|
| |
| ;<code>OS_CERT</code>
| |
| :클라이언트 인증서 번들 파일
| |
|
| |
| ;<code>OS_KEY</code>
| |
| :클라이언트 인증서 키 파일
| |
|
| |
| ;<code>OS_IDENTITY_API_VERSION</code>
| |
| :Identity API 버전 (기본값: 2.0)
| |
|
| |
| ;<code>OS_XXXX_API_VERSION</code>
| |
| :설치된 API 라이브러리에 따라 추가 API 버전 옵션을 사용할 수 있습니다.
| |
|
| |
| ;<code>OS_INTERFACE</code>
| |
| :인터페이스 유형입니다. 유효한 옵션은 public, admin, internal입니다.
| |
|
| |
| ;<code>OS_PROTOCOL</code>
| |
| :연합 인증 프로세스를 실행하는 데 사용되는 프로토콜을 정의합니다. Keystone 인증 URL 생성 과정에 사용됩니다.
| |
|
| |
| ;<code>OS_IDENTITY_PROVIDER</code>
| |
| :사용할 페더레이션의 신원 제공자를 정의합니다. Keystone 인증 URL 생성 과정에 사용됩니다. 사용할 수 있는 신원 제공자는 '''openstack identity provider list''' 명령어를 사용하여 나열할 수 있습니다.
| |
|
| |
| ;<code>OS_CLIENT_ID</code>
| |
| :Identity Provider에서 애플리케이션(OpenStack)을 인증하는 데 CLI가 사용할 <code>CLIENT_ID</code>를 설정합니다. 이 값은 Identity Provider 측에서 정의됩니다. 사용자 ID와 혼동하지 마십시오.
| |
|
| |
| ;<code>OS_CLIENT_SECRET</code>
| |
| :CLI(신원 제공자에 있는 OpenStack 시크릿)를 인증하는 데 CLI가 사용할 OS_CLIENT_SECRET을 설정합니다.
| |
|
| |
| ;<code>OS_OPENID_SCOPE</code>
| |
| :서비스 제공자(SP)인 OpenStack이 신원 제공자에게 요청할 속성 스코프를 구성합니다. 이 스코프와 각 스코프가 포함하는 속성은 신원 제공자 측에서 정의됩니다. 이 매개변수는 공백으로 구분된 여러 값을 받을 수 있습니다.
| |
|
| |
| ;<code>OS_ACCESS_TOKEN_TYPE</code>
| |
| :토큰 검사 과정에서 사용되는 액세스 토큰 유형을 정의합니다. 이 변수는 “access_token” 또는 “id_token” 상태 중 하나를 가질 수 있습니다.
| |
|
| |
| ;<code>OS_DISCOVERY_ENDPOINT</code>
| |
| :신원 제공자의 발견 URL을 설정합니다. 이 URL은 신원 제공자 엔드포인트를 설명하는 메타데이터가 포함된 발견 문서를 제공합니다. 이 변수는 <code>OS_ACCESS_TOKEN_ENDPOINT</code>가 정의된 경우 선택사항입니다.
| |
|
| |
| ;<code>OS_ACCESS_TOKEN_ENDPOINT</code>
| |
| :<code>OS_DISCOVERY_ENDPOINT</code> URL 요청에서 조회된 문서에 표시된 값을 재정의합니다. 이 변수는 <code>OS_DISCOVERY_ENDPOINT</code>가 설정된 경우 선택사항입니다.
| |
|
| |
| {{NOTE}}
| |
| novaclient, neutronclient 등 프로젝트별 클라이언트에서 openstackclient로 전환하는 경우 OS_ENDPOINT_TYPE 대신 OS_INTERFACE를 사용하십시오.
| |
| {{/NOTE}}
| |
|
| |
| ==버그== | | ==버그== |
| 버그 리포트는 python-openstackclient Launchpad 프로젝트 https://bugs.launchpad.net/python-openstackclient 에서 접수됩니다.
| |
|
| |
| ==저자== | | ==저자== |
| OpenStackClient와 함께 배포된 AUTHORS 파일을 참조하십시오.
| |
|
| |
| ==저작권== | | ==저작권== |
| Copyright 2011-2014 OpenStack 재단 및 AUTHORS 파일에 나열된 저자들.
| |
|
| |
| ==라이선스== | | ==라이선스== |
| http://www.apache.org/licenses/LICENSE-2.0
| |
|
| |
| ==같이 보기== | | ==같이 보기== |
| [[OpenStack Docs]]의 [[OpenStackClient 페이지]]에 추가 문서가 포함되어 있습니다.
| |
|
| |
| 개별 OpenStack 프로젝트 CLI, OpenStack API 참고자료.
| |