다음을 통해 공유

갤러리 리소스 나열, 업데이트 및 삭제

  • 아티클

Azure CLI 또는 Azure PowerShell 사용하여 Azure Compute Gallery(이전의 Shared Image Gallery) 리소스를 관리할 수 있습니다.

공유한 갤러리 나열

구독과 공유된 갤러리를 나열합니다.

region=westus
az sig list-shared --location $region

테넌트와 공유된 갤러리를 나열합니다.

region=westus
az sig list-shared --location $region --shared-to tenant

출력에는 공유되는 갤러리의 공용 name 및 uniqueID가 포함됩니다. 갤러리의 이름을 사용하여 갤러리를 통해 사용할 수 있는 이미지를 쿼리할 수 있습니다.

다음은 출력 예제입니다.

[
  {
    "location": "westus",
    "name": "1231b567-8a99-1a2b-1a23-123456789abc-MYDIRECTSHARED",
    "uniqueId": "/SharedGalleries/1231b567-8a99-1a2b-1a23-123456789abc-MYDIRECTSHARED"
  }
]

리소스 업데이트

업데이트할 수 있는 항목에는 몇 가지 제한 사항이 있습니다. 다음 항목을 업데이트할 수 있습니다.

Azure Compute Gallery:

  • 설명

이미지 정의:

  • 권장 vCPU
  • 권장 메모리
  • 설명
  • 수명 주기 끝

이미지 버전:

  • 지역 복제본 수
  • 대상 지역
  • 최신에서 제외
  • 수명 주기 끝

(az sig update를 사용하여 갤러리에 대한 설명을 업데이트합니다.

az sig update \
   --gallery-name myGallery \
   --resource-group myGalleryRG \
   --set description="My updated description."

az sig image-definition update를 사용하여 이미지 정의에 대한 설명을 업데이트합니다.

az sig image-definition update \
   --gallery-name myGallery\
   --resource-group myGalleryRG \
   --gallery-image-definition myImageDefinition \
   --set description="My updated description."

az sig image-version update를 사용하여 복제할 지역을 추가하도록 이미지 버전을 업데이트합니다. 이 변경 내용은 이미지가 새 지역에 복제될 때까지 시간이 오래 걸립니다.

az sig image-version update \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --add publishingProfile.targetRegions  name=eastus

이 예제에서는 az sig image-version update를 사용하여 이 이미지 버전을 최신 이미지로 사용되지 않도록 제외하는 방법을 보여줍니다.

az sig image-version update \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --set publishingProfile.excludeFromLatest=true

이 예제에서는 az sig image-version update를 사용하여 이 이미지 버전을 최신 이미지로 고려하는 방법을 보여줍니다.

az sig image-version update \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --set publishingProfile.excludeFromLatest=false

리소스 삭제

먼저 이미지 버전을 삭제하여 리소스를 역순으로 삭제해야 합니다. 모든 이미지 버전이 삭제되면 이미지 정의를 삭제할 수 있습니다. 모든 이미지 정의가 삭제되면 갤러리를 삭제할 수 있습니다.

커뮤니티 공유 갤러리를 삭제하려면 az sig share reset을 사용하여 갤러리 공유를 공개적으로 중지해야 합니다.

az sig image-version delete를 사용하여 이미지 버전을 삭제합니다.

az sig image-version delete \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0

az sig image-definition delete를 사용하여 이미지 정의를 삭제합니다.

az sig image-definition delete \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition

az sig delete를 사용하여 갤러리를 삭제합니다.

az sig delete \
   --resource-group myGalleryRG \
   --gallery-name myGallery

커뮤니티 갤러리

Important

Azure Compute Gallery – 커뮤니티 갤러리는 현재 미리 보기 상태이며 Azure Compute Gallery - 커뮤니티 갤러리 미리 보기 약관이 적용됩니다.

커뮤니티 갤러리를 게시하려면 Azure 구독에서 미리 보기 기능을 설정해야 합니다. 커뮤니티 갤러리 이미지에서 VM을 만드는 것은 모든 Azure 사용자에게 열려 있습니다.

자신의 갤러리를 나열하고 커뮤니티 갤러리의 공개 이름을 출력하려면 다음을 수행합니다.

az sig list --query [*]."{Name:name,PublicName:sharingProfile.communityGalleryInfo.publicNames}"

참고 항목

최종 사용자로서 커뮤니티 갤러리의 공용 이름을 가져오려면 현재 포털을 사용해야 합니다. 가상 머신>만들기>Azure 가상 머신>이미지>모든 이미지 보기>커뮤니티 이미지>공용 갤러리 이름으로 이동합니다.

az sig image-definition list-community를 사용하여 커뮤니티 갤러리에서 사용할 수 있는 모든 이미지 정의를 나열합니다.

이 예제에서는 미국 서부의 ContosoImage 갤러리에 있는 모든 이미지와 VM, OS 및 OS 상태를 만드는 데 필요한 고유 ID를 이름별로 나열합니다.

 az sig image-definition list-community \
   --public-gallery-name "ContosoImages-1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f" \
   --location westus \
   --query [*]."{Name:name,ID:uniqueId,OS:osType,State:osState}" -o table

az sig image-version list-community를 사용하여 커뮤니티 갤러리에서 공유된 이미지 버전을 나열합니다.

az sig image-version list-community \
   --location westus \
   --public-gallery-name "ContosoImages-1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f" \
   --gallery-image-definition myImageDefinition \
   --query [*]."{Name:name,UniqueId:uniqueId}" \
   -o table

직접 공유 갤러리

Important

Azure Compute Gallery – 직접 공유 갤러리는 현재 미리 보기에 있으며 Azure Compute Gallery에 대한 미리 보기 사용 약관이 적용됩니다.

미리 보기 중에 이미지를 직접 공유 갤러리에 게시하려면 https://aka.ms/directsharedgallery-preview에서 등록해야 합니다. 직접 공유 갤러리에서 VM을 만드는 것은 모든 Azure 사용자에게 공개되어 있습니다.

미리 보기 중에 sharingProfile.permissions 속성이 Groups로 설정된 새 갤러리를 만들어야 합니다. CLI를 사용하여 갤러리를 만드는 경우 --permissions groups 매개 변수를 사용합니다. 기존 갤러리를 사용할 수 없으며 현재 속성을 업데이트할 수 없습니다.

공유되는 갤러리의 uniqueID를 찾으려면 az sig list-shared를 사용합니다. 다음 예제에서는 미국 서부 지역의 갤러리를 찾고 있습니다.

region=westus
az sig list-shared --location $region --query "[].uniqueId" -o tsv

사용자와 직접 공유되는 모든 이미지 정의를 나열하고 az sig image-definition list-shared를 사용합니다.

이 예제에서는 미국 서부의 갤러리에 있는 모든 이미지와 VM, OS 및 OS 상태를 만드는 데 필요한 고유 ID를 이름별로 나열합니다.

name="1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f-myDirectShared"
 az sig image-definition list-shared \
   --gallery-unique-name $name
   --location $region \
   --query [*]."{Name:name,ID:uniqueId,OS:osType,State:osState}" -o table

az sig image-version list-shared를 사용하여 직접 공유된 이미지 버전을 나열합니다.

imgDef="myImageDefinition"
az sig image-version list-shared \
   --location $region \
   --public-gallery-name $name \
   --gallery-image-definition $imgDef \
   --query [*]."{Name:name,UniqueId:uniqueId}" \
   -o table

다음 단계