Schnellstart: Bereitstellen einer verwalteten Dienstkataloganwendung

  • Artikel

In diesem Schnellstart verwenden Sie die Definition für die verwaltete Anwendung, die Sie mit einem der Schnellstartartikel erstellt haben. Die Bereitstellung erstellt zwei Ressourcengruppen. Eine Ressourcengruppe enthält die verwaltete Anwendung und die andere ist eine verwaltete Ressourcengruppe für die bereitgestellten Ressourcen. Die Definition der verwalteten Anwendung stellt einen App Service Plan, App Service und ein Speicherkonto bereit.

Voraussetzungen

Erstellen Sie eine vom Servicekatalog verwaltete Anwendung

Die Beispiele verwenden die Ressourcengruppennamen, die im Schnellstart zum Veröffentlichen einer Anwendungsdefinition erstellt wurden. Wenn Sie den Schnellstart verwendet haben, um eine Definition mit „Bring Your Own Storage“ zu veröffentlichen, verwenden Sie diese Ressourcengruppennamen.

  • Veröffentlichen der Anwendungsdefinition: packageStorageGroup und appDefinitionGroup.
  • Veröffentlichen von Definitionen mit „Bring Your Own Storage“: packageStorageGroup, byosDefinitionStorageGroup und byosAppDefinitionGroup.

Abrufen der Definition einer verwalteten Anwendung

Führen Sie die folgenden Befehle aus, um die Definition der verwalteten Anwendung mit Azure PowerShell abzurufen.

Öffnen Sie in Visual Studio Code ein neues PowerShell-Terminal, und melden Sie sich bei Ihrem Azure-Abonnement an.

Connect-AzAccount

Der Befehl öffnet Ihren Standardbrowser und fordert Sie auf, sich bei Azure anzumelden. Weitere Informationen finden Sie unter Anmelden mit Azure PowerShell.

Rufen Sie aus Azure PowerShell die Definition Ihrer verwalteten Anwendung ab. Verwenden Sie in diesem Beispiel den Ressourcengruppennamen appDefinitionGroup, der beim Bereitstellen der Definition der verwalteten Anwendung erstellt wurde.

Get-AzManagedApplicationDefinition -ResourceGroupName appDefinitionGroup

Get-AzManagedApplicationDefinition listet alle verfügbaren Definitionen in der angegebenen Ressourcengruppe auf, z. B. sampleManagedApplication.

Erstellen Sie eine Variable für die Ressourcen-ID der Definition der verwalteten Anwendung.

$definitionid = (Get-AzManagedApplicationDefinition -ResourceGroupName appDefinitionGroup -Name sampleManagedApplication).ManagedApplicationDefinitionId

Sie verwenden den Wert der $definitionid-Variable, wenn Sie die verwaltete Anwendung bereitstellen.

Erstellen einer Ressourcengruppe und von Ressourcenparametern

Erstellen Sie eine Ressourcengruppe für die verwaltete Anwendung, die während der Bereitstellung verwendet wird.

New-AzResourceGroup -Name applicationGroup -Location westus3

Sie müssen auch einen Namen für die Ressourcengruppe der verwalteten Anwendung erstellen. Die Ressourcengruppe wird erstellt, wenn Sie die verwaltete Anwendung bereitstellen.

Führen Sie die folgenden Befehle aus, um den Namen der verwalteten Ressourcengruppe zu erstellen.

$mrgprefix = 'mrg-sampleManagedApplication-'
$mrgtimestamp = Get-Date -UFormat "%Y%m%d%H%M%S"
$mrgname = $mrgprefix + $mrgtimestamp
$mrgname

Die Variablen $mrgprefix und $mrgtimestamp werden verkettet und in der Variable $mrgname gespeichert. Der Wert der Variablen hat das Format mrg-sampleManagedApplication-20230512103059. Sie verwenden den Wert der $mrgname-Variable, wenn Sie die verwaltete Anwendung bereitstellen.

Sie müssen dem Bereitstellungsbefehl für die verwaltete Anwendung mehrere Parameter übergeben. Sie können eine JSON-formatierte Zeichenfolge verwenden oder eine JSON-Datei erstellen. In diesem Beispiel verwenden wir eine JSON-formatierte Zeichenfolge. Das PowerShell-Escapezeichen für die Anführungszeichen ist das Backtickzeichen (`). Der Backtick wird auch für die Zeilenfortführung verwendet, sodass Befehle mehrere Zeilen verwenden können.

Die Syntax der JSON-formatierten Zeichenfolge lautet wie folgt:

"{ `"parameterName`": {`"value`":`"parameterValue`"}, `"parameterName`": {`"value`":`"parameterValue`"} }"

Zur Lesbarkeit verwendet die abgeschlossene JSON-Zeichenfolge den Backtick für die Zeilenfortführung. Die Werte werden in der $params-Variablen gespeichert, die im Bereitstellungsbefehl verwendet wird. Die Parameter in der JSON-Zeichenfolge sind erforderlich, um die verwalteten Ressourcen bereitzustellen.

$params="{ `"appServicePlanName`": {`"value`":`"demoAppServicePlan`"}, `
`"appServiceNamePrefix`": {`"value`":`"demoApp`"}, `
`"storageAccountNamePrefix`": {`"value`":`"demostg1234`"}, `
`"storageAccountType`": {`"value`":`"Standard_LRS`"} }"

Die Parameter zum Erstellen der verwalteten Ressourcen:

  • appServicePlanName: Erstellen eines Plannamen. Maximal 40 alphanumerische Zeichen und Bindestriche. Beispiel: demoAppServicePlan. App Service-Plannamen müssen innerhalb einer Ressourcengruppe in Ihrem Abonnement eindeutig sein.
  • appServiceNamePrefix: Erstellen Sie ein Präfix für den Plannamen. Maximal 47 alphanumerische Zeichen oder Bindestriche. Beispiel: demoApp. Während der Bereitstellung wird das Präfix mit einer eindeutigen Zeichenfolge verkettet, um einen Namen zu erstellen, der in Azure global eindeutig ist.
  • storageAccountNamePrefix: Verwenden Sie nur Kleinbuchstaben und Zahlen und maximal 11 Zeichen. Beispiel: demostg1234. Während der Bereitstellung wird das Präfix mit einer eindeutigen Zeichenfolge verkettet, um einen global eindeutigen Namen in Azure zu erstellen. Auch wenn Sie ein Präfix erstellen, sucht das Steuerelement nach vorhandenen Namen in Azure und zeigt möglicherweise eine Validierungsmeldung an, wenn der Name bereits verwendet wird. Wenn dies der Fall ist, wählen Sie bitte ein anderes Präfix aus.
  • storageAccountType: Die Optionen lauten Premium_LRS, Standard_LRS und Standard_GRS.

Bereitstellen der verwalteten Anwendung

Führen Sie den folgenden Befehl aus, um die verwaltete Anwendung bereitzustellen.

New-AzManagedApplication `
  -Name "demoManagedApplication" `
  -ResourceGroupName applicationGroup `
  -Location westus3 `
  -ManagedResourceGroupName $mrgname `
  -ManagedApplicationDefinitionId $definitionid `
  -Kind ServiceCatalog `
  -Parameter $params

Die im Bereitstellungsbefehl verwendeten Parameter:

  • Name: Geben Sie einen Namen für die verwaltete Anwendung an. Verwenden Sie in diesem Beispiel demoManagedApplication.
  • ResourceGroupName: Name der Ressourcengruppe, die Sie für die verwaltete Anwendung erstellt haben.
  • Location: Geben Sie die Region an, in der die Ressourcen bereitgestellt werden. Verwenden Sie für dieses Beispiel westus3.
  • ManagedResourceGroupName: Verwendet den Wert der $mrgname-Variable. Die verwaltete Ressourcengruppe wird erstellt, wenn die verwaltete Anwendung bereitgestellt wird.
  • ManagedApplicationDefinitionId: Verwendet den Wert der $definitionid-Variable für die Ressourcen-ID der Definition der verwalteten Anwendung.
  • Kind: Gibt diesen Typ der verwalteten Anwendung an. Dieses Beispiel verwendet ServiceCatalog.
  • Parameter: Verwendet den Wert der $params-Variable in der JSON-formatierten Zeichenfolge.

Anzeigen der Ergebnisse

Nachdem die vom Dienstkatalog verwaltete Anwendung bereitgestellt wurde, verfügen Sie über zwei neue Ressourcengruppen. Eine Ressourcengruppe enthält die verwaltete Anwendung. Die andere Ressourcengruppe enthält die verwalteten Ressourcen, die bereitgestellt wurden. In diesem Beispiel ein App Service, ein App Service-Plan und ein Speicherkonto.

Verwaltete Anwendung

Nach Abschluss der Bereitstellung können Sie den Status Ihrer verwalteten Anwendung überprüfen.

Führen Sie den folgenden Befehl aus, um den Status der verwalteten Anwendung zu überprüfen.

Get-AzManagedApplication -Name demoManagedApplication -ResourceGroupName applicationGroup

Erweitern Sie die Eigenschaften, um das Lesen der Properties-Informationen zu vereinfachen.

Get-AzManagedApplication -Name demoManagedApplication -ResourceGroupName applicationGroup | Select-Object -ExpandProperty Properties

Verwaltete Ressourcen

Sie können die in der verwalteten Ressourcengruppe bereitgestellten Ressourcen anzeigen.

Führen Sie den folgenden Befehl aus, um die Ressourcen der verwalteten Ressourcengruppe anzuzeigen. Sie haben die $mrgname-Variable erstellt, als Sie die Parameter erstellt haben.

Get-AzResource -ResourceGroupName $mrgname

Zum Anzeigen aller Rollenzuweisungen für die verwaltete Ressourcengruppe.

Get-AzRoleAssignment -ResourceGroupName $mrgname

Die Definition der verwalteten Anwendung, die Sie in den Schnellstartartikeln erstellt haben, verwendete eine Gruppe mit der Rollenzuweisung „Besitzer“. Sie können die Gruppe mit dem folgenden Befehl anzeigen.

Get-AzRoleAssignment -ResourceGroupName $mrgname -RoleDefinitionName Owner

Sie können auch die Ablehnungszuweisungen für die verwaltete Ressourcengruppe auflisten.

Get-AzDenyAssignment -ResourceGroupName $mrgname

Bereinigen von Ressourcen

Wenn Sie mit der verwalteten Anwendung fertig sind, können Sie die Ressourcengruppen löschen, und dies entfernt alle von Ihnen erstellten Ressourcen. In dieser Schnellstartanleitung haben Sie beispielsweise die Ressourcengruppen applicationGroup und eine verwaltete Ressourcengruppe mit dem Präfix mrg-sampleManagedApplication erstellt.

Der Befehl fordert Sie auf, zu bestätigen, dass Sie die Ressourcengruppe entfernen wollen.

Remove-AzResourceGroup -Name applicationGroup

Wenn Sie die verwaltete Anwendungsdefinition löschen möchten, können Sie die Ressourcengruppen löschen, die Sie in den Schnellstartanleitungen erstellt haben.

  • Veröffentlichen der Anwendungsdefinition: packageStorageGroup und appDefinitionGroup.
  • Veröffentlichen von Definitionen mit „Bring Your Own Storage“: packageStorageGroup, byosDefinitionStorageGroup und byosAppDefinitionGroup.

Nächste Schritte