Mengimpor dan mengekspor definisi cetak biru dengan PowerShell
Penting
Pada 11 Juli 2026, Cetak Biru (Pratinjau) tidak akan digunakan lagi. Migrasikan definisi dan penugasan cetak biru yang ada ke Spesifikasi Templat dan Tumpukan Penyebaran. Artefak cetak biru akan dikonversi ke templat ARM JSON atau file Bicep yang digunakan untuk menentukan tumpukan penyebaran. Untuk mempelajari cara menulis artefak sebagai sumber daya ARM, lihat:
Azure Blueprints dapat dikelola sepenuhnya melalui portal Microsoft Azure. Ketika organisasi melangkah maju dalam penggunaan Azure Blueprints, mereka harus mulai memikirkan definisi cetak biru sebagai kode terkelola. Konsep ini sering disebut sebagai Infrastructure as Code (IAC). Memperlakukan definisi cetak biru Anda sebagai kode menawarkan keuntungan tambahan di luar apa yang ditawarkan portal Microsoft Azure. Manfaat ini mencakup:
- Berbagi definisi blueprint
- Mencadangkan definisi cetak biru Anda
- Menggunakan kembali definisi cetak biru di penyewa atau langganan yang berbeda
- Menempatkan definisi cetak biru dalam kontrol sumber
- Pengujian definisi cetak biru otomatis di lingkungan pengujian
- Dukungan integrasi berkelanjutan dan saluran penyebaran berkelanjutan (CI/CD)
Apa pun alasan Anda, mengelola definisi cetak biru Anda sebagai kode memiliki manfaat. Artikel ini memperlihatkan cara menggunakan perintah Import-AzBlueprintWithArtifact
dan Export-AzBlueprintWithArtifact
dalam modul Az.Blueprint.
Prasyarat
Artikel ini mengasumsikan pengetahuan kerja moderat tentang Azure Blueprints. Jika Anda belum melakukannya, kerjakan artikel berikut ini:
- Membuat cetak biru di portal
- Baca tentang tahapan penyebaran dan siklus hidup cetak biru
- Membuat dan mengelola definisi dan penugasa cetak biru dengan PowerShell
Jika belum diinstal, ikuti instruksi di modul Tambahkan Az.Blueprint untuk menginstal dan memvalidasi modul Az.Blueprint dari Galeri PowerShell.
Struktur folder dari definisi cetak biru
Sebelum melihat mengekspor dan mengimpor cetak biru, mari kita lihat bagaimana file yang membentuk definisi cetak biru disusun. Definisi cetak biru harus disimpan di foldernya sendiri.
Penting
Jika tidak ada nilai yang diteruskan ke parameter Nama dari cmdlet Import-AzBlueprintWithArtifact
, nama folder yang disimpan dalam definisi cetak biru akan digunakan.
Seiring dengan definisi cetak biru, yang harus diberi nama blueprint.json
, adalah artefak yang membentuk definisi cetak biru. Setiap artefak harus berada di subfolder bernama artifacts
.
Saat disatukan, struktur definisi cetak biru Anda sebagai file JSON dalam folder harus terlihat sebagai berikut:
.
|
|- 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
Mengekspor definisi cetak biru Anda
Langkah-langkah untuk mengekspor definisi cetak biru Anda sangat mudah. Mengekspor definisi cetak biru dapat berguna untuk berbagi, mencadangkan, atau menempatkan ke dalam kontrol sumber.
- Cetak biru [diperlukan]
- Menetapkan definisi cetak biru
- Gunakan
Get-AzBlueprint
untuk mendapat objek referensi
- OutputPath [diperlukan]
- Menentukan jalur untuk menyimpan berkas JSON definisi cetak biru
- File keluaran berada dalam subfolder dengan nama definisi cetak biru
- Versi (opsional)
- Menentukan versi yang akan dihasilkan jika objek referensi Blueprint berisi referensi ke lebih dari satu versi.
Dapatkan referensi ke definisi cetak biru untuk diekspor dari langganan yang dinyatakan sebagai
{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'
Gunakan cmdlet
Export-AzBlueprintWithArtifact
untuk mengekspor definisi cetak biru yang ditentukan:Export-AzBlueprintWithArtifact -Blueprint $bpDefinition -OutputPath 'C:\Blueprints'
Mengekspor definisi cetak biru Anda
Setelah Anda memiliki definisi cetak biru yang diekspor atau memiliki definisi cetak biru yang dibuat secara manual dalam struktur folder yang diperlukan, Anda dapat mengimpor definisi cetak biru itu ke grup manajemen atau langganan yang berbeda.
Untuk contoh definisi blueprint bawaan, lihat repositori GitHub Azure Blueprints.
- Nama [diperlukan]
- Menentukan nama untuk definisi cetak biru baru
- InputPath [diperlukan]
- Menentukan jalur untuk membuat definisi cetak biru
- Harus cocok dengan struktur folder yang diperlukan
- ManagementGroupId (opsional)
- ID grup manajemen untuk menyimpan definisi cetak biru jika bukan default konteks saat ini
- ManagementGroupId atau SubscriptionId harus ditentukan
- SubscriptionId (opsional)
- ID grup langganan untuk menyimpan definisi cetak biru jika bukan default konteks saat ini
- ManagementGroupId atau SubscriptionId harus ditentukan
Gunakan cmdlet
Import-AzBlueprintWithArtifact
untuk mengimpor definisi cetak biru yang ditentukan:# Login first with Connect-AzAccount if not using Cloud Shell Import-AzBlueprintWithArtifact -Name 'MyBlueprint' -ManagementGroupId 'DevMG' -InputPath 'C:\Blueprints\MyBlueprint'
Setelah definisi cetak biru diimpor, tetapkan dengan PowerShell.
Untuk informasi tentang membuat definisi cetak biru tingkat lanjut, lihat artikel berikut ini:
- Gunakan parameter statis dan dinamis.
- Pelajari cara menyesuaikan urutan rangkaian cetak biru.
- Lindungi penyebaran dengan penguncian sumber daya cetak biru.
- Kelola Cetak Biru sebagai Kode.
Langkah berikutnya
- Pelajari lebih lanjut tentang siklus hidup cetak biru.
- Pahami cara menggunakan parameter statik dan dinamis.
- Pelajari cara menyesuaikan urutan pengurutan cetak biru.
- Cari tahu cara memanfaatkan penguncian sumber daya cetak biru.
- Mengatasi masalah selama penetapan cetak biru dengan pemecahan masalah umum.