Creación de una galería para almacenar y compartir recursos

Una instancia de Azure Compute Gallery (anteriormente denominada Shared Image Gallery) simplifica el uso compartido de recursos, como imágenes y paquetes de aplicación, en toda la organización.

Azure Compute Gallery permite compartir imágenes de máquina virtual personalizadas y paquetes de aplicación con otros usuarios de la organización, ya sea dentro o entre regiones, dentro de un inquilino. Elija las imágenes que quiera compartir, en qué regiones quiere que estén disponibles y con quién quiere compartirlas. Puede crear varias galerías que le permitirán agrupar los recursos de forma lógica.

La galería es un recurso de nivel superior que se puede compartir de varias maneras:

Uso compartido con:	Personas	Grupos	Entidad de servicio	Todos los usuarios de una suscripción (o) inquilino específicos	Públicamente con todos los usuarios de Azure
Uso compartido de RBAC	Sí	Sí	Sí	No	No
RBAC + Galería compartida directa	Sí	Sí	Sí	Sí	No
RBAC + Galería de comunidad	Sí	Sí	Sí	No	Sí

Nomenclatura

Los caracteres permitidos para el nombre de la galería son mayúsculas (A-Z) y letras minúsculas (a-z), dígitos (0-9), puntos . y caracteres de subrayado _. El nombre de la galería no puede contener guiones -. Los nombres de las galerías deben ser únicos dentro de su suscripción.

Creación de una galería privada

Portal

1. Inicie sesión en Azure Portal.
2. Escriba Azure Compute Gallery en el cuadro de búsqueda y seleccione Azure Compute Gallery en los resultados.
3. En la página Azure Compute Gallery, haga clic en Agregar.
4. En la página Create Azure Compute Gallery (Crear Azure Compute Gallery), seleccione la suscripción correcta.
5. En Grupo de recursos, seleccione un grupo de recursos de la lista desplegable o seleccione Crear nuevo y escriba un nombre para el nuevo grupo de recursos.
6. En Nombre, escriba un nombre como nombre de la galería.
7. Seleccione una región en la lista desplegable.
8. Puede escribir una descripción corta de la galería, como Mi galería para prueba y, a continuación, haga clic en Revisar y crear.
9. Una vez pasada la validación, seleccione Crear.
10. Cuando la implementación finalice, seleccione Ir al recurso.

CLI

Cree una galería mediante az sig create. En el ejemplo siguiente se crea un grupo de recursos denominado myGalleryRG en la región Este de EE. UU. y una galería denominada myGallery.

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

PowerShell

Cree una galería mediante New-AzGallery. En el ejemplo siguiente se crea una galería denominada myGallery en el 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 la API REST para crear un grupo de recursos.

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

{
  "location": "eastus"
}

Use la API REST para crear una galería.

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",
}

Creación de una galería compartida directa

Importante

Azure Compute Gallery: la galería compartida directa está actualmente en VERSIÓN PRELIMINAR y está sujeta a los Términos de versión preliminar de Azure Compute Gallery.

Durante la versión preliminar, debe crear una nueva galería, con la propiedad sharingProfile.permissions establecida en Groups. Al usar la CLI para crear una galería, especifique el parámetro --permissions groups. No se puede usar una galería existente, la propiedad no se puede actualizar en este momento.

Actualmente no se puede crear un conjunto de escalado de máquinas virtuales flexible a partir de una imagen compartida por otro inquilino.

Para empezar a compartir la galería compartida directa con una suscripción o un inquilino, consulte Compartir una galería con una suscripción o un inquilino.

Portal

1. Inicie sesión en Azure Portal.

2. Escriba Azure Compute Gallery en el cuadro de búsqueda y seleccione Azure Compute Gallery en los resultados.

3. En la página Azure Compute Gallery, haga clic en Agregar.

4. En la página Create Azure Compute Gallery (Crear Azure Compute Gallery), seleccione la suscripción correcta.

5. Complete todos los detalles de la página.

6. En la parte inferior de la página, seleccione Siguiente: Método para compartir.

7. En la pestaña Uso compartido, seleccione RBAC + compartir directamente.

   

8. Seleccione Revisar y crear cuando haya terminado.

9. Una vez pasada la validación, seleccione Crear.

10. Cuando la implementación finalice, seleccione Ir al recurso.

Para empezar a compartir la galería con una suscripción o un inquilino, consulte Uso compartido de una galería con una suscripción o un inquilino.

CLI

Para crear una galería que se pueda compartir con una suscripción o un inquilino mediante una galería compartida directa, debe crear la galería con el parámetro --permissions establecido en groups.

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

Para empezar a compartir la galería con una suscripción o un inquilino, consulte Uso compartido de una galería con una suscripción o un inquilino.

REST

Cree una galería para el uso compartido a nivel de inquilino o suscripción mediante la API REST de 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 empezar a compartir la galería con una suscripción o un inquilino, consulte Uso compartido de una galería con una suscripción o un inquilino.

Restablezca el uso compartido para borrar todo en sharingProfile.

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

{ 
 "operationType" : "Reset", 
} 

Creación de una galería de la comunidad

Una galería de la comunidad se comparte públicamente con todos los usuarios. Para crear una galería de comunidad, primero debe crear la galería y, a continuación, habilitarla para compartirla. El nombre de la instancia pública de la galería será el prefijo que proporcione, además de un GUID único. Asegúrese de crear la galería, las definiciones de imágenes y las versiones de imagen en la misma región para compartir la galería públicamente.

Al crear una imagen para compartir con la comunidad, deberá proporcionar información de contacto. Esta información se mostrará públicamente, así que tenga cuidado al proporcionarla:

• Prefijo de la galería de la comunidad
• Correo electrónico de soporte técnico del publicador
• Dirección URL del publicador
• Dirección URL del contrato legal

La información de las definiciones de imagen también estará disponible públicamente, por ejemplo, la que proporcione para Publicador, Oferta y SKU.

Requisitos previos

Solo el propietario de una suscripción, o un usuario o entidad de servicio asignada al rol Compute Gallery Sharing Admin en el nivel de suscripción o galería, puede permitir que una galería pase a ser pública en la comunidad. Para asignar un rol a un usuario, grupo, entidad de servicio o identidad administrada, consulte Pasos para asignar un rol de Azure.

CLI

El valor --public-name-prefix se usa para crear un nombre para la versión pública de la galería. --public-name-prefix será la primera parte del nombre público y la última parte será un GUID, creado por la plataforma, que es único para la galería.

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

La salida de este comando le proporcionará el nombre público de la galería de la comunidad en la sección sharingProfile, en publicNames.

Para empezar a compartir la galería con todos los usuarios de Azure, consulte Uso compartido de imágenes mediante una galería de la comunidad.

REST

Para crear la galería, envíe una solicitud 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 y añada información sobre la galería en el cuerpo de la solicitud:

{
  "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 empezar a compartir la galería con todos los usuarios de Azure, consulte Uso compartido de imágenes mediante una galería de la comunidad.

Portal

Hacer que una galería de la comunidad esté disponible para todos los usuarios de Azure es un proceso de dos pasos. En primer lugar, cree la galería con el uso compartido de la comunidad habilitado; cuando quiera hacerla pública, comparta la galería.

1. Inicie sesión en Azure Portal.

2. Escriba Azure Compute Gallery en el cuadro de búsqueda y seleccione Azure Compute Gallery en los resultados.

3. En la página Azure Compute Gallery, haga clic en Agregar.

4. En la página Create Azure Compute Gallery (Crear Azure Compute Gallery), seleccione la suscripción correcta.

5. En Grupo de recursos, seleccione Crear nuevo y escriba myGalleryRG como nombre.

6. En Nombre, escriba myGallery como nombre de la galería.

7. En Región, deje el valor predeterminado.

8. Puede escribir una descripción corta de la galería, como Mi galería para pruebas.

9. En la parte inferior de la página, seleccione Siguiente: Método para compartir.

10. En la pestaña Uso compartido, seleccione RBAC + compartir en la galería de la comunidad pública.

    

11. Para el prefijo de la galería de la comunidad, escriba un prefijo que se anexará a un GUID para crear el nombre único de la galería de la comunidad.

12. Para el correo electrónico de publicador, escriba una dirección de correo electrónico válida que se pueda usar para mandar comunicaciones sobre la galería.

13. Para la dirección URL del publicador, escriba la dirección URL donde los usuarios pueden obtener más información sobre las imágenes de la galería de la comunidad.

14. En Dirección URL del contrato legal, escriba la dirección URL en la que los usuarios finales pueden encontrar términos legales para la imagen.

15. Seleccione Revisar y crear cuando haya terminado.

    

16. Una vez pasada la validación, seleccione Crear.

17. Cuando la implementación finalice, seleccione Ir al recurso.

Para ver el nombre público de la galería, seleccione Compartir en el menú de la izquierda.

Para empezar a compartir la galería con todos los usuarios de Azure, consulte Uso compartido de imágenes mediante una galería de la comunidad.

Pasos siguientes

• Cree una definición de imagen y una versión de imagen.
• Cree una máquina virtual a partir de una imagen generalizada o especializada en una galería.
• Cree una aplicación de máquina virtual en la galería.