Criar uma galeria para armazenar e compartilhar imagens

Uma Galeria de Computação do Azure (anteriormente conhecida como Galeria de Imagens Compartilhadas) simplifica o compartilhamento de recursos, como imagens e pacotes de aplicativos, em sua organização.

A Galeria de Computação do Azure permite compartilhar imagens personalizadas da VM e pacotes de aplicativos com outras pessoas em sua organização, dentro ou entre regiões, em um locatário. Escolha o que você deseja compartilhar, em quais regiões deseja torná-las disponíveis e com quem deseja compartilhá-las. Você pode criar várias galerias a fim de agrupar logicamente os recursos.

A galeria é um recurso de nível superior que pode ser compartilhado de várias maneiras:

Compartilhamento com:	Pessoas	Grupos	Entidade de Serviço	Todos os usuários em uma assinatura (ou) um locatário específico	Publicamente com todos os usuários do Azure
Compartilhamento RBAC	Sim	Sim	Sim	No	No
RBAC + galeria compartilhada direta	Sim	Sim	Sim	Sim	No
RBAC + galeria da comunidade	Sim	Sim	Sim	No	Sim

Nomenclatura

Os caracteres permitidos para o nome da galeria são letras maiúsculas (A-Z) e minúsculas (a-z), dígitos (0-9), pontos (ou pontos finais) .e sublinhados _. O nome da galeria não pode conter traços -. Os nomes das galerias devem ser exclusivos dentro de sua assinatura.

Criar uma galeria privada

Portal

1. Entre no portal do Azure.
2. Digite Galeria de Computação do Azure na caixa de pesquisa e selecione Galeria de Computação do Azure nos resultados.
3. Na página Galeria de Computação do Azure, selecione Adicionar.
4. Na página Criar Galeria de Computação do Azure, selecione a assinatura correta.
5. No Grupo de recursos, selecione um grupo de recursos na lista suspensa ou selecione Criar novo e digite um nome para o novo grupo de recursos.
6. Em Nome, digite um nome para o nome da galeria.
7. Selecione uma Região na lista suspensa.
8. Você pode digitar uma breve descrição da galeria, como Minha galeria para teste, e clique em Examinar + criar.
9. Depois da aprovação na validação, selecione Criar.
10. Depois que a implantação for concluída, selecione Ir para o recurso.

CLI

Criar uma galeria usando az sig create. O exemplo a seguir cria um grupo de recursos da galeria chamado myGalleryRG no Leste dos EUA, bem como uma galeria chamada myGallery.

az group create --name myGalleryRG --location eastus
az sig create --resource-group myGalleryRG --gallery-name myGallery

PowerShell

Crie uma galeria usando New-AzGallery. O exemplo a seguir cria uma galeria chamada myGallery no grupo de recursos myGalleryRG.

$resourceGroup = New-AzResourceGroup `
   -Name 'myGalleryRG' `
   -Location 'West Central US'	
$gallery = New-AzGallery `
   -GalleryName 'myGallery' `
   -ResourceGroupName $resourceGroup.ResourceGroupName `
   -Location $resourceGroup.Location `
   -Description 'Azure Compute Gallery for my organization'	

REST

Use a API REST para criar um grupo de recursos.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}?api-version=2021-04-01

{
  "location": "eastus"
}

Use a API REST para criar uma galeria.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}?api-version=2019-12-01

{
  "properties": {
    "description": "Azure Compute Gallery for my organization"
  },
  "location": "eastus",
}

Criar uma galeria compartilhada direta

Importante

Galeria de Computação do Azure – as galerias compartilhadas diretas estão atualmente em VERSÃO PRÉVIA e sujeitas aos Termos de Versão Prévia da Galeria de Computação do Azure.

Durante a versão prévia, você precisará criar uma galeria, com a propriedade sharingProfile.permissions definida como Groups. Ao usar a CLI para criar uma galeria, use o parâmetro --permissions groups. Você não pode usar uma galeria existente, a propriedade não pode ser atualizada no momento.

Atualmente, você não pode criar um conjunto de dimensionamento de máquinas virtuais flexível por meio de uma imagem compartilhada com você por outro locatário.

Para começar a compartilhar uma galeria compartilhada direta com uma assinatura ou um locatário, confira Compartilhar uma galeria com uma assinatura ou um locatário.

Portal

1. Entre no portal do Azure.

2. Digite Galeria de Computação do Azure na caixa de pesquisa e selecione Galeria de Computação do Azure nos resultados.

3. Na página Galeria de Computação do Azure, selecione Adicionar.

4. Na página Criar Galeria de Computação do Azure, selecione a assinatura correta.

5. Preencha todos os detalhes na página.

6. Na parte inferior da página, selecione Avançar: Método de compartilhamento.

7. Na guia Compartilhamento, selecione RBAC + compartilhar diretamente.

   

8. Quando terminar, selecione Review + create.

9. Depois da aprovação na validação, selecione Criar.

10. Depois que a implantação for concluída, selecione Ir para o recurso.

Para começar a compartilhar a galeria com uma assinatura ou locatário, consulte Compartilhar uma galeria com uma assinatura ou locatário.

CLI

Para criar uma galeria que possa ser compartilhada com uma assinatura ou um locatário usando uma galeria compartilhada direta, você precisa criar a galeria com o parâmetro --permissions definido como groups.

az sig create \
   --gallery-name myGallery \
   --permissions groups \
   --resource-group myResourceGroup  

Para começar a compartilhar a galeria com uma assinatura ou locatário, consulte Compartilhar uma galeria com uma assinatura ou locatário.

REST

Crie uma galeria para compartilhamento no nível da assinatura ou do locatário usando a API REST do Azure.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{rgName}/providers/Microsoft.Compute/galleries/{gallery-name}?api-version=2020-09-30

{
	"properties": {
		"sharingProfile": {
			"permissions": "Groups"
		}
	},
	"location": "{location}
}

Para começar a compartilhar a galeria com uma assinatura ou locatário, consulte Compartilhar uma galeria com uma assinatura ou locatário.

Redefina o compartilhamento para limpar tudo no sharingProfile.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{rgName}/providers/Microsoft.Compute/galleries/{galleryName}/share?api-version=2020-09-30 

{ 
 "operationType" : "Reset", 
} 

Criar uma galeria da comunidade

Uma galeria da comunidade é compartilhada publicamente com todos. Para criar uma galeria da comunidade, crie a galeria primeiro e habilite-a para compartilhamento. O nome da instância pública da galeria é o prefixo fornecido, além de um GUID exclusivo.

Durante a pré-visualização, crie sua galeria, definições de imagem e versões de imagem na mesma região para compartilhar sua galeria publicamente.

Importante

Galeria de Computação do Azure – as galerias da comunidade estão atualmente em VERSÃO PRÉVIA e sujeitas aos Termos de versão prévia da Galeria de Computação do Azure – galeria da comunidade.

Para publicar uma galeria da comunidade, você precisará configurar a versão prévia dos recursos na sua assinatura do Azure. A criação de VMs a partir da galeria de imagens da comunidade está aberta a todos os usuários do Azure.

Ao criar uma imagem para compartilhá-la com a comunidade, você precisará fornecer informações de contato. Essas informações são mostradas publicamente, portanto, tenha cuidado ao fornecer:

• Prefixo da galeria da comunidade
• Email de suporte do fornecedor
• URL do publicador
• URL do contrato legal

As informações das definições de imagem também ficam disponíveis publicamente, como o que você fornece para o Publicador, a Oferta e o SKU.

Pré-requisitos

Somente o proprietário de uma assinatura, ou um usuário ou entidade de serviço atribuída para a função Compute Gallery Sharing Admin no nível da assinatura ou galeria, pode permitir que uma galeria seja pública para a comunidade. Para atribuir uma função a um usuário, grupo, entidade de serviço ou identidade gerenciada, consulte Etapas para atribuir uma função do Azure.

CLI

O valor --public-name-prefix é usado para criar um nome para a versão pública da galeria. O --public-name-prefix é a primeira parte do nome público, e a última parte será um GUID, criado pela plataforma, que é exclusivo da galeria.

location=westus
galleryName=contosoGallery
resourceGroup=myCGRG
publisherUri=https://www.contoso.com
publisherEmail=support@contoso.com
eulaLink=https://www.contoso.com/eula
prefix=ContosoImages

az group create --name $resourceGroup --location $location

az sig create \
   --gallery-name $galleryName \
   --permissions community \
   --resource-group $resourceGroup \
   --publisher-uri $publisherUri \
   --publisher-email $publisherEmail \
   --eula $eulaLink \
   --public-name-prefix $prefix

A saída desse comando fornece o nome público para sua galeria da comunidade na seção sharingProfile, em publicNames.

Para começar a compartilhar a galeria com todos os usuários do Azure, consulte Compartilhar imagens usando uma galeria da comunidade.

REST

Para criar uma galeria, envie uma solicitação PUT:

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName?api-version=2021-10-01

Especifique permissions como Community e informações sobre sua galeria no corpo da solicitação:

{
  "location": "West US",
  "properties": {
    "description": "This is the gallery description.",
    "sharingProfile": {
      "permissions": "Community",
      "communityGalleryInfo": {
        "publisherUri": "http://www.uri.com",
        "publisherContact": "contact@domain.com",
        "eula": "http://www.uri.com/terms",
        "publicNamePrefix": "Prefix"
      }
    }
  }
}

Para começar a compartilhar a galeria com todos os usuários do Azure, consulte Compartilhar imagens usando uma galeria da comunidade.

Portal

Disponibilizar uma galeria de comunidade para todos os usuários do Azure é um processo em duas etapas. Primeiro, você cria a galeria com o compartilhamento da comunidade habilitado, quando estiver pronto para torná-la pública, você compartilha a galeria.

1. Entre no portal do Azure.

2. Digite Galeria de Computação do Azure na caixa de pesquisa e selecione Galeria de Computação do Azure nos resultados.

3. Na página Galeria de Computação do Azure, clique em Adicionar.

4. Na página Criar Galeria de Computação do Azure, selecione a assinatura correta.

5. Em Grupo de recursos, selecione Criar nova e digite myGalleryRG para o nome.

6. Em Nome, digite myGallery para o nome da galeria.

7. Deixe o padrão Regional.

8. Você pode digitar uma breve descrição da galeria, como Minha galeria para teste.

9. Na parte inferior da página, selecione Avançar: Método de compartilhamento.

10. Na guia Compartilhamento, selecione RBAC + compartilhar para a galeria de comunidade pública.

    

11. Para Prefixo de galeria de comunidade, digite um prefixo que será acrescentado a um GUID para criar o nome exclusivo para sua galeria de comunidade.

12. Para o email do publicador digite um endereço de email válido que pode ser usado para se comunicar com você sobre a galeria.

13. Para a URL do publicador, digite a URL para onde os usuários podem obter mais informações sobre as imagens em sua galeria de comunidade.

14. Para a URL do contrato legal, digite a URL em que os usuários finais podem encontrar termos legais para a imagem.

15. Quando terminar, selecione Review + create.

    

16. Depois da aprovação na validação, selecione Criar.

17. Depois que a implantação for concluída, selecione Ir para o recurso.

Para ver o nome público da sua galeria, selecione Compartilhar no menu à esquerda.

Para começar a compartilhar a galeria com todos os usuários do Azure, consulte Compartilhar imagens usando uma galeria da comunidade.

Próximas etapas

• Crie uma definição de imagem e uma versão de imagem.
• Crie uma VM com base em uma imagem generalizada ou especializada em uma galeria.
• Crie um aplicativo de VM em sua galeria.