Criar uma galeria para armazenar e partilhar recursos

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 toda a sua organização.

A Galeria de Computação do Azure permite que você compartilhe imagens de VM personalizadas e pacotes de aplicativos com outras pessoas em sua organização, dentro ou entre regiões, dentro de um locatário. Escolha o que pretende partilhar, em que regiões pretende disponibilizá-los e com quem pretende partilhá-los. Você pode criar várias galerias para que possa agrupar recursos logicamente.

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

Partilhar com:	Pessoas	Grupos	Principal de Serviço	Todos os usuários em uma assinatura (ou) locatário específico	Publicamente com todos os usuários no Azure
Compartilhamento RBAC	Sim	Sim	Sim	No	Não
RBAC + Direct galeria compartilhada	Sim	Sim	Sim	Sim	No
RBAC + Galeria da Comunidade	Sim	Sim	Sim	No	Sim

Atribuição de nomes

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) .e sublinhados _. O nome da galeria não pode conter traços -. Os nomes das galerias devem ser exclusivos na sua assinatura.

Criar uma galeria privada

Portal

1. Inicie sessão no portal do Azure.
2. Digite Azure Compute Gallery na caixa de pesquisa e selecione Azure Compute Gallery 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. Em 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 testes, e clicar em Revisar + criar.
9. Depois que a validação for aprovada, selecione Criar.
10. Quando a implantação estiver concluída, selecione Ir para recurso.

CLI

Crie uma galeria usando az sig create. O exemplo a seguir cria um grupo de recursos chamado gallery chamado myGalleryRG no Leste dos EUA e 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 – a galeria compartilhada direta está atualmente em VISUALIZAÇÃO e sujeita aos Termos de Visualização da Galeria de Computação do Azure.

Durante a visualização, você precisa criar uma nova galeria, com a propriedade sharingProfile.permissions definida como Groups. Ao usar a CLI para criar uma galeria, use o --permissions groups parâmetro. Você não pode usar uma galeria existente, a propriedade não pode ser atualizada no momento.

No momento, não é possível criar um conjunto de escala de máquina virtual flexível a partir de uma imagem compartilhada com você por outro locatário.

Para começar a partilhar uma galeria partilhada direta com uma subscrição ou inquilino, consulte Partilhar uma galeria com uma subscrição ou inquilino.

Portal

1. Inicie sessão no portal do Azure.

2. Digite Azure Compute Gallery na caixa de pesquisa e selecione Azure Compute Gallery 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 Rever + criar.

9. Depois que a validação for aprovada, selecione Criar.

10. Quando a implantação estiver concluída, selecione Ir para recurso.

Para começar a partilhar a galeria com uma subscrição ou inquilino, consulte Partilhar uma galeria com uma subscrição ou inquilino.

CLI

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

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

Para começar a partilhar a galeria com uma subscrição ou inquilino, utilize consulte Partilhar uma galeria com uma subscrição ou inquilino.

REST

Crie uma galeria para assinatura ou compartilhamento em nível de 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 partilhar a galeria com uma subscrição ou inquilino, utilize consulte Partilhar uma galeria com uma subscrição ou inquilino.

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, em seguida, habilite-a para compartilhamento. O nome da instância pública da sua galeria é o prefixo fornecido, além de um GUID exclusivo. Certifique-se de criar sua galeria, definições de imagem e versões de imagem na mesma região para compartilhar sua galeria publicamente.

Ao criar uma imagem para compartilhar com a comunidade, você precisa fornecer informações de contato. Esta informação é mostrada publicamente, por isso tenha cuidado ao fornecer:

• Prefixo da galeria da comunidade
• E-mail de suporte do editor
• URL do editor
• URL do contrato legal

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

Pré-requisitos

Somente o proprietário de uma assinatura, ou um usuário ou entidade de serviço atribuída à Compute Gallery Sharing Admin função no nível de assinatura ou galeria, pode permitir que uma galeria seja tornada 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 --public-name-prefix valor é usado para criar um nome para a versão pública da sua galeria. A --public-name-prefix é a primeira parte do nome público, e a última parte será um GUID, criado pela plataforma, que é exclusivo para a sua 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 deste comando dá-lhe o nome público da sua galeria da comunidade na sharingProfile secção, 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 da comunidade para todos os usuários do Azure é um processo de 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. Inicie sessão no portal do Azure.

2. Digite Azure Compute Gallery na caixa de pesquisa e selecione Azure Compute Gallery 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. No grupo de recursos, selecione Criar novo e digite myGalleryRG para o nome.

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

7. Deixe o padrão para Região.

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

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

10. Na guia Compartilhamento, selecione RBAC + compartilhar na galeria da comunidade pública.

    

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

12. Em Email do Publisher , digite um endereço de email válido que possa ser usado para se comunicar com você sobre a galeria.

13. Em URL do Publisher, digite o URL para onde os usuários podem obter mais informações sobre as imagens na galeria da comunidade.

14. Em URL do Contrato Legal, digite o URL onde os usuários finais podem encontrar os termos legais para a imagem.

15. Quando terminar, selecione Rever + criar.

    

16. Depois que a validação for aprovada, selecione Criar.

17. Quando a implantação estiver concluída, selecione Ir para recurso.

Para ver o nome público da sua galeria, selecione Compartilhamento 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óximos passos

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