Import a export definic podrobného plánu pomocí PowerShellu

Important

Azure Blueprints (Preview) bude vyřazena z provozu 31. ledna 2027, přičemž postupné vyřazování začne 31. července 2026. Migrujte své stávající definice a přiřazení Blueprintů do Deployment Stacks (doporučeno) a Template Specs. Artefakty blueprintu jsou převedeny na šablony ARM JSON nebo soubory Bicep, které se používají k definování zásobníků nasazení. Kompletní harmonogram jednotlivých fází, dopad a nejčastější dotazy viz vyřazení Azure Blueprints nebo https://aka.ms/AzureBlueprintsRetirement. Informace o tom, jak vytvořit artefakt jako zdroj ARM, najdete zde:

Azure Blueprints je možné plně spravovat prostřednictvím portálu Azure. Jakmile organizace použijí Azure Blueprints, měli by začít přemýšlet o definicích podrobného plánu jako spravovaného kódu. Tento koncept se často označuje jako infrastruktura jako kód (IaC). Zacházení s definicemi podrobného plánu jako s kódem nabízí další výhody nad rámec toho, co Azure portál nabízí. Mezi tyto výhody patří:

  • Sdílení definic podrobného plánu
  • Zálohování definic podrobných plánů
  • Opětovné použití definic podrobných plánů v různých tenantech 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ů kontinuální integrace a průběžného nasazování (CI/CD)

Ať už jsou vaše důvody jakékoli, správa definic blueprintů jako kódu má své výhody. Tento článek popisuje, jak používat příkazy Import-AzBlueprintWithArtifact a Export-AzBlueprintWithArtifact v modulu Az.Blueprint.

Prerequisites

Tento článek předpokládá střední pracovní znalosti Azure Blueprints. Pokud jste to ještě neudělali, projděte si následující články:

Pokud ještě není nainstalován, nainstalujte a ověřte modul Az.Blueprint z Galerie prostředí PowerShell podle pokynů v části Přidání modulu Az.Blueprint.

Struktura složek definice podrobného plánu

Než se podíváme na export a import podrobných plánů, podívejme se, jak jsou soubory, které tvoří definici podrobného plánu, strukturované. Definice podrobného plánu by měla být uložena ve své vlastní složce.

Important

Pokud se do parametru Import-AzBlueprintWithArtifact rutiny nepředá žádná hodnota, 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ána 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. Dohromady by struktura definice podrobného plánu jako soubory JSON ve složkách měla vypadat 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

Export definice 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 umístění 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, kam se mají uložit soubory JSON s definicí plánu.
    • Výstupní soubory jsou v podsložce s názvem definice podrobného plánu.
  • Verze (volitelné)
    • Určuje verzi výstupu, pokud referenční objekt podrobného plánu obsahuje odkazy na více než jednu verzi.

  1. Získejte referenci na definici blueprintu k exportu z předplatného reprezentovaného 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í rutiny Export-AzBlueprintWithArtifact exportujte zadanou definici podrobného plánu:

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

Import definice podrobného plánu

Jakmile máte exportovanou definici podrobného plánu nebo máte definici podrobného plánu ručně vytvořenou v požadované struktuře složek, můžete tuto definici podrobného plánu importovat do jiné skupiny pro správu nebo předplatného.

Příklady předdefinovaných definic podrobného plánu najdete v Azure Blueprints GitHub úložišti.

  • Jméno [povinné]
    • Určuje název nové definice podrobného plánu.
  • InputPath [povinné]
  • ManagementGroupId (volitelné)
    • ID skupiny pro správu, do které se má uložit definice podrobného plánu, pokud se nepoužije výchozí nastavení aktuálního kontextu
    • Musí být zadán parametr ManagementGroupId nebo SubscriptionId.
  • SubscriptionId (volitelné)
    • ID předplatného, do kterého se má uložit definice plánu, pokud se nemá použít výchozí hodnota aktuálního kontextu
    • Musí být zadáno buď ManagementGroupId, nebo SubscriptionId.

  1. Pomocí rutiny Import-AzBlueprintWithArtifact naimportujte 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'

Jakmile se definice podrobného plánu naimportuje, přiřaďte ji pomocí PowerShellu.

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

Další kroky

  • Last updated on