Çalışma Zamanı ortamı ve ilişkili runbook'ları yönetme

Bu makalede, Azure portalı ve REST API aracılığıyla Çalışma Zamanı Ortamı oluşturma ve çeşitli işlemler gerçekleştirme hakkında bilgi sağlanır.

Önkoşullar

Desteklenen genel bölgede (Orta Hindistan, Kuzey Almanya, Kuzey İtalya, Orta İsrail, Orta Polonya, Orta BAE ve Kamu bulutları hariç) bir Azure Otomasyonu hesabı.

Çalışma zamanı ortamı ile eski deneyim arasında geçiş yapma

Çalışma zamanı ortamı deneyimi

1. Genel Bakış'ı ve ardından Çalışma Zamanı ortamı deneyimini deneyin'i seçin.

   

2. İşlem Otomasyonu'nun altında Çalışma Zamanı Ortamları (Önizleme) vardır ve Çalışma Zamanı ortamı Runbook yürütmesi sırasında gerekli paketlerin yönetimine izin verdiğinden, Paylaşılan kaynaklar altındaki Modüller ve Python paketleri kaldırılır.

   

3. Modülleri ve Paketleri yönetmeye yönelik eski deneyime geri dönmek için sol bölmede Genel Bakış'ı ve ardından Eski Deneyime Geç'i seçin.

   

Eski deneyim

1. Otomasyon hesabınıza gidin, İşlem Otomasyonu altında Çalışma Zamanı ortamları (önizleme) kaldırılır ve Paylaşılan kaynaklar'ın altında Modüller ve Python paketleri görülebilir.

   

Not

Runbook güncelleştirmeleri, yeni Çalışma Zamanı ortamı deneyimi ile eski deneyim arasında kalır. Bir runbook'a bağlı Çalışma Zamanı ortamında yapılan tüm değişiklikler, runbook yürütme sırasında eski deneyimde kalıcı olur.

Çalışma Zamanı ortamını yönetme

Çalışma Zamanı ortamı oluşturma

Azure portalı

1. Azure portalında oturum açın ve Otomasyon hesabınızı seçin.

2. İşlem Otomasyonu altında Çalışma Zamanı Ortamları (önizleme) öğesini ve ardından Oluştur'u seçin.

3. Temel Bilgiler bölümünde aşağıdaki ayrıntıları sağlayın:

   1. Çalışma Zamanı ortamının adı . Alfabeyle başlamalıdır ve yalnızca alfabe, sayı, alt çizgi ve tire içerebilir.

   2. Dil açılan listesinden Çalışma Zamanı ortamı için betik dilini seçin.

      • PowerShell betik dili için PowerShell'i veya Python betik dili için Python'ı seçin.

   3. Betik dili için Çalışma Zamanı sürümü'ne tıklayın.

      • PowerShell için - 5.1, 7.2'yi seçin
      • Python için - 3.8, 3.10 (önizleme) seçeneğini belirleyin

   4. Uygun Açıklamayı belirtin.

      

4. İleri'yi seçin ve Paketler sekmesinde runbook yürütmesi sırasında gereken paketleri karşıya yükleyin. Az PowerShell paketi, Azure kaynaklarını yönetmeye yönelik tüm cmdlet'leri içeren tüm PowerShell Çalışma Zamanı ortamları için varsayılan olarak karşıya yüklenir. Açılan listeden Az package sürümünü seçebilirsiniz. Runbook yürütmesi sırasında Paketin karşıya yüklenmesini istemiyorsanız Yok'u seçin.

   

   Not

   Azure CLI komutları, PowerShell 7.2 Çalışma Zamanı ortamıyla ilişkili runbook'larda desteklenir (önizleme). Azure CLI komutları sürüm 2.56.0, PowerShell 7.2 Çalışma Zamanı ortamında varsayılan paket olarak kullanılabilir.

5. Runbook yürütme sırasında gereken daha fazla Paketi karşıya yüklemek için. Bilgisayarınızda yerel olarak depolanan dosyaları eklemek için Dosya ekle'yi seçin veya PowerShell galerisinden paketleri karşıya yüklemek için Galeriden ekle'yi seçin.

   

   Not

   • Bir paketi içeri aktardığınızda bu işlem birkaç dakika sürebilir. 100 MB, içeri aktarabileceğiniz dosyaların toplam boyutu üst sınırıdır.
   • Burada belirtildiği gibi PowerShell runbook türleri için .zip dosyaları kullanın
   • Python 3.8 paketleri için cp38-amd64'i hedefleyen .whl dosyalarını kullanın.
   • Python 3.10 (önizleme) paketleri için cp310 Linux işletim sistemini hedefleyen .whl dosyalarını kullanın.

6. İleri'yi seçin ve Gözden Geçir + Oluştur sekmesinde ayarların doğru olduğundan emin olun. Oluştur'u seçtiğinizde Azure, seçtiğiniz Çalışma Zamanı ortamı ayarlarında doğrulamayı çalıştırır. Doğrulama başarılı olursa, Çalışma Zamanı ortamı oluşturmaya devam edebilirsiniz, portalda değiştirmeniz gereken ayarlar gösterilir.

Çalışma Zamanı Ortamları (önizleme) sayfasında Otomasyon hesabınız için yeni oluşturulan Çalışma Zamanı ortamını görüntüleyebilirsiniz. Yeni oluşturulan Çalışma Zamanı ortamlarını listede bulamazsanız Yenile'yi seçin.

REST API

Otomasyon'da Az PowerShell modülüyle PowerShell 7.2 için yeni bir Çalışma Zamanı ortamı oluşturabilirsiniz

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>" 
} 

Az.Accounts paketini Çalışma Zamanı ortamına yükleyin.

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" 
    } 
  } 
} 

Çalışma Zamanı ortamını görüntüleme

Otomasyon hesabından Çalışma Zamanı ortamı özelliklerini alın.

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

Çalışma Zamanı ortamlarını listeleme

Otomasyon hesabından tüm Çalışma Zamanı ortamlarını listelemek için:

Azure portalı

1. Otomasyon hesabınızda, İşlem Otomasyonu altında Çalışma Zamanı Ortamları (önizleme) öğesini seçin.

   

REST API

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

Az PowerShell paketinin bileşenlerini görüntüleme

Az PowerShell paketinin tüm bileşen paketlerini görüntülemek için bir PowerShell runbook'unda cmdlet'i çalıştırınGet-Module -ListAvailable.

İş çıktısı tüm bileşen paketlerini ve bunların sürümlerini gösterir.

Çalışma Zamanı ortamını silme

Otomasyon hesabından Çalışma Zamanı ortamını silmek için şu adımları izleyin:

Azure portalı

1. Otomasyon hesabınızda, İşlem Otomasyonu altında Çalışma Zamanı Ortamları (önizleme) öğesini seçin.

2. Silmek istediğiniz çalışma zamanı ortamını seçin.

3. Çalışma Zamanı ortamını silmek için Sil'i seçin.

   

REST API

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

Çalışma Zamanı ortamını güncelleştirme

Çalışma zamanı dili ve Çalışma Zamanı sürümü sabit özelliklerdir. Ancak, modüllerin sürümünü güncelleştirebilir ve Çalışma Zamanı ortamında paket ekleyebilir veya kaldırabilirsiniz. Çalışma Zamanı ortamına bağlı runbook'lar yeni ayarlarla otomatik olarak güncelleştirilir.

Azure portalı

1. Otomasyon hesabınızda, İşlem Otomasyonu altında Çalışma Zamanı Ortamları (önizleme) öğesini seçin.

2. Güncelleştirmek istediğiniz Çalışma Zamanı ortamını seçin.

3. Mevcut paketlerin sürümünü güncelleştirmek için açılan listeden sürümü seçin.

4. Kaydet'i seçin.

   

5. Paketleri yerel bilgisayarınızdan karşıya yüklemek için Dosya ekle'yi veya PowerShell Galerisi'dan paketleri karşıya yüklemek için Galeriden ekle'yi seçin.

   

   Not

   Çalışma Zamanı ortamına aynı anda en fazla 10 paket ekleyebilirsiniz. 10 paket ekledikten sonra Kaydet'i seçtiğinizden emin olun.

REST API

Mevcut çalışma zamanı ortamının Az modülü sürümünü güncelleştirin:

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" 

        } 

     } 

} 

Çalışma Zamanı ortamına bağlı Runbook'ları yönetme

Runbook oluşturma

Çalışma Zamanı ortamıyla yapılandırılmış yeni bir PowerShell runbook'u oluşturabilirsiniz.

Azure portalı

Ön koşul

• Runbook oluşturmadan önce çalışma zamanı ortamı oluşturduğunuzdan emin olun.

Çalışma Zamanı ortamına bağlı yeni bir runbook oluşturmak için şu adımları izleyin:

1. Otomasyon hesabınızdaki İşlem Otomasyonu'nın altında Runbook'lar'ı seçin.

2. Oluştur'u belirleyin.

3. Temel Bilgiler sekmesinde yeni bir runbook oluşturabilir veya yerel bilgisayarınızdan veya PowerShell galerisinden bir dosya yükleyebilirsiniz.

   1. Runbook için bir Ad belirtin. Bir harfle başlamalıdır ve yalnızca harf, sayı, alt çizgi ve tire içerebilir.

   2. Runbook türü açılan listesinden, oluşturmak istediğiniz runbook türünü seçin.

   3. Runbook için yapılandırılacak Çalışma zamanı ortamı'nı seçin. Mevcut Çalışma Zamanı ortamlarından birini seçebilir veya Yeni Çalışma Zamanı ortamı oluştur'u Runbook'a bağlayabilirsiniz. Çalışma zamanı ortamlarının listesi, b adımında seçilen Runbook türüne göre doldurulur.

   4. Uygun Açıklamayı belirtin.

      

   Not

   PowerShell Runbook Türü için seçim için yalnızca PowerShell Çalışma Zamanı ortamı listelenir. Python Runbook Türü için seçim için yalnızca Python Çalışma Zamanı ortamları listelenir.

4. Runbook'a Etiketler ekleyin, ayarları gözden geçirin ve Oluştur'u seçerek yeni bir runbook oluşturun.

Bu runbook seçili Çalışma Zamanı ortamına bağlıdır. Seçilen Çalışma Zamanı ortamındaki tüm paketler runbook'un yürütülmesi sırasında kullanılabilir.

REST API

Ön koşul

• Bir PowerShell Çalışma Zamanı ortamı yapılandırın ve runbook oluşturma için giriş olarak sağlayın.

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"
} 

Not

Benzer API'ler Python runbook türü için de çalışır.

Runbook'u güncelleştirme

Runbook'a bağlı Çalışma Zamanı ortamını değiştirerek runbook'u güncelleştirebilirsiniz. Güncelleştirme için tek veya birden çok runbook seçebilirsiniz. Çalışma durumundaki runbook, bu runbook'a bağlı Çalışma Zamanı ortamını değiştirerek etkilenmez.

Azure portalı

1. Otomasyon hesabınızdaki İşlem Otomasyonu'nın altında Runbook'lar'ı seçin.

2. Güncelleştirmek istediğiniz runbook'ların onay kutusunu seçin.

3. Güncelleştir'i seçin.

4. Runbook'ları bağlamak istediğiniz açılan listeden Çalışma Zamanı ortamını seçin.

5. Seçili runbook'ları yeni Çalışma Zamanı ortamıyla güncelleştirmek için Güncelleştir'i seçin.

Güncelleştirmeden sonra runbook'un beklendiği gibi yürütülip yürütülmediğini denetleyin. Runbook beklenen sonucu sağlayamazsa, 1-4 arası adımları izleyerek Çalışma Zamanı ortamını yeniden eski deneyime güncelleştirebilirsiniz.

Not

Runbook güncelleştirmeleri, yeni Çalışma Zamanı ortamı deneyimi ile eski deneyim arasında kalır. Bir runbook'a bağlı Çalışma Zamanı ortamında yapılan tüm değişiklikler, eski deneyimde runbook yürütme sırasında devam eder.

REST API

Runbook'a bağlı Çalışma Zamanı ortamını güncelleştirin.

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>" 
  } 
} 

Not

Runbook için Görünüm/Silme çağrıları aynı kalır ve Runbook - REST API Azure Otomasyonu | Microsoft Learn.

Runbook güncelleştirmesini test et

Farklı bir Çalışma Zamanı ortamına sahip bir runbook için test işi çalıştırın. Bu senaryo, güncelleştirmeden önce bir runbook'un Çalışma Zamanı ortamıyla test edilmesi gerektiğinde kullanışlıdır.

Azure portalı

Runbook'lara bağlı Çalışma Zamanı ortamını değiştirerek runbook'ları güncelleştirebilirsiniz. Değişiklikleri yayımlamadan önce runbook yürütmesini test etmenizi öneririz. Runbook'un beklendiği gibi çalıştığından emin olmaktır.

Çalışma zamanı ortamı değişikliklerini yayımlamadan önce runbook yürütmesini test etmek için şu adımları izleyin:

1. Runbook'lar sayfasına gidin ve Çalışma Zamanı ortamını güncelleştirmek istediğiniz runbook'u seçin.

   

2. Runbook'u düzenle sayfasında Portalda Düzenle'yi seçerek metin düzenleyicisini açın.

3. Çalışma zamanı ortamı alanında mevcut yapılandırma gösterilir. Açılan listeden yeni Çalışma Zamanı ortamını seçin.

   

4. Runbook yürütmesini güncelleştirilmiş Çalışma Zamanı ortamıyla test etmek için Test bölmesini seçin. Test çalıştırmasını başlatmak için Başlat'ı seçin.

5. Test bölmesini kapatın ve gerekirse Runbook kodunda veya Çalışma Zamanı ortamında gerekli değişiklikleri yapın.

6. Runbook'a bağlı Çalışma Zamanı ortamını güncelleştirmek için Yayımla'yı seçin.

7. Daha önce yayımlanan sürümü geçersiz kılmak ve değişiklikleri onaylamak için Evet'i seçin.

REST API

Farklı bir Çalışma Zamanı ortamına sahip bir runbook için test işi çalıştırın. Bu senaryo, güncelleştirmeden önce bir runbook'un Çalışma Zamanı ortamıyla test edilmesi gerektiğinde kullanışlıdır.

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": "" 
  } 
} 

Bulut İşi Oluşturma

Azure portalı

Şu anda Çalışma Zamanı ortamına bağlı runbook'lar Azure'da çalışır.

REST API

İşler Runbook'tan Çalışma Zamanı ortamını devralır. Yayımlanmış bir runbook için bulut işi çalıştırma:

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": "" 
  } 
} 

Not

İş için oluşturma/görüntüleme çağrıları aynı kalır ve Job-REST API'sinden (Azure Otomasyonu) başvurulabilir | Microsoft Learn.

Mevcut runbook'ları Sistem tarafından oluşturulan Çalışma Zamanı ortamlarına bağlama

Azure Otomasyonu hesabınızdaki tüm mevcut runbook'lar otomatik olarak Sistem tarafından oluşturulan Çalışma Zamanı ortamlarına bağlanır. Sistem tarafından oluşturulan bu Çalışma Zamanı ortamları, ilgili Azure Otomasyonu hesabınızda bulunan Çalışma Zamanı dili, sürümü ve Modüller/Paketler temelinde oluşturulur. Daha fazla bilgi edinin. Mevcut runbook'ları güncelleştirmek için burada belirtilen adımları izleyerek Çalışma Zamanı ortamını değiştirin.

Sonraki adımlar

• Çalışma Zamanı Ortamına genel bakış için.
• Runbook yürütme sorunlarını gidermek için bkz . Runbook sorunlarını giderme.