요즘 Openstack을 설치하고, 운영하면서 Glance라는 녀석과 매일 싸우고 있다. 그러면서, 자연스럽게 Glance 명령어 옵션에는 무엇이 있을까? 라는 의문을 갖게 되고, 관련된 문서를 찾아보고 하면서 알게된 Glance 명령어 옵션들을 정리해 보았다. Openstack을 운영하거나 스터디하는 사람들에게 도움이 되길 바라며서 블로그에 자료를 공유한다.
glance --help를 입력하면 아래와 같은 glance 명령어 옵션을 확인할 수 있다. 나는 아래에 있는 이 명령어 옵션들에 대한 사용법은 어떤 것이고, 더 입력해야할 파라메터는 어떤것들이 있는지, 그리고, 사용 예제까지 아주 꼼꼼하게 분석해 보았다.
** Glance 명령어 옵션
|
add DEPRECATED! Use image-create
instead.
clear DEPRECATED!
delete DEPRECATED! Use image-delete
instead.
details DEPRECATED! Use image-list
instead.
image-create Create a new image.
image-delete Delete a specific image.
image-download Download a specific image.
image-list List images you can access.
image-members DEPRECATED! Use member-list instead.
image-show Describe a specific image.
image-update Update a specific image.
index DEPRECATED! Use image-list
instead.
member-add DEPRECATED! Use member-create
instead.
member-create Share a specific image with a tenant.
member-delete Remove a shared image from a tenant.
member-images DEPRECATED! Use member-list instead.
member-list Describe sharing permissions by
image or tenant.
members-replace DEPRECATED!
show DEPRECATED! Use image-show
instead.
update DEPRECATED! Use image-update
instead.
help Display help about this
program or one of its
subcommands.
|
Add : image-create와 같은 명령어로 Glance 저장공간으로 이미지를 추가한다.
- 공식
|
$ glance add name=”{image name}” is_public=true
container_format={container format} disk_format={disk format} < {image
file name}
|
- 파라메터
설명
|
{image name}
|
사용자가 식별하기 쉬운 OS Image명을 입력한다.
|
|
{container format}
|
Container format에는 ari, ami, aki, bare가 있으며, ari는 RAMDISK, ami는 KERNEL, aki는 RamDisk와 Kernel 을 가지고 있는 image 를 올릴 때 사용한다. 대표적인 Linux OS로 cirros가 있다. kernel이나 ramdisk가 없는 일반 img 파일은 모두 bare로 입력하면 된다.
|
|
{disk format}
|
Disk format역시
ari, ami, aki가 있으며, 이외에 확장자에 따라 img파일은 raw, qcow2 파일은 qcow2 로 표현한다.
|
|
{image file name}
|
업로드 할 OS Image 명을 입력하면 된다. 단 업로드 할 이미지는 현재 실행디렉토리에 있어야만 한다. 만일
다른 디렉토리에 이미지가 있다면 해당 경로를 전부 써 주어야 한다.
|
- 예제
|
$ glance add name=”Ubuntu 12.04 LTS” is_public=true
container_format=bare disk_format=raw
< ubuntu-12.04-server-cloudimg-amd64-disk1.img
Added new image with ID : ca5b58ac-e97c-437c-b06e-f195159ab475
|
Clear : glance 저장공간에 업로드
되어 있는 모든 image를 삭제한다.
- 공식
|
$ glance clear
Deleting image 0449eee2-8081-48a8-a7b3-ae679dee1b57 “cirros-0.3.0-x86_64-uec-ramdisk”
… done
…
Completed in 0.0328 sec.
|
Delete : 특정 이미지를 삭제할 경우 delete 명령을 사용하는데 image-delete와 같다.
- 공식
|
$ glance delete {image id}
|
- 파라메터
설명
|
{image id}
|
glance image-list에서 조회되는 ID를 입력하면 된다.
|
- 예제
|
$ glance delete ca5b58ac-e97c-437c-b06e-f195159ab475
Deleted image ca5b58ac-e97c-437c-b06e-f195159ab475
|
Details : glance 저장공간에 업로드
되어 있는 모든 image의 상세정보를 확인할 수 있다.
- 공식
및 예제
|
$ glance details
====================================================================
URI:
http://211.111.174.182:9292/v1/images/ca5b58ac-e97c-437c-b06e-f195159ab475
Id: ca5b58ac-e97c-437c-b06e-f195159ab475
Public: Yes
Protected: No
Name: Ubuntu 12.04 LTS
Status: active
Size: 226426880
Disk format: qcow2
Container format: ovf
Minimum Ram Required (MB): 0
Minimum Disk Required (GB): 0
Owner: 8855a00a79414352bc033697e6ccd2e8
Created at: 2012-10-09T08:34:05
Deleted at: None
Updated at: 2012-10-09T08:34:07
====================================================================
|
Image-create : glance 저장공간으로
이미지를 추가한다.
- 공식
|
$ glance
image-create –name ”{image name}” --public --container_format {container
format} --disk_format {disk format}
< {image file name}
|
- 파라메터
설명 : 파라메터는 add 명령어의 파라메터와 같으므로 생략~!
- 예제
|
$ glance image-create –name ”Ubuntu 12.04 LST” --public
--container_format bare --disk_format raw < ubuntu-12.04-server-cloudimg-amd64-disk1.img
+------------------+--------------------------------------+
| Property
| Value
|
+------------------+--------------------------------------+
| checksum
| 44e30efc9e9450b39eea0a42ecd44c7a
|
| container_format | bare |
| created_at
| 2012-09-27T04:59:49
|
| deleted
| False
|
| deleted_at
| None
|
| disk_format
| raw
|
| id
| c01e2c2e-5d4d-4a03-a76e-ada8622fa414 |
| is_public
| True
|
| min_disk | 0 |
| min_ram
| 0
|
| name
| Ubuntu 12.04 LTS |
| owner
| 4aafa99227af447d9041ff38a3c1e687
|
| protected
| False |
| size
| 219340260
|
| status
| active
|
| updated_at
| 2012-09-27T04:59:51
|
+------------------+--------------------------------------+
|
Image-delete : 위에서 살펴본 delete 명령어와 같이 특정 이미지를 삭제한다.
- 예제
|
$ glance image-delete ca5b58ac-e97c-437c-b06e-f195159ab475
Deleted image ca5b58ac-e97c-437c-b06e-f195159ab475
|
Image-download : Help에는 특정이미지
파일을 로컬 폴더로 다운로드 받는다고 나오나 아직은 제대로 구현이 되어 있지 않으므로 실행하지 않길 바란다.
- 공식
|
$ glance image-download {image id}
|
- 파라메터
설명
|
{image id}
|
glance image-list에서 조회되는 ID를 입력하면 된다.
|
Image-list : glance 저장공간에
업로드 되어 있는 모든 이미지 목록을 보여준다.
- 공식
및 예제
|
$ glance image-list
+--------------------------------------+---------------------------------+-------------+------------------+-----------++
| ID |
Name | Disk
Format | Container Format | Size
||
+--------------------------------------+---------------------------------+-------------+------------------+-----------++
| 0449eee2-8081-48a8-a7b3-ae679dee1b57 |
cirros-0.3.0-x86_64-uec-ramdisk | ari
| ari |
2254249 ||
| a9aa8c3d-c6d8-472a-b76e-33bdfb7ee038 |
cirros-0.3.0-x86_64-uec |
ami | ami | 25165824 ||
| c6c42034-370a-488a-a08d-83ef1713b5f4 |
cirros-0.3.0-x86_64-uec-kernel |
aki | aki | 4731440 ||
| ca5b58ac-e97c-437c-b06e-f195159ab475 | Ubuntu 12.04
LTS | qcow2 | ovf | 226426880 ||
+--------------------------------------+---------------------------------+-------------+------------------+-----------++
|
Image-members : 특정 이미지를 쉐어한 User가 누구인지를 확인할 수 있다.
- 공식
$ glance image-members {image id} |
- 파라메터 설명
{image id} | glance image-list에서 조회되는 ID를 입력하면 된다. |
- 예제
$ glance image-members
ca5b58ac-e97c-437c-b06e-f195159ab475
admin
nalee |
Image-show : 특정 이미지의 상세정보를
확인할 수 있다.
- 공식
|
$ glance image-show {image id}
|
- 파라메터
설명
|
{image id}
|
glance image-list에서 조회되는 ID를 입력하면 된다.
|
- 예제
|
$ glance image-show
a9aa8c3d-c6d8-472a-b76e-33bdfb7ee038
+-----------------------+--------------------------------------+
| Property | Value |
+-----------------------+--------------------------------------+
| Property 'kernel_id' | c6c42034-370a-488a-a08d-83ef1713b5f4 |
| Property 'ramdisk_id' |
0449eee2-8081-48a8-a7b3-ae679dee1b57 |
| checksum | 2f81976cae15c16ef0010c51e3a6c163 |
| container_format | ami |
| created_at | 2012-10-09T08:23:22 |
| deleted | False |
| disk_format | ami |
| id |
a9aa8c3d-c6d8-472a-b76e-33bdfb7ee038 |
| is_public | True |
| min_disk | 0 |
| min_ram | 0 |
| name |
cirros-0.3.0-x86_64-uec |
| owner |
8855a00a79414352bc033697e6ccd2e8 |
| protected | False |
| size | 25165824 |
| status | active |
| updated_at | 2012-10-09T08:23:23 |
+-----------------------+--------------------------------------+
|
Image-update : 이 명령어를 이용하면
특정 이미지의 정보나 이미지 파일을 다른 파일로 변경할 수 있다.
- 공식
|
$ glance image-update [--name <NAME>]
[--disk-format <CONTAINER_FORMAT>]
[--container-format <DISK_FORMAT>]
[--owner
<TENANT_ID>] [--size <SIZE>]
[--min-disk <DISK_GB>] [--min-ram
<DISK_RAM>]
[--location
<IMAGE_URL>] [--file <FILE>]
[--checksum
<CHECKSUM>] [--copy-from <IMAGE_URL>]
[--is-public
IS_PUBLIC]
[--is-protected IS_PROTECTED]
[--property
<key=value>] [--purge-props]
<IMAGE_ID>
|
- 파라메터
설명
|
[--name
<NAME>]
|
사용자가 식별하기 쉬운 OS Image명을 입력한다.
|
|
[--container-format
<CONTAINER_FORMAT>]
|
Container format에는 ari, ami, aki, bare가 있으며, ari는 RAMDISK, ami는 KERNEL, aki는 RamDisk와 Kernel 을 가지고 있는 image 를 올릴 때 사용한다. 대표적인 Linux OS로 cirros가 있다. kernel이나 ramdisk가 없는 일반 img 파일은 모두 bare로 입력하면 된다.
|
|
[--container-format
<DISK_FORMAT>]
|
Disk format역시
ari, ami, aki가 있으며, 이외에 확장자에 따라 img파일은 raw, qcow2 파일은 qcow2 로 표현한다.
|
|
[--owner
<TENANT_ID>]
|
해당 이미지의 member id를 입력한다. 하지만 대체적으로는 생략한다.
|
|
[--size
<SIZE>]
|
이미지 사이즈 정보로 생략한다.
|
|
[--min-disk
<DISK_GB>]
|
최소사양의 DISK 사이즈를 GB단위로 입력한다.
|
|
[--min-ram
<DISK_RAM>]
|
최소사양의 RAM 사이즈를 입력한다.
|
|
[--location
<IMAGE_URL>]
|
업로드하고자 하는 원격이미지 웹 URL을 입력한다.
|
|
[--file
<FILE>]
|
업로드하고자 하는 파일이 로컬에 있을 경우 해당 이미지 파일명을 입력한다.
|
|
[--checksum
<CHECKSUM>]
|
Checksum을 입력하는데 대체적으로 생략한다.
|
|
[--copy-from
<IMAGE_URL>]
|
Location과 같이 원격 이미지 웹 URL을 입력한다.
|
|
[--is-public
IS_PUBLIC]
|
이미지를 공개한다는 뜻이다.
|
|
[--is-protected
IS_PROTECTED]
|
같은 tenant member에게만 이미지를 공개한다는 뜻이다.
|
|
[--property
<key=value>]
|
RamDisk 파일과
Kernel 파일이 있을 경우 속성으로 그 값을 입력한다.
ex) --property
kernel_id=7edc921d-53d9-4fa2-9a9d-31cad37de01f
|
|
[--purge-props]
|
다른 속성값이 있으면 계속 속성을 입력한다.
|
|
<IMAGE_ID>
|
변경하고자 하는 image id를 입력한다.
|
Index : index 명령어 역시 image-list와 같은 역할을 하며 다음과 같은 정보를 확인할 수 있다.
|
$ glance index
ID Name Disk Format Container Format Size
------------------------------------
------------------------------ -------------------- --------------------
--------------
ca5b58ac-e97c-437c-b06e-f195159ab475 Ubuntu 12.04
LTS qcow2 ovf 226426880
a9aa8c3d-c6d8-472a-b76e-33bdfb7ee038
cirros-0.3.0-x86_64-uec ami ami 25165824
0449eee2-8081-48a8-a7b3-ae679dee1b57
cirros-0.3.0-x86_64-uec-ramdis ari ari 2254249
c6c42034-370a-488a-a08d-83ef1713b5f4
cirros-0.3.0-x86_64-uec-kernel aki aki 4731440
|
Member-add : member를 추가시키는
명령어로 member-create 와 같은 명령어이다.
- 공식
|
$ glance member-add [--can-share] image_id member_id
|
- 파라메터
설명
|
image_id
|
멤버를 추가하고자 하는 이미지 id를 입력한다.
|
|
member_id
|
추가하고자 하는 tenant 명을 입력한다.
|
|
[--can-share]
|
해당 옵션을 넣은 사용자는 이미지를 쉐어할 수 있다.
|
- 예제
|
$ glance member-add
ca5b58ac-e97c-437c-b06e-f195159ab475 nalee
|
Member-create : member-add와
같은 명령어이다.
- 공식
|
$ glance member-create [--can-share] <IMAGE_ID>
<TENANT_ID>
|
- 파라메터
설명
|
<IMAGE_ID>
|
멤버를 추가하고자 하는 이미지 id를 입력한다.
|
|
<TENANT_ID>
|
추가하고자 하는 tenant 명을 입력한다.
|
|
[--can-share]
|
해당 옵션을 넣은 사용자는 이미지를 쉐어할 수 있다.
|
- 예제
|
$ glance member-create
ca5b58ac-e97c-437c-b06e-f195159ab475 admin
|
Member-delete : 특정 이미지의 특정
사용자를 삭제할 때 사용하는 명령어이다.
- 공식
|
$ glance member-delete <IMAGE_ID>
<TENANT_ID>
|
- 파라메터
설명
|
<IMAGE_ID>
|
삭제하고자 하는 이미지 id를 입력한다.
|
|
<TENANT_ID>
|
삭제하고자 하는 tenant 명을 입력한다.
|
- 예제
|
$ glance member-images <member-id>
|
Member-images : 특정 사용자만 사용할
수 있는 이미지 목록을 보여준다.
- 공식
|
$ glance member-images <member-id>
|
- 파라메터
설명
|
<member_id>
|
검색하고자 하는 tenant 명을 입력한다.
|
- 예제
|
$ glance member-images admin
ca5b58ac-e97c-437c-b06e-f195159ab475
|
Member-list : 특정 이미지나 특정
사용자의 이미지 목록을 보여준다.
- 공식
|
$ glance member-list -–image-id <IMAGE_ID> or -–member-id
<TENANT_ID>
|
- 파라메터
설명
|
<IMAGE_ID>
|
검색하고자 하는 이미지 id를 입력한다.
|
|
<TENANT_ID>
|
검색하고자 하는 tenant 명을 입력한다.
|
- 예제
|
$ glance member-list --image-id
ca5b58ac-e97c-437c-b06e-f195159ab475
+--------------------------------------+-----------+-----------+
| Image ID | Member ID |
Can Share |
+--------------------------------------+-----------+-----------+
| ca5b58ac-e97c-437c-b06e-f195159ab475 | admin | |
| ca5b58ac-e97c-437c-b06e-f195159ab475 | nalee | |
+--------------------------------------+-----------+-----------+
|
Members-replace : 본 명령어를
통해 해당 이미지의 사용자 정보 중 이미지 쉐어 여부를 수정할 수 있다고 Help 명령어에는 나오나
직접 실행을 해 보면 이 명령어는 사라지고 없음을 바로 확인할 수 있다.
Show : 특정 이미지의 상세 정보를 확인할
수 있는 명령어로 image-show와 같은 역할을 한다.
- 공식
- 예제
|
$ glance show ca5b58ac-e97c-437c-b06e-f195159ab475
URI:
http://211.111.174.182:9292/v1/images/ca5b58ac-e97c-437c-b06e-f195159ab475
Id: ca5b58ac-e97c-437c-b06e-f195159ab475
Public: No
Protected: No
Name: Ubuntu 12.04 LTS
Status: active
Size: 226426880
Disk format: qcow2
Container format: ovf
Minimum Ram Required (MB): 0
Minimum Disk Required (GB): 0
Owner: 8855a00a79414352bc033697e6ccd2e8
Created at: 2012-10-09T08:34:05
Updated at: 2012-10-23T02:42:29
|
Update : image-update와 같은
명령어로 특정 이미지의 메타정보나 이미지 파일을 변경할 때 사용하는 명령어이다.
- 공식
|
$ glance update <IMAGE_ID>
|
- 예제
|
$ glance -v update
ca5b58ac-e97c-437c-b06e-f195159ab475 is_public=true
Updated image ca5b58ac-e97c-437c-b06e-f195159ab475
Updated image metadata for image
ca5b58ac-e97c-437c-b06e-f195159ab475:
URI:
http://211.111.174.182:9292/v1/images/ca5b58ac-e97c-437c-b06e-f195159ab475
Id: ca5b58ac-e97c-437c-b06e-f195159ab475
Public: Yes
Protected: No
Name: Ubuntu 12.04 LTS
Status: active
Size: 226426880
Disk format: qcow2
Container format: ovf
Minimum Ram Required (MB): 0
Minimum Disk Required (GB): 0
Owner: 8855a00a79414352bc033697e6ccd2e8
Created at: 2012-10-09T08:34:05
Deleted at: None
Updated at: 2012-10-23T05:46:53
|
Help : 명령어 옵션의 상세 설명 또는 들어가야
할 파라메터 정보등을 알려준다.
- 예제
|
$ glance help image-create
usage: glance image-create [--id <IMAGE_ID>]
[--name <NAME>]
[--disk-format
<DISK_FORMAT>]
[--container-format <CONTAINER_FORMAT>]
[--owner
<TENANT_ID>] [--size <SIZE>]
[--min-disk
<DISK_GB>] [--min-ram <DISK_RAM>]
[--location
<IMAGE_URL>] [--file <FILE>]
[--checksum
<CHECKSUM>] [--copy-from <IMAGE_URL>]
[--is-public IS_PUBLIC]
[--is-protected
IS_PROTECTED]
[--property
<key=value>]
Create a new image.
Optional arguments:
--id
<IMAGE_ID> ID of image to
reserve.
--name
<NAME> Name of image.
--disk-format
<DISK_FORMAT>
Disk format of image.
--container-format <CONTAINER_FORMAT>
Container format of
image.
--owner
<TENANT_ID> Tenant who should
own image.
--size
<SIZE> Size of image data
(in bytes). Only used with '--
location' and
'--copy_from'.
--min-disk
<DISK_GB> Minimum size of disk
needed to boot image (in
gigabytes).
--min-ram
<DISK_RAM> Minimum amount of ram
needed to boot image (in
megabytes).
--location
<IMAGE_URL>
URL where the data
for this image already resides. For
example, if the image
data is stored in the filesystem
local to the glance
server at
'/usr/share/image.tar.gz', you would specify
'file:///usr/share/image.tar.gz'.
--file
<FILE> Local file that
contains disk image to be uploaded
during creation.
Alternatively, images can be passed
to the client via
stdin.
--checksum
<CHECKSUM>
Hash of image data
used Glance can use for
verification.
--copy-from
<IMAGE_URL>
Similar to
'--location' in usage, but this indicates
that the Glance
server should immediately copy the
data and store it in
its configured image store.
--is-public
IS_PUBLIC
Make image accessible
to the public.
--is-protected IS_PROTECTED
Prevent image from
being deleted.
--property
<key=value>
Arbitrary property to
associate with image. May be
used multiple times.
|
** Glance의 Help의 명령어를 보면 DEPRECATED! 라고 써있는 명령어 옵션을 볼 수 있을 것이다.이
말 뜻은 “곧 폐지될 예정이므로, 그 옆에 나와있는 명령어
옵션을 쓰길 권고한다.”는 뜻이다.
참조 URL : http://docs.openstack.org/developer/glance/glance.html
