Rychlý start: Vytvoření a publikování definice aplikace spravované přes Azure

V editoru Visual Studio Code otevřete nový terminál PowerShellu a přihlaste se k předplatnému Azure.

Connect-AzAccount

Příkaz otevře výchozí prohlížeč a vyzve vás, abyste se přihlásili k Azure. Další informace najdete v tématu Přihlášení pomocí Azure PowerShellu.

New-AzResourceGroup -Name packageStorageGroup -Location westus

$pkgstorageparms = @{
  ResourceGroupName = "packageStorageGroup"
  Name = "<pkgstorageaccountname>"
  Location = "westus"
  SkuName = "Standard_LRS"
  Kind = "StorageV2"
  MinimumTlsVersion = "TLS1_2"
  AllowBlobPublicAccess = $true
  AllowSharedKeyAccess = $false
}

$pkgstorageaccount = New-AzStorageAccount @pkgstorageparms

Proměnná $pkgstorageparms používá k vylepšení čitelnosti hodnot parametrů použitých v příkazu k vytvoření nového účtu úložiště powershellové dělení. Splatting se používá v jiných příkazech PowerShellu, které používají více hodnot parametrů.

Po vytvoření účtu úložiště přidejte přispěvatel dat objektů blob úložiště role do oboru účtu úložiště. Přiřaďte přístup k uživatelskému účtu Microsoft Entra. V závislosti na vaší úrovni přístupu v Azure možná budete potřebovat další oprávnění přiřazená správcem. Další informace najdete v tématu Přiřazení role Azure pro přístup k datům objektů blob a přiřazení rolí Azure pomocí webu Azure Portal.

Po přidání role do účtu úložiště trvá několik minut, než se v Azure aktivuje. Pak můžete vytvořit kontext potřebný k vytvoření kontejneru a nahrání souboru.

$pkgstoragecontext = New-AzStorageContext -StorageAccountName $pkgstorageaccount.StorageAccountName -UseConnectedAccount

New-AzStorageContainer -Name appcontainer -Context $pkgstoragecontext -Permission blob

$blobparms = @{
  File = "app.zip"
  Container = "appcontainer"
  Blob = "app.zip"
  Context = $pkgstoragecontext
}

Set-AzStorageBlobContent @blobparms

V editoru Visual Studio Code otevřete novou relaci terminálu Bash a přihlaste se k předplatnému Azure. Pokud máte nainstalovaný Git, vyberte Git Bash.

az login

Příkaz otevře výchozí prohlížeč a vyzve vás, abyste se přihlásili k Azure. Další informace najdete v tématu Přihlášení pomocí Azure CLI.

az group create --name packageStorageGroup --location westus

az storage account create \
  --name <pkgstorageaccountname> \
  --resource-group packageStorageGroup \
  --location westus \
  --sku Standard_LRS \
  --kind StorageV2 \
  --min-tls-version TLS1_2 \
  --allow-blob-public-access true \
  --allow-shared-key-access false

pkgstgacct=$(az storage account show \
  --resource-group packageStorageGroup \
  --name <pkgstorageaccountname> \
  --query name \
  --output tsv)

Zpětné lomítko (\) je znak pokračování řádku, který zlepšuje čitelnost parametrů příkazu a používá se v mnoha příkazech Azure CLI. Proměnná pkgstgacct obsahuje název účtu úložiště pro použití v jiných příkazech.

Po vytvoření účtu úložiště přidejte přispěvatel dat objektů blob úložiště role do oboru účtu úložiště. Přiřaďte přístup k uživatelskému účtu Microsoft Entra. V závislosti na vaší úrovni přístupu v Azure možná budete potřebovat další oprávnění přiřazená správcem. Další informace najdete v tématu Přiřazení role Azure pro přístup k datům objektů blob.

Po přidání role do účtu úložiště trvá několik minut, než se v Azure aktivuje. Pak můžete pomocí parametru --auth-mode login v příkazech vytvořit kontejner a nahrát soubor.

az storage container create \
  --account-name $pkgstgacct \
  --name appcontainer \
  --auth-mode login \
  --public-access blob

az storage blob upload \
  --account-name $pkgstgacct \
  --container-name appcontainer \
  --auth-mode login \
  --name "app.zip" \
  --file "app.zip"

Další informace o ověřování úložiště najdete v tématu Volba způsobu autorizace přístupu k datům objektů blob pomocí Azure CLI.

Vytvořte účet úložiště v nové skupině prostředků:

1. Přihlaste se k portálu Azure.

2. Na domovské stránce portálu vyberte Vytvořit prostředek.

   

3. Vyhledejte účet úložiště a vyberte ho z dostupných možností.

4. Na stránce Účty úložiště vyberte Vytvořit.

   

5. Na kartě Základy zadejte požadované informace.

   

   • Skupina prostředků: Výběrem možnosti Vytvořit nový vytvořte skupinu prostředků packageStorageGroup .
   • Název účtu úložiště: Zadejte jedinečný název účtu úložiště. Název účtu úložiště musí být globálně jedinečný v rámci Azure a délka musí být 3 až 24 znaků s malými písmeny a číslicemi.
   • Oblast: USA – západ
   • Výkon: Standard
   • Redundance: Místně redundantní úložiště (LRS)

6. Na kartě Upřesnit použijte následující nastavení.

   • Vyberte Vyžadovat zabezpečený přenos pro operace rozhraní REST API.
   • Vyberte Povolit anonymní přístup pro jednotlivé kontejnery.
   • Zrušte zaškrtnutí políčka Povolit přístup ke klíči účtu úložiště.
   • Ověřte, že minimální verze protokolu TLS je verze 1.2.

7. Přijměte výchozí hodnoty na ostatních kartách.

8. Vyberte Zkontrolovat a vytvořit a potom Vytvořit.

9. Výběrem možnosti Přejít k prostředku přejděte do účtu úložiště.

Po vytvoření účtu úložiště přidejte přispěvatel dat objektů blob úložiště role do oboru účtu úložiště. Přiřaďte přístup k uživatelskému účtu Microsoft Entra. V závislosti na vaší úrovni přístupu v Azure možná budete potřebovat další oprávnění přiřazená správcem. Další informace najdete v tématu Přiřazení role Azure pro přístup k datům objektů blob. Po přidání role do účtu úložiště trvá několik minut, než se v Azure aktivuje.

Vytvořte kontejner a nahrajte soubor app.zip :

1. Přejděte do úložiště dat a vyberte Kontejnery.

   

2. Nakonfigurujte vlastnosti kontejneru a vyberte Vytvořit.

   

   • Název: appcontainer.
   • Úroveň veřejného přístupu: Vyberte objekt blob.

3. Vyberte appcontainer.

4. Vyberte Nahrát a podle pokynů nahrajte soubor app.zip do kontejneru.

   

   Soubor můžete přetáhnout na portál nebo přejít na umístění souboru v počítači.

5. Po nahrání souboru vyberte app.zip v kontejneru.

6. Zkopírujte adresu URL souboru app.zip z adresy URL přehledu>.

   

Poznamenejte si adresu URL souboru app.zip , protože ji potřebujete k vytvoření definice spravované aplikace.

Tento příklad používá skupinu zabezpečení a váš účet Microsoft Entra by měl být členem skupiny. Pokud chcete získat ID objektu skupiny, nahraďte zástupný symbol <managedAppDemo> včetně úhlových závorek (<>) názvem vaší skupiny. Hodnotu této proměnné použijete při nasazení definice spravované aplikace.

Pokud chcete vytvořit novou skupinu Microsoft Entra, přejděte do části Správa skupin Microsoft Entra a členství ve skupinách.

$principalid=(Get-AzADGroup -DisplayName <managedAppDemo>).Id

Dále získejte ID definice role předdefinované role Azure, kterou chcete udělit přístup k uživateli, skupině nebo aplikaci. Hodnotu této proměnné použijete při nasazení definice spravované aplikace.

$roleid=(Get-AzRoleDefinition -Name Owner).Id

Tento příklad používá skupinu zabezpečení a váš účet Microsoft Entra by měl být členem skupiny. Pokud chcete získat ID objektu skupiny, nahraďte zástupný symbol <managedAppDemo> včetně úhlových závorek (<>) názvem vaší skupiny. Hodnotu této proměnné použijete při nasazení definice spravované aplikace.

Pokud chcete vytvořit novou skupinu Microsoft Entra, přejděte do části Správa skupin Microsoft Entra a členství ve skupinách.

principalid=$(az ad group show --group <managedAppDemo> --query id --output tsv)

Dále získejte ID definice role předdefinované role Azure, kterou chcete udělit přístup k uživateli, skupině nebo aplikaci. Hodnotu této proměnné použijete při nasazení definice spravované aplikace.

roleid=$(az role definition list --name Owner --query [].name --output tsv)

Na portálu se ID skupiny a ID role konfigurují při publikování definice spravované aplikace.

Vytvořte skupinu prostředků pro definici spravované aplikace.

New-AzResourceGroup -Name appDefinitionGroup -Location westus

Příkaz blob vytvoří proměnnou pro uložení adresy URL balíčku .zip souboru. Tato proměnná se používá v příkazu, který vytvoří definici spravované aplikace.

$blob = Get-AzStorageBlob -Container appcontainer -Blob app.zip -Context $pkgstoragecontext

$publishparms = @{
  Name = "sampleManagedApplication"
  Location = "westus"
  ResourceGroupName = "appDefinitionGroup"
  LockLevel = "ReadOnly"
  DisplayName = "Sample managed application"
  Description = "Sample managed application that deploys web resources"
  Authorization = "${principalid}:$roleid"
  PackageFileUri = $blob.ICloudBlob.StorageUri.PrimaryUri.AbsoluteUri
}

New-AzManagedApplicationDefinition @publishparms

Po dokončení příkazu máte definici spravované aplikace ve vaší skupině prostředků.

Některé z parametrů použitých v předchozím příkladu:

• ResourceGroupName: Název skupiny prostředků, ve které je vytvořena definice spravované aplikace.
• LockLevel: U lockLevel spravované skupiny prostředků zabrání zákazníkovi provádět nežádoucí operace s touto skupinou prostředků. ReadOnly V současné době je jedinou podporovanou úrovní uzamčení. ReadOnly určuje, že zákazník může číst pouze prostředky, které jsou ve spravované skupině prostředků. Identity vydavatele, kterým je udělen přístup ke spravované skupině prostředků, jsou z úrovně uzamčení vyloučené.
• Authorization: Popisuje ID objektu zabezpečení a ID definice role, které slouží k udělení oprávnění spravované skupině prostředků.
  • "${principalid}:$roleid" nebo můžete pro každou proměnnou použít složené závorky "${principalid}:${roleid}".
  • K oddělení více hodnot použijte čárku: "${principalid1}:$roleid1", "${principalid2}:$roleid2".
• PackageFileUri: Umístění souboru balíčku .zip , který obsahuje požadované soubory.

Vytvořte skupinu prostředků pro definici spravované aplikace.

az group create --name appDefinitionGroup --location westus

Příkaz blob vytvoří proměnnou pro uložení adresy URL balíčku .zip souboru. Tato proměnná se používá v příkazu, který vytvoří definici spravované aplikace.

blob=$(az storage blob url \
  --account-name $pkgstgacct \
  --container-name appcontainer \
  --auth-mode login \
  --name app.zip --output tsv)

az managedapp definition create \
  --name "sampleManagedApplication" \
  --location "westus" \
  --resource-group appDefinitionGroup \
  --lock-level ReadOnly \
  --display-name "Sample managed application" \
  --description "Sample managed application that deploys web resources" \
  --authorizations "$principalid:$roleid" \
  --package-file-uri "$blob"

Po dokončení příkazu máte definici spravované aplikace ve vaší skupině prostředků.

Některé z parametrů použitých v předchozím příkladu:

• resource-group: Název skupiny prostředků, ve které je vytvořena definice spravované aplikace.
• lock-level: U lockLevel spravované skupiny prostředků zabrání zákazníkovi provádět nežádoucí operace s touto skupinou prostředků. ReadOnly V současné době je jedinou podporovanou úrovní uzamčení. ReadOnly určuje, že zákazník může číst pouze prostředky, které jsou ve spravované skupině prostředků. Identity vydavatele, kterým je udělen přístup ke spravované skupině prostředků, jsou z úrovně uzamčení vyloučené.
• authorizations: Popisuje ID objektu zabezpečení a ID definice role, které slouží k udělení oprávnění spravované skupině prostředků.
  • "$principalid:$roleid" nebo můžete použít složené závorky jako "${principalid}:${roleid}".
  • K oddělení více hodnot použijte mezeru: "$principalid1:$roleid1" "$principalid2:$roleid2".
• package-file-uri: Umístění souboru balíčku .zip , který obsahuje požadované soubory.

Pokud chcete publikovat definici spravované aplikace z webu Azure Portal, postupujte následovně.

1. Na domovské stránce portálu vyberte Vytvořit prostředek.

2. Vyhledejte definici spravované aplikace katalogu služeb a vyberte ji z dostupných možností.

3. Na stránce Definice spravované aplikace katalogu služeb vyberte Vytvořit.

   

4. Na kartě Základy zadejte následující informace a vyberte Další.

   

   • Podrobnosti o projektu:
     • Vyberte název předplatného.
     • Vytvořte novou skupinu prostředků s názvem appDefinitionGroup.
   • Podrobnosti o instanci:
     • Název: Zadejte název, například název instance. Název se v definici nepoužívá, ale formulář vyžaduje položku.
     • Oblast: USA – západ
   • Podrobnosti o aplikaci:
     • Název: sampleManagedApplication
     • Zobrazovaný název: Ukázková spravovaná aplikace
     • Popis: Ukázková spravovaná aplikace, která nasazuje webové prostředky

5. Na kartě Balíček zadejte identifikátor URI souboru balíčku pro váš app.zip soubor.

6. Ignorujte kartu Nastavení správy.

7. Na kartě Ověřování a zámek zadejte následující informace a pak vyberte Zkontrolovat a vytvořit.

   

   • Úroveň uzamčení: Vyberte jen pro čtení.

   • Vyberte Přidat členy.

     • Role: Vyberte vlastníka.
     • Výběr objektů zabezpečení: Vyberte název vaší skupiny, jako je managedAppDemo.

     Úroveň Uzamčení spravované skupiny prostředků zabrání zákazníkovi v provádění nežádoucích operací s touto skupinou prostředků. Read Only určuje, že zákazník může číst pouze prostředky, které jsou ve spravované skupině prostředků. Identity vydavatele, kterým je udělen přístup ke spravované skupině prostředků, jsou z úrovně uzamčení vyloučené.

8. Po zobrazení Úspěšné ověření vyberte Vytvořit.

   

Po dokončení nasazení máte ve skupině prostředků definici spravované aplikace.

Příkaz vás vyzve k potvrzení, že chcete odebrat skupinu prostředků.

Remove-AzResourceGroup -Name packageStorageGroup

Remove-AzResourceGroup -Name appDefinitionGroup

Příkazový řádek zobrazí potvrzení a po odstranění prostředků se vrátí do příkazového řádku.

az group delete --resource-group packageStorageGroup --no-wait

az group delete --resource-group appDefinitionGroup --no-wait

1. Na domovské stránce webu Azure Portal zadejte do vyhledávacího pole skupiny prostředků.
2. Vyberte Skupiny prostředků.
3. Vyberte packageStorageGroup a Odstraňte skupinu prostředků.
4. Potvrďte odstranění zadáním názvu skupiny prostředků a vyberte Odstranit.

Stejným postupem odstraňte appDefinitionGroup.