Erstellen eines Katalogs zum Speichern und Freigeben von Ressourcen

Eine Azure Compute Gallery-Instanz (früher als Shared Image Gallery bezeichnet) vereinfacht die gemeinsame Nutzung von Ressourcen wie Images und Anwendungspaketen in Ihrer Organisation.

Azure Compute Gallery gestattet es Ihnen, Ihre benutzerdefinierten VM-Images mit anderen Personen in Ihrer Organisation, innerhalb einer oder zwischen Regionen, innerhalb eines Mandanten zu teilen. Wählen Sie aus, was Sie teilen möchten, in welchen Regionen Sie es verfügbar machen möchten, und mit wem Sie es teilen möchten. Sie können mehrere Kataloge erstellen, damit Sie Ressourcen logisch gruppieren können.

Der Katalog ist eine Ressource der obersten Ebene, die auf verschiedene Weise gemeinsam genutzt werden kann:

Freigeben für:	Personen	Gruppen	Dienstprinzipal	Alle Benutzer in einem bestimmten Abonnement (oder) Mandanten	Öffentlich für alle Benutzer in Azure
RBAC-Freigabe	Ja	Ja	Ja	Nr.	Nein
RBAC + direkt freigegebener Katalog	Ja	Ja	Ja	Ja	Nein
RBAC + Communitykatalog	Ja	Ja	Ja	Keine	Ja

Benennung

Zulässige Zeichen für Katalognamen sind Großbuchstaben (A–Z), Kleinbuchstaben (a–z), Ziffern (0–9), Punkte . und Unterstriche _. Der Katalogname darf keine Bindestriche - enthalten. Katalognamen müssen innerhalb Ihres Abonnements eindeutig sein.

Erstellen eines privaten Katalogs

Portal

1. Melden Sie sich beim Azure-Portal an.
2. Geben Sie im Suchfeld Azure Compute Gallery ein, und wählen Sie in den Ergebnissen Azure Compute Gallery aus.
3. Wählen Sie auf der Seite Azure Compute Gallery die Option Hinzufügen aus.
4. Wählen Sie auf der Seite Azure Compute Gallery-Instanz erstellen das richtige Abonnement aus.
5. Wählen Sie in Ressourcengruppe eine Ressourcengruppe aus der Dropdownliste oder die Option Neu erstellen aus, und geben Sie einen Namen für die neue Ressourcengruppe ein.
6. Geben Sie in Name einen Namen für den Katalog ein.
7. Wählen Sie in der Dropdownliste eine Region aus.
8. Sie können eine kurze Beschreibung des Katalogs eingeben, wie Mein Testkatalog. Klicken Sie anschließend auf Überprüfen und erstellen.
9. Wenn die Überprüfung erfolgreich war, wählen Sie Erstellen aus.
10. Wählen Sie nach Abschluss der Bereitstellung die Option Zu Ressourcengruppe wechseln.

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Erstellen Sie einen Katalog mit az sig create. Im folgenden Beispiel werden eine Ressourcengruppe namens myGalleryRG in der Region USA, Osten und ein Katalog namens myGallery erstellt.

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

PowerShell

Erstellen Sie mithilfe von New-AzGallery einen Katalog. Im folgenden Beispiel wird der Katalog myGallery in der Ressourcengruppe myGalleryRG erstellt.

$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

Verwenden Sie die REST-API, um eine Ressourcengruppe zu erstellen.

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

{
  "location": "eastus"
}

Verwenden Sie die REST-API, um einen Katalog zu erstellen.

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

Erstellen eines direkt freigegebenen Katalogs

Wichtig

„Azure Compute Gallery – direkt freigegebener Katalog“ befindet sich derzeit in der Vorschauphase und unterliegt den Vorschaubedingungen für Azure Compute Gallery.

Während der Vorschau müssen Sie einen neuen Katalog erstellen, bei dem die Eigenschaft sharingProfile.permissions auf Groups festgelegt ist. Wenn Sie zum Erstellen eines Katalogs die CLI nutzen, verwenden Sie den Parameter --permissions groups. Sie können keinen vorhandenen Katalog verwenden, die Eigenschaft kann zurzeit nicht aktualisiert werden.

Sie können derzeit keine flexible VM-Skalierungsgruppe aus einem Image erstellen, das von einem anderen Mandanten für Sie freigegeben wurde.

Informationen zum Freigeben eines direkt freigegebenen Katalogs für ein Abonnement oder einen Mandanten finden Sie unter Freigeben eines Katalogs für Abonnements oder Mandanten (Vorschau).

Portal

1. Melden Sie sich beim Azure-Portal an.

2. Geben Sie im Suchfeld Azure Compute Gallery ein, und wählen Sie in den Ergebnissen Azure Compute Gallery aus.

3. Wählen Sie auf der Seite Azure Compute Gallery die Option Hinzufügen aus.

4. Wählen Sie auf der Seite Azure Compute Gallery-Instanz erstellen das richtige Abonnement aus.

5. Vervollständigen Sie alle Angaben auf der Seite.

6. Wählen Sie unten auf der Seite Weiter: Freigabemethode aus.

7. Wählen Sie auf der Registerkarte Freigabe die Option RBAC + direkte Freigabe aus.

   

8. Wählen Sie abschließend Überprüfen + erstellen aus.

9. Wenn die Überprüfung erfolgreich war, wählen Sie Erstellen aus.

10. Wählen Sie nach Abschluss der Bereitstellung die Option Zu Ressourcengruppe wechseln.

Informationen zum Freigeben des Katalogs für einen Abonnement oder Mandanten finden Sie unter Freigeben eines Katalogs für ein Abonnement oder einen Mandanten (Vorschau).

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Um einen Katalog zu erstellen, der für ein Abonnement oder einen Mandanten mithilfe eines direkt freigegebenen Katalogs freigegeben werden kann, müssen Sie den Katalog mit dem Parameter --permissions erstellen und diesen auf groups festlegen.

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

Informationen zum Freigeben des Katalogs für einen Abonnement oder Mandanten finden Sie unter Freigeben eines Katalogs für ein Abonnement oder einen Mandanten (Vorschau).

REST

Erstellen Sie einen Katalog für die Freigabe auf Abonnement- oder Mandantenebene mithilfe der Azure REST-API.

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

Informationen zum Freigeben des Katalogs für einen Abonnement oder Mandanten finden Sie unter Freigeben eines Katalogs für ein Abonnement oder einen Mandanten (Vorschau).

Setzen Sie die Freigabe zurück, um alle Angaben in sharingProfile zu löschen.

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

{ 
 "operationType" : "Reset", 
} 

Erstellen eines Communitykatalogs

Ein Communitykatalog wird öffentlich für alle freigegeben. Um einen Communitykatalog zu erstellen, erstellen Sie zunächst den Katalog und aktivieren ihn dann für die Freigabe. Der Name der öffentlichen Instanz Ihres Katalogs ist eine Kombination aus dem von Ihnen angegebenen Präfix und einer eindeutigen GUID. Achten Sie darauf, dass Sie Ihren Katalog, Ihre Imagedefinitionen und Ihre Imageversionen in derselben Region erstellen, damit Sie Ihren Katalog öffentlich freigeben können.

Wenn Sie ein Image erstellen, das sie für die Community freigeben möchten, müssen Sie Kontaktinformationen angeben. Diese Informationen werden öffentlich angezeigt. Lassen Sie daher bei der Angabe folgender Daten Vorsicht walten:

• Präfix des Communitykatalogs
• E-Mail-Adresse des Herausgebersupports
• URL des Herausgebers
• Vertrags-URL

Angaben aus Ihren Imagedefinitionen (wie Herausgeber, Angebot und SKU) werden ebenfalls öffentlich verfügbar gemacht.

Voraussetzungen

Nur der Besitzer eines Abonnements bzw. ein Benutzer oder ein Dienstprinzipal, dem die Compute Gallery Sharing Admin-Rolle auf Abonnement- oder Katalogebene zugewiesen wurde, kann einen Katalog für die Community freigeben. Informationen zum Zuweisen einer Rolle zu einem Benutzer, einer Gruppe, einem Dienstprinzipal oder einer verwalteten Identität finden Sie unter Schritte zum Zuweisen einer Azure-Rolle.

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Der --public-name-prefix-Wert wird verwendet, um einen Namen für die öffentliche Version Ihres Katalogs zu erstellen. --public-name-prefix ist der erste Teil des öffentlichen Namens. Der letzte Teil ist eine von der Plattform erstellte GUID, die für Ihren Katalog eindeutig ist.

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

Die Ausgabe dieses Befehls liefert den öffentlichen Namen für Ihren Communitykatalog im Abschnitt sharingProfile unter publicNames.

Informationen zum Freigeben des Katalogs für alle Azure-Benutzer finden Sie unter Freigeben von Images mithilfe eines Communitykatalogs.

REST

Übermitteln Sie zum Erstellen eines Katalogs eine PUT-Anforderung:

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

Geben Sie im Anforderungstext permissions als Community sowie Informationen zu Ihrem Katalog an:

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

Informationen zum Freigeben des Katalogs für alle Azure-Benutzer finden Sie unter Freigeben von Images mithilfe eines Communitykatalogs.

Portal

Die Bereitstellung eines Communitykatalogs für alle Azure-Benutzer ist ein zweistufiger Prozess. Zunächst erstellen Sie den Katalog mit aktivierter Communityfreigabe, und wenn Sie bereit sind, ihn zu veröffentlichen, geben Sie den Katalog frei.

1. Melden Sie sich beim Azure-Portal an.

2. Geben Sie im Suchfeld Azure Compute Gallery ein, und wählen Sie in den Ergebnissen Azure Compute Gallery aus.

3. Klicken Sie auf der Seite Azure Compute Gallery auf Hinzufügen.

4. Wählen Sie auf der Seite Azure Compute Gallery-Instanz erstellen das richtige Abonnement aus.

5. Wählen Sie in RessourcengruppeNeu erstellen aus, und geben Sie myGalleryRG für den Namen ein.

6. Geben Sie unter NamemyGallery als Namen des Katalogs ein.

7. Übernehmen Sie den Standardwert für Region.

8. Sie können eine kurze Beschreibung des Katalogs eingeben, wie Mein Katalog zum Testen.

9. Wählen Sie unten auf der Seite Weiter: Freigabemethode aus.

10. Wählen Sie auf der Registerkarte Freigabe die Option RBAC + Freigabe für den öffentlichen Communitykatalog aus.

    

11. Geben Sie für Communitykatalogpräfix ein Präfix ein, das an eine GUID angefügt wird, um den eindeutigen Namen für Ihren Communitykatalog zu erstellen.

12. Geben Sie für E-Mail-Adresse des Herausgebers eine gültige E-Mail-Adresse ein, die verwendet werden kann, um mit Ihnen hinsichtlich des Katalogs zu kommunizieren.

13. Geben Sie für URL des Herausgebers die URL ein, über die Benutzer weitere Informationen zu den Images in Ihrem Communitykatalog erhalten können.

14. Geben Sie für Vertrags-URL die URL ein, über die Endbenutzer rechtliche Bedingungen für das Image finden können.

15. Wählen Sie abschließend Überprüfen + erstellen aus.

    

16. Wenn die Überprüfung erfolgreich war, wählen Sie Erstellen aus.

17. Wählen Sie nach Abschluss der Bereitstellung die Option Zu Ressourcengruppe wechseln.

Um den öffentlichen Namen Ihres Katalogs anzuzeigen, wählen Sie Freigabe im linken Menü aus.

Informationen zum Freigeben des Katalogs für alle Azure-Benutzer finden Sie unter Freigeben von Images mithilfe eines Communitykatalogs.

Nächste Schritte

• Erstellen Sie eine Imagedefinition und eine Imageversion.
• Erstellen Sie einen virtuellen Computer auf der Grundlage eines generalisierten oder spezialisierten Images in einem Katalog.
• Erstellen Sie eine VM-Anwendung in Ihrem Katalog.