Udostępnij za pośrednictwem

Szybki start: wdrażanie aplikacji zarządzanej katalogu usług

W tym przewodniku Szybki start użyjesz definicji aplikacji zarządzanej utworzonej przy użyciu jednego z artykułów Szybki start. Wdrożenie tworzy dwie grupy zasobów. Jedna grupa zasobów zawiera aplikację zarządzaną, a druga jest zarządzaną grupą zasobów dla wdrożonych zasobów. Definicja aplikacji zarządzanej wdraża plan usługi App Service, usługę App Service i konto magazynu.

Wymagania wstępne

Tworzenie aplikacji zarządzanej katalogu usług

W przykładach nazwy grup zasobów utworzone w przewodniku Szybki start służą do publikowania definicji aplikacji. Jeśli użyto przewodnika Szybki start do opublikowania definicji z użyciem własnego magazynu, użyj tych nazw grup zasobów.

  • Definicja aplikacji publikowania: packageStorageGroup i appDefinitionGroup.
  • Definicja publikowania z funkcją bring your own storage: packageStorageGroup, byosDefinitionStorageGroup i byosAppDefinitionGroup.

Pobieranie definicji aplikacji zarządzanej

Aby uzyskać definicję aplikacji zarządzanej za pomocą programu Azure PowerShell, uruchom następujące polecenia.

W programie Visual Studio Code otwórz nowy terminal programu PowerShell i zaloguj się do subskrypcji platformy Azure.

Connect-AzAccount

Polecenie otwiera domyślną przeglądarkę i wyświetla monit o zalogowanie się na platformie Azure. Aby uzyskać więcej informacji, przejdź do tematu Logowanie się przy użyciu programu Azure PowerShell.

Z poziomu programu Azure PowerShell uzyskaj definicję aplikacji zarządzanej. W tym przykładzie użyj nazwy grupy zasobów appDefinitionGroup , która została utworzona podczas wdrażania definicji aplikacji zarządzanej.

Get-AzManagedApplicationDefinition -ResourceGroupName appDefinitionGroup

Get-AzManagedApplicationDefinition Wyświetla listę wszystkich dostępnych definicji w określonej grupie zasobów, takich jak sampleManagedApplication.

Utwórz zmienną dla identyfikatora zasobu definicji aplikacji zarządzanej.

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

Wartość zmiennej $definitionid jest używana podczas wdrażania aplikacji zarządzanej.

Tworzenie grupy zasobów i parametrów

Utwórz grupę zasobów dla wdrożenia aplikacji zarządzanej.

New-AzResourceGroup -Name applicationGroup -Location westus

Należy również utworzyć nazwę grupy zasobów aplikacji zarządzanej. Grupa zasobów jest tworzona podczas wdrażania aplikacji zarządzanej.

Uruchom następujące polecenia, aby utworzyć nazwę zarządzanej grupy zasobów.

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

Zmienne $mrgprefix i $mrgtimestamp są łączone i przechowywane w zmiennej $mrgname . Wartość zmiennej jest w formacie mrg-sampleManagedApplication-20230512103059. Wartość zmiennej $mrgname jest używana podczas wdrażania aplikacji zarządzanej.

Należy podać kilka parametrów do polecenia wdrożenia dla aplikacji zarządzanej. Możesz użyć ciągu sformatowanego w formacie JSON lub utworzyć plik JSON. W tym przykładzie używamy ciągu sformatowanego w formacie JSON. Znak ucieczki programu PowerShell dla znaków cudzysłowu jest znakiem backtick (`). Backtick jest również używany do kontynuacji wiersza, dzięki czemu polecenia mogą używać wielu wierszy.

Składnia ciągu sformatowanego w formacie JSON jest następująca:

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

W celu zapewnienia czytelności ukończony ciąg JSON używa backtick dla kontynuacji wiersza. Wartości są przechowywane w zmiennej $params i używane w poleceniu wdrażania. Parametry w ciągu JSON są wymagane do wdrożenia zarządzanych zasobów.

$params="{ `"appServicePlanName`": {`"value`":`"demoAppServicePlan`"}, `
`"appServiceNamePrefix`": {`"value`":`"demoApp`"} }"

Parametry do utworzenia zasobów zarządzanych:

  • appServicePlanName: Utwórz nazwę planu. Maksymalnie 40 znaków alfanumerycznych i łączników. Na przykład demoAppServicePlan. Nazwy planów usługi App Service muszą być unikatowe w ramach grupy zasobów w ramach subskrypcji.
  • appServiceNamePrefix: Utwórz prefiks nazwy planu. Maksymalnie 47 znaków alfanumerycznych lub łączników. Na przykład demoApp. Podczas wdrażania prefiks jest połączony z unikatowym ciągiem w celu utworzenia nazwy, która jest globalnie unikatowa na platformie Azure.

Wdrażanie aplikacji zarządzanej

Uruchom następujące polecenie, aby wdrożyć aplikację zarządzaną.

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

Parametry używane w poleceniu wdrażania:

  • Name: określ nazwę aplikacji zarządzanej. W tym przykładzie użyj polecenia demoManagedApplication.
  • ResourceGroupName: nazwa grupy zasobów utworzonej dla aplikacji zarządzanej.
  • Location: określ region wdrożenia zasobów. W tym przykładzie użyj polecenia westus.
  • ManagedResourceGroupName: używa wartości zmiennej $mrgname . Zarządzana grupa zasobów jest tworzona podczas wdrażania aplikacji zarządzanej.
  • ManagedApplicationDefinitionId: używa $definitionid wartości zmiennej dla identyfikatora zasobu definicji aplikacji zarządzanej.
  • Kind: określa typ aplikacji zarządzanej. W tym przykładzie użyto usługi ServiceCatalog.
  • Parameter: używa wartości zmiennej $params w ciągu sformatowanego w formacie JSON.

Wyświetlanie wyników

Po wdrożeniu aplikacji zarządzanej katalogu usług masz dwie nowe grupy zasobów. Jedna grupa zasobów zawiera aplikację zarządzaną. Druga grupa zasobów zawiera wdrożone zasoby zarządzane. W tym przykładzie konto usługi App Service, plan usługi App Service i magazyn.

Aplikacja zarządzana

Po zakończeniu wdrażania możesz sprawdzić stan aplikacji zarządzanej.

Uruchom następujące polecenie, aby sprawdzić stan aplikacji zarządzanej.

Get-AzManagedApplication -Name demoManagedApplication -ResourceGroupName applicationGroup

Rozwiń właściwości, aby ułatwić odczytywanie Properties informacji.

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

Zasoby zarządzane

Zasoby wdrożone w zarządzanej grupie zasobów można wyświetlić.

Aby wyświetlić zasoby zarządzanej grupy zasobów, uruchom następujące polecenie. Zmienna została utworzona $mrgname podczas tworzenia parametrów.

Get-AzResource -ResourceGroupName $mrgname

Aby wyświetlić wszystkie przypisania ról dla zarządzanej grupy zasobów.

Get-AzRoleAssignment -ResourceGroupName $mrgname

Definicja aplikacji zarządzanej utworzona w artykułach Szybki start używała grupy z przypisaniem roli Właściciel. Grupę można wyświetlić za pomocą następującego polecenia.

Get-AzRoleAssignment -ResourceGroupName $mrgname -RoleDefinitionName Owner

Można również wyświetlić listę przypisań odmowy dla zarządzanej grupy zasobów.

Get-AzDenyAssignment -ResourceGroupName $mrgname

Czyszczenie zasobów

Po zakończeniu pracy z aplikacją zarządzaną możesz usunąć grupy zasobów i usunąć wszystkie utworzone zasoby. Na przykład w tym przewodniku Szybki start utworzono grupę zasobów applicationGroup i zarządzaną grupę zasobów z prefiksem mrg-sampleManagedApplication.

Polecenie wyświetla monit o potwierdzenie, że chcesz usunąć grupę zasobów.

Remove-AzResourceGroup -Name applicationGroup

Jeśli chcesz usunąć definicję aplikacji zarządzanej, usuń grupy zasobów utworzone w artykułach Szybki start.

  • Definicja aplikacji publikowania: packageStorageGroup i appDefinitionGroup.
  • Definicja publikowania z funkcją bring your own storage: packageStorageGroup, byosDefinitionStorageGroup i byosAppDefinitionGroup.

Następne kroki