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

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

La Galería de proceso le permite compartir imágenes de máquina virtual (VM) personalizadas y paquetes de aplicación con otros usuarios de su organización, dentro o entre regiones, o dentro de un inquilino. Elija los recursos con los que desea compartir, las regiones con las que desea que estén disponibles y los usuarios con los que desea compartirlos. 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	Principal de servicio	Todos los usuarios de una suscripción o entidad específica	Públicamente con todos los usuarios de Azure
Uso compartido del control de acceso basado en rol (RBAC)	Sí	Sí	Sí	No	No
RBAC + galería compartida directa	Sí	Sí	Sí	Sí	No
RBAC + galería de la comunidad	Sí	Sí	Sí	No	Sí

Requisitos para los nombres de la galería

Los caracteres permitidos para un nombre de galería son letras mayúsculas (A-Z), 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 , seleccione Agregar.

4. En el panel Crear galería de proceso de Azure , seleccione la suscripción correcta.

5. En Grupo de recursos, seleccione un grupo de recursos en la lista desplegable. O bien, seleccione Crear nuevo y escriba un nombre para el nuevo grupo de recursos.

6. En Nombre, escriba un nombre para la galería.

7. En Región, seleccione una región de la lista desplegable.

8. Puede escribir una breve descripción de la galería, como Mi galería para pruebas. A continuación, seleccione Revisar y crear.

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

10. Cuando finalice la implementación, seleccione Go to resource (Ir al recurso).

CLI

Cree una galería mediante az sig create. En el ejemplo siguiente se crea un grupo de recursos denominado myGalleryRG 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 myGalleryRG grupo de recursos:

$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

La característica de 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 sharingProfile.permissions propiedad establecida en Groups. Cuando use la CLI de Azure para crear una galería, use el --permissions groups parámetro . No se puede usar una galería existente y la propiedad no se puede actualizar actualmente.

Actualmente no se puede crear un conjunto de escalado de máquinas virtuales flexible a partir de una imagen que otro inquilino ha compartido con usted.

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 , seleccione Agregar.

4. En el panel Crear galería de proceso de Azure , en la pestaña Aspectos básicos , seleccione la suscripción correcta.

5. Complete todos los detalles de la pestaña Aspectos básicos .

6. En la parte inferior del panel, seleccione Siguiente: Método de uso compartido.

   

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

   

8. Cuando termine, seleccione Revisar y crear.

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

10. Cuando finalice la implementación, seleccione Go to resource (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 pueda compartir con una suscripción o inquilino mediante una galería compartida directa, debe crear la galería con el --permissions parámetro establecido groupsen :

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 de nivel de suscripción o de inquilino 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 es el prefijo que se proporciona, además de un GUID. Para compartir la galería públicamente, asegúrese de crear la galería, las definiciones de imágenes y las versiones de imagen en la misma región.

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

• 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.

Solo las siguientes personas pueden permitir que una galería vaya pública a la comunidad:

• Propietario de una suscripción
• Un usuario o una entidad de servicio asignada al rol Administrador de uso compartido de la Galería de proceso en el nivel de suscripción o galería

Para asignar un rol a un usuario, grupo, entidad de servicio o identidad administrada, consulte Pasos para asignar un rol de Azure.

CLI

Use el --public-name-prefix valor para crear un nombre para la versión pública de la galería. El --public-name-prefix valor es la primera parte del nombre público. La última parte es 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 una galería, envíe una PUT solicitud:

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, creará la galería con el uso compartido de la comunidad habilitado. Cuando esté listo para hacer que la galería sea pública, la comparta.

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 , seleccione Agregar.

4. En el panel Crear galería de proceso de Azure , en la pestaña Aspectos básicos , 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 breve descripción de la galería, como Mi galería para pruebas.

9. En la parte inferior del panel, seleccione Siguiente: Método de uso compartido.

   

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

    

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

12. En Correo electrónico del publicador, escriba una dirección de correo electrónico válida que se pueda usar para comunicarse con usted sobre la galería.

13. En Dirección URL del publicador, escriba la dirección URL de un sitio 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 de un sitio donde los usuarios pueden encontrar términos legales para la imagen.

15. Cuando termine, seleccione Revisar y crear.

    

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

17. Cuando finalice la implementación, seleccione Go to resource (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.

Contenido relacionado

• 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.