Mengelola lingkungan Runtime dan runbook terkait

1. Masuk ke portal Microsoft Azure dan pilih akun Automation Anda.

2. Di bawah Otomatisasi Proses, pilih Lingkungan Runtime (pratinjau) lalu pilih Buat.

3. Pada Dasar-Dasar, berikan detail berikut:

   1. Nama untuk lingkungan Runtime. Ini harus dimulai dengan alfabet dan hanya dapat berisi alfabet, angka, garis bawah, dan tanda hubung.

   2. Dari menu drop-down Bahasa , pilih bahasa skrip untuk lingkungan Runtime.

      • Pilih PowerShell untuk bahasa pembuatan skrip PowerShell atau Python untuk bahasa pembuatan skrip Python.

   3. Pilih Versi runtime untuk bahasa skrip.

      • Untuk PowerShell - pilih 5.1, 7.2
      • Untuk Python - pilih 3.8, 3.10 (pratinjau)

   4. Berikan Deskripsi yang sesuai.

      

4. Pilih Berikutnya dan di tab Paket , unggah paket yang diperlukan selama eksekusi runbook. Paket Az PowerShell diunggah secara default untuk semua lingkungan PowerShell Runtime, yang mencakup semua cmdlet untuk mengelola sumber daya Azure. Anda dapat memilih versi paket Az dari menu dropdown. Pilih Tidak Ada jika Anda tidak ingin Paket diunggah selama eksekusi runbook.

   

   Catatan

   Perintah Azure CLI didukung (pratinjau) dalam runbook yang terkait dengan lingkungan Runtime PowerShell 7.2. Perintah Azure CLI versi 2.56.0 tersedia sebagai paket default di lingkungan Runtime PowerShell 7.2.

5. Untuk mengunggah lebih banyak Paket yang diperlukan selama eksekusi runbook. Pilih Tambahkan file untuk menambahkan file yang disimpan secara lokal di komputer Anda atau pilih Tambahkan dari galeri untuk mengunggah paket dari galeri PowerShell.

   

   Catatan

   • Saat Anda mengimpor paket, mungkin perlu waktu beberapa menit. 100MB adalah ukuran total maksimum file yang dapat Anda impor.
   • Gunakan file .zip untuk jenis runbook PowerShell seperti yang disebutkan di sini
   • Untuk paket Python 3.8, gunakan file .whl yang menargetkan cp38-amd64.
   • Untuk paket Python 3.10 (pratinjau), gunakan file .whl yang menargetkan OS Linux cp310.

6. Pilih Berikutnya dan di tab Tinjau + Buat , verifikasi bahwa pengaturan sudah benar. Saat Anda memilih Buat, Azure menjalankan validasi pada pengaturan lingkungan Runtime yang telah Anda pilih. Jika validasi lolos, Anda dapat melanjutkan untuk membuat lingkungan Runtime lain, portal menunjukkan pengaturan yang perlu Anda ubah.

Di halaman Lingkungan Runtime (pratinjau), Anda dapat melihat lingkungan Runtime yang baru dibuat untuk akun Automation Anda. Jika Anda tidak menemukan lingkungan Runtime yang baru dibuat dalam daftar, pilih Refresh.

Anda dapat membuat lingkungan Runtime baru untuk PowerShell 7.2 dengan modul Az PowerShell di Automation

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview 

{ 
  "properties": { 
    "runtime": { 
        "language": "PowerShell",  
        "version": "7.2" 
        }, 
        "defaultPackages": { 
            "Az": "7.3.0" 
        } 
     }, 
    "name": "<runtimeEnvironmentName>" 
} 

Unggah paket Az.Accounts ke lingkungan Runtime.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>/packages/Az.Accounts?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "contentLink": { 
        "uri": "https://psg-prod-eastus.azureedge.net/packages/az.accounts.2.12.4.nupkg" 
    } 
  } 
} 

1. Di akun Automation Anda, di bawah Otomatisasi Proses, pilih Lingkungan Runtime (pratinjau).

   

GET 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments?api-version=2023-05-15-preview 

1. Di akun Automation Anda, di bawah Otomatisasi Proses, pilih Lingkungan Runtime (pratinjau).

2. Pilih lingkungan runtime yang ingin Anda hapus.

3. Pilih Hapus untuk menghapus lingkungan Runtime.

   

DELETE  
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview 

1. Di akun Automation Anda, di bawah Otomatisasi Proses, pilih Lingkungan Runtime (pratinjau).

2. Pilih lingkungan Runtime yang ingin Anda perbarui.

3. Pilih versi dari dropdown untuk memperbarui versi paket yang ada.

4. Pilih Simpan.

   

5. Pilih Tambahkan file untuk mengunggah paket dari komputer lokal Anda atau Tambahkan dari galeri untuk mengunggah paket dari Galeri PowerShell.

   

   Catatan

   Anda dapat menambahkan hingga 10 paket sekali waktu ke lingkungan Runtime. Pastikan Anda Menyimpan setelah menambahkan 10 paket.

Perbarui versi modul Az dari lingkungan Runtime yang ada:

PATCH 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview 
{ 

  "properties": { 

        "defaultPackages": { 

            "Az": "9.0.0" 

        } 

     } 

} 

Prasyarat

• Pastikan Anda telah membuat lingkungan Runtime sebelum membuat runbook.

Untuk membuat runbook baru yang ditautkan ke lingkungan Runtime, ikuti langkah-langkah berikut:

1. Di akun Automation Anda, di bawah Automation Proses, pilih Runbook.

2. Pilih Buat.

3. Di tab Dasar , Anda dapat membuat runbook baru atau mengunggah file dari komputer lokal Anda atau dari galeri PowerShell.

   1. Berikan Nama untuk runbook. Ini harus dimulai dengan huruf dan hanya dapat berisi huruf, angka, garis bawah, dan tanda hubung.

   2. Dari menu dropdown Jenis runbook, pilih jenis runbook yang ingin Anda buat.

   3. Pilih Lingkungan runtime yang akan dikonfigurasi untuk runbook. Anda dapat Memilih dari lingkungan Runtime yang ada atau Membuat lingkungan Runtime baru dan menautkannya ke Runbook. Daftar lingkungan runtime diisi berdasarkan jenis Runbook yang dipilih di langkah b.

   4. Berikan Deskripsi yang sesuai.

      

   Catatan

   Untuk Jenis Runbook PowerShell, hanya lingkungan Runtime PowerShell yang akan dicantumkan untuk pilihan. Untuk Jenis Runbook Python, hanya lingkungan Runtime Python yang akan dicantumkan untuk pilihan.

4. Tambahkan Tag ke runbook, tinjau pengaturan dan pilih Buat untuk membuat runbook baru.

Runbook ini ditautkan ke lingkungan Runtime yang dipilih. Semua paket di lingkungan Runtime yang dipilih akan tersedia selama eksekusi runbook.

Prasyarat

• Konfigurasikan lingkungan PowerShell Runtime dan berikan sebagai input untuk pembuatan runbook.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2023-05-15-preview 

{ 
  "properties": { 
        "runbookType": "PowerShell", 
        "runtimeEnvironment": <runtimeEnvironmentName>, 
        "publishContentLink": { 
            "uri": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-automation-runbook-getvms/Runbooks/Get-AzureVMTutorial.ps1" 
        } 
    }, 
   "location": "East US"
} 

1. Di akun Automation Anda, di bawah Automation Proses, pilih Runbook.

2. Pilih kotak centang untuk runbook yang ingin Anda perbarui.

3. Pilih Perbarui.

4. Pilih lingkungan Runtime dari dropdown tempat Anda ingin menautkan runbook.

5. Pilih Perbarui untuk memperbarui runbook yang dipilih dengan lingkungan Runtime baru.

Periksa apakah runbook dijalankan seperti yang diharapkan setelah pembaruan. Jika runbook gagal memberikan hasil yang diharapkan, Anda dapat kembali memperbarui lingkungan Runtime ke pengalaman lama dengan mengikuti langkah 1-4.

Memperbarui lingkungan Runtime yang ditautkan ke runbook.

PATCH 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "type": "PowerShell" 
    "runtimeEnvironment": "<runtimeEnvironmentName>" 
  } 
} 

Anda dapat memperbarui runbook dengan mengubah lingkungan Runtime yang ditautkan ke runbook tersebut. Kami menyarankan Anda untuk menguji eksekusi runbook sebelum menerbitkan perubahan. Ini untuk memastikan runbook berfungsi seperti yang diharapkan.

Untuk menguji eksekusi runbook sebelum menerbitkan perubahan lingkungan Runtime, ikuti langkah-langkah berikut:

1. Buka halaman Runbook, dan pilih runbook yang ingin Anda perbarui lingkungan Runtime.

   

2. Di halaman Edit runbook , pilih Edit di Portal untuk membuka editor teks.

3. Bidang Lingkungan runtime memperlihatkan konfigurasi yang ada. Pilih lingkungan Runtime baru dari daftar dropdown.

   

4. Pilih Panel uji untuk menguji eksekusi runbook dengan lingkungan Runtime yang diperbarui. Pilih Mulai untuk memulai uji coba.

5. Tutup panel pengujian dan buat perubahan yang diperlukan dalam kode Runbook atau lingkungan Runtime jika perlu.

6. Pilih Terbitkan untuk memperbarui lingkungan Runtime yang ditautkan ke runbook.

7. Pilih Ya untuk mengambil alih versi yang diterbitkan sebelumnya dan mengonfirmasi perubahan.

Jalankan pekerjaan pengujian untuk runbook dengan lingkungan Runtime yang berbeda. Skenario ini berguna ketika runbook perlu diuji dengan lingkungan Runtime sebelum diperbarui.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>/draft/testJob?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "runtimeEnvironment": "<runtimeEnvironmentName>" 
    "runOn": "" 
  } 
} 

Saat ini, runbook yang ditautkan ke lingkungan Runtime akan berjalan di Azure.

Pekerjaan mewarisi lingkungan Runtime dari runbook. Jalankan pekerjaan cloud untuk runbook yang diterbitkan:

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/jobs/<jobName>?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "runbook": { 
      "name": "<runbookName>" 
    }, 
    "runOn": "" 
  } 
}