Übung: Erstellen einer Registrierung

Abgeschlossen

Hinweis

Wenn Sie zum ersten Mal eine Sandbox aktivieren und die Bedingungen akzeptieren, ist Ihr Microsoft-Konto einem neuen Azure-Verzeichnis mit dem Namen Microsoft Learn Sandbox zugeordnet. Sie werden darüber hinaus einem speziellen Abonnement mit der Bezeichnung Concierge-Abonnement hinzugefügt.

Bevor Sie die Bicep-Module für CDN und Website veröffentlichen können, müssen Sie eine Registrierung für Ihre Organisation erstellen. Sie veröffentlichen die gemeinsamen Module dann in der Registry. Andere Teams können dann Bereitstellungen erstellen, die die gemeinsamen Module enthalten.

In dieser Übung führen Sie die folgenden Schritte aus:

• Stellen Sie eine private Registrierung bereit, die Ihr Unternehmen, ein Spielwarenhersteller, verwenden kann.
• Sie stellen eine Verbindung mit Ihrer Registrierung her, um zu überprüfen, ob sie erfolgreich erstellt wurde.

Sie müssen sich über das Visual Studio Code-Terminal bei Ihrem Azure-Konto anmelden, um Ressourcen in Azure bereitstellen zu können. Stellen Sie sicher, dass die Azure CLI installiert haben, und melden Sie sich mit dem gleichen Konto an, mit dem Sie die Sandbox aktiviert haben.

1. Wählen Sie im Menü Terminal die Option New Terminal (Neues Terminal) aus. Das Terminalfenster wird in der Regel in der unteren Hälfte des Bildschirms geöffnet.

2. Wenn die auf der rechten Seite des Terminalfensters angezeigte Shell bash ist, ist die richtige Shell geöffnet, und Sie können mit dem nächsten Abschnitt fortfahren.

   

3. Wenn eine andere Shell als bash angezeigt wird, wählen Sie die Shell-Dropdownliste und dann Azure Cloud Shell (Bash) aus.

   

4. Wählen Sie in der Liste der Terminalshells bash aus.

   

5. Wechseln Sie im Terminal zu dem Verzeichnis, in dem Sie Ihre Vorlage gespeichert haben. Wenn Sie Ihre Vorlage beispielsweise im Ordner templates gespeichert haben, können Sie den folgenden Befehl verwenden:

   cd templates
   

Installieren von Bicep

Vergewissern Sie sich mit dem folgenden Befehl, dass Sie die aktuelle Version von Bicep verwenden:

az bicep install && az bicep upgrade

Anmelden bei Azure

1. Melden Sie sich im Visual Studio Code-Terminal bei Azure an, indem Sie den folgenden Befehl ausführen:

   az login
   

2. Melden Sie sich im Browserfenster, das daraufhin geöffnet wird, in Ihrem Azure-Konto an.

   Im Visual Studio Code-Terminal wird eine Liste der Abonnements angezeigt, die diesem Konto zugeordnet sind.

3. Legen Sie das Standardabonnement für alle Azure CLI-Befehle fest, die Sie in dieser Sitzung ausführen.

   az account set --subscription "Concierge Subscription"
   

   Hinweis

   Wenn Sie in letzter Zeit mehrere Sandboxes verwendet haben, zeigt das Terminal möglicherweise mehrere Instanzen des Concierge-Abonnements an. Verwenden Sie in diesem Fall die nächsten beiden Schritte, um das Standardabonnement festzulegen. Wenn der vorherige Befehl erfolgreich war und nur ein Concierge-Abonnement aufgeführt wird, überspringen Sie die beiden folgenden Schritte.

4. Rufen Sie die Concierge-Abonnement-IDs ab.

    az account list \
      --refresh \
      --query "[?contains(name, 'Concierge Subscription')].id" \
      --output table
   

5. Legen Sie das Standardabonnement mit der Abonnement-ID fest. Ersetzen Sie dabei {your subscription ID} (Ihre Abonnement-ID) durch die aktuellste Concierge Subscription-ID.

   az account set --subscription {your subscription ID}
   

Festlegen der Standardressourcengruppe

Wenn Sie die Azure CLI verwenden, können Sie die Standardressourcengruppe festlegen und den Parameter in den restlichen Azure CLI-Befehlen in dieser Übung weglassen. Legen Sie den Standardwert auf die Ressourcengruppe fest, die in der Sandboxumgebung für Sie erstellt wurde.

az configure --defaults group="<rgn>[sandbox resource group name]</rgn>"

Sie müssen sich über das Visual Studio Code-Terminal bei Ihrem Azure-Konto anmelden, um Ressourcen in Azure bereitstellen zu können. Stellen Sie sicher, dass Azure PowerShell installiert ist, und melden Sie sich unter demselben Konto an, mit dem die Sandbox aktiviert wurde.

1. Wählen Sie im Menü Terminal die Option New Terminal (Neues Terminal) aus. Das Terminalfenster wird in der Regel in der unteren Hälfte des Bildschirms geöffnet.

2. Wenn die auf der rechten Seite des Terminalfensters angezeigte Shell powershell oder pwsh ist, ist die richtige Shell geöffnet, und Sie können mit dem nächsten Abschnitt fortfahren.

   

3. Wenn eine andere Shell als powershell oder pwsh angezeigt wird, wählen Sie die Shell-Dropdownliste und dann PowerShell aus.

   

4. Wählen Sie in der Liste der Terminalshells powershell oder pwsh aus.

   

5. Wechseln Sie im Terminal zu dem Verzeichnis, in dem Sie Ihre Vorlage gespeichert haben. Wenn Sie Ihre Vorlage beispielsweise im Ordner templates gespeichert haben, können Sie den folgenden Befehl verwenden:

   Set-Location -Path templates
   

Installieren der Bicep CLI

Installieren Sie die Bicep-CLI, um Bicep über Azure PowerShell zu verwenden.

Anmelden bei Azure mithilfe von Azure PowerShell

1. Führen Sie im Visual Studio Code-Terminal den folgenden Befehl aus:

   Connect-AzAccount
   

   Ein Browser wird geöffnet, in dem Sie sich bei Ihrem Azure-Konto anmelden können.

2. Sobald Sie sich in Azure angemeldet haben, wird im Terminal eine Liste der Abonnements angezeigt, die mit diesem Konto verknüpft sind.

   Wenn Sie die Sandbox aktiviert haben, wird ein Abonnement namens Concierge-Abonnement angezeigt. Verwenden Sie dieses Abonnement für die verbleibenden Schritte der Übung.

3. Legen Sie das Standardabonnement für alle Azure PowerShell-Befehle fest, die Sie in dieser Sitzung ausführen.

   $context = Get-AzSubscription -SubscriptionName 'Concierge Subscription'
   Set-AzContext $context
   

   Hinweis

   Wenn Sie in letzter Zeit mehrere Sandboxes verwendet haben, zeigt das Terminal möglicherweise mehrere Instanzen des Concierge-Abonnements an. Verwenden Sie in diesem Fall die nächsten beiden Schritte, um das Standardabonnement festzulegen. Wenn der vorherige Befehl erfolgreich war und nur ein Concierge-Abonnement aufgeführt wird, überspringen Sie die beiden folgenden Schritte.

4. Rufen Sie die Abonnement-ID ab. Mit dem folgenden Befehl werden Ihre Abonnements und deren IDs aufgelistet. Suchen Sie nach Concierge Subscription, und kopieren Sie dann die ID aus der zweiten Spalte. Der Wert sollte etwa wie folgt aussehen: aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e.

   Get-AzSubscription
   

5. Ändern Sie Ihr aktives Abonnement in Concierge-Abonnement. Ersetzen Sie {Your subscription ID} durch die gerade kopierte ID.

   $context = Get-AzSubscription -SubscriptionId {Your subscription ID}
   Set-AzContext $context
   

Festlegen der Standardressourcengruppe

Sie können die Standardressourcengruppe festlegen und den Parameter in den restlichen Azure PowerShell-Befehlen in dieser Übung weglassen. Legen Sie diesen Standardwert auf die Ressourcengruppe fest, die in der Sandboxumgebung für Sie erstellt wurde.

Set-AzDefault -ResourceGroupName <rgn>[sandbox resource group name]</rgn>

Erstellen einer Containerregistrierung

Hier erstellen Sie eine neue Registrierung zum Speichern und Freigeben Ihrer Bicep-Module. In diesem Beispiel wird Azure Container Registry verwendet.

1. Wählen Sie einen eindeutigen Namen für Ihre Containerregistrierung aus. Der Name muss in Azure global eindeutig sein. Wählen Sie einen Namen aus, der zwischen 5 und 50 Zeichen lang ist und aus Buchstaben und Ziffern besteht. Sie verwenden den Namen in den nachfolgenden Schritten.

2. Erstellen Sie eine Containerregistrierung, indem Sie diesen Befehl im Visual Studio Code-Terminal ausführen. Ersetzen Sie den Platzhalter YOUR_CONTAINER_REGISTRY_NAME durch den Namen, den Sie im vorherigen Schritt ausgewählt haben.

   az acr create \
     --name YOUR_CONTAINER_REGISTRY_NAME \
     --sku Basic \
     --location westus
   

Tipp

Sie können auch mit Bicep eine Containerregistrierung erstellen. In diesem Beispiel wird der Einfachheit halber die Azure-Befehlszeilenschnittstelle (Azure CLI) verwendet.

1. Wählen Sie einen eindeutigen Namen für Ihre Containerregistrierung aus. Der Name muss in Azure global eindeutig sein. Wählen Sie einen Namen aus, der zwischen 5 und 50 Zeichen lang ist und aus Buchstaben und Ziffern besteht. Sie verwenden den Namen in den nachfolgenden Schritten.

2. Erstellen Sie eine Containerregistrierung, indem Sie diesen Befehl im Visual Studio Code-Terminal ausführen. Ersetzen Sie den Platzhalter YOUR_CONTAINER_REGISTRY_NAME durch den Namen, den Sie im vorherigen Schritt ausgewählt haben.

   New-AzContainerRegistry `
     -Name YOUR_CONTAINER_REGISTRY_NAME `
     -Sku Basic `
     -Location westus
   

Tipp

Sie können auch mit Bicep eine Containerregistrierung erstellen. In diesem Beispiel verwenden wir der Einfachheit halber das Azure PowerShell-Cmdlet.

Auflisten der Module in Ihrer Registrierung

Nachdem Sie Ihre Registrierung erstellt haben, können Sie eine Verbindung mit ihr herstellen, um zu überprüfen, ob sie funktioniert.

1. Listen Sie die Module in der Registrierung auf, indem Sie diesen Befehl ausführen. Ersetzen Sie den Platzhalter YOUR_CONTAINER_REGISTRY_NAME durch den zuvor ausgewählten Namen.

   az acr repository list \
     --name YOUR_CONTAINER_REGISTRY_NAME
   

   Beachten Sie, dass Sie zum Herstellen einer Verbindung mit der Containerregistrierung keinerlei Anmeldeinformationen angeben. Die Azure CLI verwendet dieselben Anmeldeinformationen, die Sie für die Anmeldung bei der Azure CLI verwendet haben. Sie haben Zugriff auf die Containerregistrierung, da Sie sie erstellt haben.

2. Mit dem Azure CLI-Befehl wird eine Liste ohne Ergebnisse zurückgegeben:

   []
   

   Es werden keine Ergebnisse angezeigt, da Sie noch keine Module veröffentlicht haben. Weitere Informationen zum Veröffentlichen von Modulen finden Sie in der nächsten Lerneinheit.

1. Listen Sie die Module in der Registrierung auf, indem Sie diesen Befehl ausführen. Ersetzen Sie den Platzhalter YOUR_CONTAINER_REGISTRY_NAME durch den zuvor ausgewählten Namen.

   Get-AzContainerRegistryRepository `
     -RegistryName YOUR_CONTAINER_REGISTRY_NAME
   

   Beachten Sie, dass Sie zum Herstellen einer Verbindung mit der Containerregistrierung keinerlei Anmeldeinformationen angeben. Azure PowerShell verwendet dieselben Anmeldeinformationen, die Sie für die Anmeldung bei den Azure PowerShell-Cmdlets verwendet haben. Sie haben Zugriff auf die Containerregistrierung, da Sie sie erstellt haben.

2. Mit dem Azure PowerShell-Cmdlet werden keine Ausgaben zurückgegeben.

   Es werden keine Ergebnisse angezeigt, da Sie noch keine Module veröffentlicht haben. Weitere Informationen zum Veröffentlichen von Modulen finden Sie in der nächsten Lerneinheit.