Compartilhar uma galeria com todos os usuários em uma assinatura ou locatário (versão prévia)

Este artigo aborda como compartilhar uma galeria com assinaturas ou locatários específicos usando uma galeria compartilhada direta na Galeria de Computação do Azure. Compartilhar uma galeria com locatários e assinaturas lhes dá acesso somente leitura a ela.

Há três maneiras principais de compartilhar imagens na Galeria de Computação, dependendo de com quais usuários você deseja compartilhar:

Considerações importantes

• O recurso de galerias compartilhadas diretas está atualmente em versão prévia e está sujeito aos termos de visualização da Galeria de Computação do Azure.

• Para publicar imagens em uma galeria compartilhada direta durante a visualização, você precisa se registrar para a visualização. Nenhum acesso adicional é necessário para consumir imagens.

• A criação de VMs (máquinas virtuais) de uma galeria compartilhada direta é aberta a todos os usuários do Azure na assinatura ou locatário de destino com o qual a galeria é compartilhada.

• O acesso ao recurso de galerias compartilhadas diretas é fechado porque, na maioria dos cenários, o RBAC ou o compartilhamento de aplicativos é suficiente para cenários de mesma assinatura e entre locatários. Solicite acesso ao recurso somente se você quiser compartilhar imagens amplamente com todos os usuários na assinatura ou locatário e se seu caso de negócios exigir acesso a galerias compartilhadas diretas.

• Você pode usar imagens com permissões de leitura para implantar VMs e discos.

• Quando você usa uma galeria compartilhada direta, as imagens são distribuídas amplamente para todos os usuários em uma assinatura ou locatário. Uma galeria da comunidade distribui imagens publicamente. Ao compartilhar imagens que contêm propriedade intelectual, tenha cuidado para impedir a distribuição generalizada.

Limitações

Durante a versão prévia:

• Você pode compartilhar até 30 assinaturas e 5 locatários.

• Apenas imagens podem ser compartilhadas. Você não pode compartilhar diretamente um aplicativo de VM durante a visualização.

• Uma galeria compartilhada direta não pode conter versões de imagem criptografadas.

• Somente o proprietário de uma assinatura, ou um usuário ou entidade de serviço atribuída à função administrador de compartilhamento da Galeria de Computação no nível da assinatura ou galeria, pode habilitar o compartilhamento baseado em grupo.

• Somente a API REST, a CLI do Azure e o suporte ao portal do Azure estão disponíveis na versão prévia do recurso. No momento, o suporte ao PowerShell e ao Terraform não está disponível.

• Embora o suporte ao portal esteja disponível para esse recurso, o consumo de imagens no portal só está disponível no painel para criar uma VM ou um conjunto de dimensionamento de máquinas virtuais. Não há como navegar por imagens compartilhadas diretas no portal.

• A região da versão da imagem na galeria deve ser a mesma da região inicial. Não há suporte para a criação de versões entre regiões em que a região inicial é diferente da galeria. No entanto, depois que a imagem estiver na região inicial, ela poderá ser replicada para outras regiões.

• O recurso não está disponível em nuvens governamentais.

• Problema conhecido: ao criar uma VM a partir de uma imagem compartilhada direta usando o portal do Azure, se você selecionar uma região e uma imagem e, em seguida, alterar a região, receberá uma mensagem de erro: "Você só pode criar VM nas regiões de replicação dessa imagem". A mensagem é exibida mesmo quando a imagem é replicada para essa região.

  Para eliminar o erro, selecione uma região diferente e, em seguida, volte para a região desejada. Se a imagem estiver disponível, ela deverá limpar a mensagem de erro.

Pré-requisitos

Você precisa criar uma nova galeria compartilhada direta.

Durante a visualização, uma galeria compartilhada direta tem a sharingProfile.permissions propriedade definida como Groups. Ao usar a CLI do Azure para criar uma galeria, use o --permissions groups parâmetro. Você não pode usar uma galeria existente e a propriedade não pode ser atualizada no momento.

Compartilhar uma galeria

Aqui está uma visão geral do processo de compartilhamento:

1. Você cria uma galeria Microsoft.Compute/Galleries e escolhe groups como uma opção de compartilhamento.
2. Quando estiver pronto, você compartilhará sua galeria com assinaturas e locatários.
3. A infraestrutura do Azure cria recursos regionais somente leitura de proxy em Microsoft.Compute/SharedGalleries.

Somente assinaturas e locatários com os quais você compartilhou sua galeria podem interagir com os recursos de proxy. Eles nunca interagem com seus recursos privados.

Como o editor do recurso privado, você deve considerar o recurso privado como seu identificador para os recursos de proxy público. As assinaturas e locatários com os quais você compartilhou sua galeria veem o nome da galeria como a ID da assinatura em que a galeria foi criada, seguida pelo nome da galeria.

sub=<subscription-id>
tenant=<tenant-id>
gallery=<gallery-name>
rg=<resource-group-name>
az sig share add \
   --subscription-ids $sub \
   --tenant-ids $tenant \
   --gallery-name $gallery \
   --resource-group $rg

sub=<subscription-id>
tenant=<tenant-id>
gallery=<gallery-name>
rg=<resource-group-name>

az sig share remove \
   --subscription-ids $sub \
   --tenant-ids $tenant \
   --gallery-name $gallery \
   --resource-group $rg

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

{
  "operationType": "Add",
  "groups": [
    {
      "type": "Subscriptions",
      "ids": [
        "{SubscriptionID}"
      ]
    },
    {
      "type": "AADTenants",
      "ids": [
        "{tenantID}"
      ]
    }
  ]
}

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

{
  "operationType": "Remove",
  "groups":[ 
    {
      "type": "Subscriptions",
      "ids": [
        "{subscriptionId1}",
        "{subscriptionId2}"
      ],
},
{
      "type": "AADTenants",
      "ids": [
        "{tenantId1}",
        "{tenantId2}"
      ]
    }
  ]
}

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

{ 
 "operationType" : "Reset", 
} 

Conteúdo relacionado

• Crie uma definição de imagem e uma versão de imagem.
• Crie uma VM com base em uma imagem generalizada ou especializada, por meio de uma imagem compartilhada diretamente na assinatura ou no locatário de destino.