Import a export definic podrobných plánů pomocí PowerShellu

  • Článek
  • 3 min ke čtení

Plány Azure je možné plně spravovat prostřednictvím Azure Portal. Protože organizace budou v používání plánů Azure předem platit, měly by začít myslet na definice podrobného plánu jako spravovaný kód. Tento koncept se často označuje jako infrastruktura jako kód (IaC). S tím, jak kód zpracovává definice podrobného plánu, nabízí další výhody nad rámec toho, co Azure Portal nabídky. Mezi tyto výhody patří:

  • Sdílení definic podrobného plánu
  • Zálohování definic podrobných plánů
  • Znovu použít definice podrobného plánu v různých klientech nebo předplatných
  • Umístění definic podrobného plánu do správy zdrojového kódu
    • Automatizované testování definic podrobných plánů v testovacích prostředích
    • Podpora kanálů průběžné integrace a průběžného nasazování (CI/CD)

Bez ohledu na vaše důvody a Správa definic podrobných plánů jako kód přináší výhody. V tomto článku se dozvíte, jak používat Import-AzBlueprintWithArtifact Export-AzBlueprintWithArtifact příkazy a v modulu AZ. detail .

Požadavky

V tomto článku se předpokládá, že jsou v Azure modrotisky mírné znalosti. Pokud jste to ještě neudělali, Projděte si následující články:

Pokud ještě není nainstalovaná, nainstalujte a ověřte modul AZ. detail z Galerie prostředí PowerShell podle pokynů v tématu Přidání modulu AZ. detail .

Struktura složek v definici podrobného plánu

Než začnete s exportem a importem modrotisky, Podívejme se na to, jak jsou strukturované soubory, které tvoří definici podrobného plánu. Definice podrobného plánu by měla být uložena ve své vlastní složce.

Důležité

Pokud není předána žádná hodnota parametru názvu Import-AzBlueprintWithArtifact rutiny, použije se název složky, ve které je definice podrobného plánu uložená.

Spolu s definicí podrobného plánu, který musí být pojmenován blueprint.json , jsou artefakty, ze kterých se definice podrobného plánu skládá. Každý artefakt musí být v podsložce s názvem artifacts . Společně se strukturou vaší definice podrobného plánu jako soubory JSON ve složkách, které by se měly podávat, vypadá takto:

.
|
|- MyBlueprint/  _______________ # Root folder name becomes default name of blueprint definition
|  |- blueprint.json  __________ # The blueprint definition. Fixed name.
|
|  |- artifacts/  ______________ # Subfolder for all blueprint artifacts. Fixed name.
|     |- artifact.json  ________ # Blueprint artifact as JSON file. Artifact named from file.
|     |- ...
|     |- more-artifacts.json

Exportovat definici podrobného plánu

Postup exportu definice podrobného plánu je jednoduchý. Export definice podrobného plánu může být užitečný pro sdílení, zálohování nebo vložení do správy zdrojového kódu.

  • Podrobný plán [povinné]
    • Určuje definici podrobného plánu.
    • Slouží Get-AzBlueprint k získání referenčního objektu.
  • OutputPath [povinné]
    • Určuje cestu, do které budou uloženy soubory JSON definice podrobného plánu.
    • Výstupní soubory jsou v podsložce s názvem definice podrobného plánu.
  • Verze (volitelné)
    • Určuje verzi pro výstup, pokud referenční objekt podrobného plánu obsahuje odkazy na více než jednu verzi.

  1. Získejte odkaz na definici podrobného plánu pro export z předplatného, které je reprezentované jako {subId} :

    # Login first with Connect-AzAccount if not using Cloud Shell

# Get version '1.1' of the blueprint definition in the specified subscription
$bpDefinition = Get-AzBlueprint -SubscriptionId '{subId}' -Name 'MyBlueprint' -Version '1.1'

  2. Pomocí Export-AzBlueprintWithArtifact rutiny exportujte zadanou definici podrobného plánu:

    Export-AzBlueprintWithArtifact -Blueprint $bpDefinition -OutputPath 'C:\Blueprints'

Import definice podrobného plánu

Když máte buď exportovanou definici podrobného plánu, nebo máte vytvořenou definici podrobného plánu ve struktuře požadované složky, můžete tuto definici podrobného plánu naimportovat do jiné skupiny pro správu nebo předplatného.

příklady předdefinovaných definic podrobných plánů najdete v tématu úložiště Azure pro GitHub.

  • Název [povinné]
    • Určuje název nové definice podrobného plánu.
  • InputPath [povinné]
  • ManagementGroupId (volitelné)
    • ID skupiny pro správu, do které se uloží definice podrobného plánu, pokud není aktuální kontextový Standard
    • Musí se zadat buď ManagementGroupId , nebo SubscriptionId .
  • SubscriptionId (volitelné)
    • ID předplatného, do kterého se uloží definice podrobného plánu, pokud není aktuální kontext výchozí
    • Musí se zadat buď ManagementGroupId , nebo SubscriptionId .

  1. Pomocí Import-AzBlueprintWithArtifact rutiny importujte zadanou definici podrobného plánu:

    # Login first with Connect-AzAccount if not using Cloud Shell

Import-AzBlueprintWithArtifact -Name 'MyBlueprint' -ManagementGroupId 'DevMG' -InputPath 'C:\Blueprints\MyBlueprint'

Po importu definice podrobného plánu ji přiřaďte k prostředí PowerShell.

Informace o vytváření pokročilých definic podrobných plánů najdete v následujících článcích:

Další kroky