Ç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

Yönetilen kimliklere izin atamadan önce şu önkoşulları karşıladığınızdan emin olun:

• Brezilya Güneydoğu ve Gov bulutları dışında tüm genel bölgelerde bir Azure Otomasyonu hesabı.

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

Çalışma zamanı ortamı deneyimi

Çalışma Zamanı ortamına geçmek için şu adımları izleyin:

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

   

2. İşlem Otomasyonu'nun altında Çalışma Zamanı Ortamları'na sahip olursunuz 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

Eski deneyime geçmek için şu adımı izleyin:

1. Otomasyon hesabınıza gidin, İşlem Otomasyonu altında Çalışma Zamanı ortamları 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ı

Çalışma zamanı ortamı oluşturmak için şu adımları izleyin:

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

2. Genel Bakış sayfasında, yeni deneyimde değilseniz Çalışma Zamanı Ortamı deneyimini dene seçeneğini belirleyin.

3. İşlem Otomasyonu altında Çalışma Zamanı Ortamları'nı ve ardından Oluştur'u seçin.

4. Temel sekmesinde, aşağıdaki bilgileri girin:

   1. Çalışma Zamanı ortamının adı . Bir harfle başlamalıdır ve yalnızca harfler, sayılar, alt çizgiler ve tireler içerebilir.

   2. Dil açılır 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ü seçin.

      • PowerShell için - 5.1, 7.4'i seçin
      • Python için 3.10'u seçin

   4. Uygun Açıklamayı girin.

      

5. İleri seçeneğini belirleyin ve Paketler sekmesinde, runbook'un yürütülmesi sırasında gerekli 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.

   Not

   Azure CLI komutları, PowerShell 7.4 Çalışma Zamanı ortamıyla ilişkili runbook'larda desteklenir. Azure CLI komutları sürüm 2.64.0, PowerShell 7.4 Çalışma Zamanı ortamında varsayılan paket olarak kullanılabilir.

6. Runbook yürütülmesi sırasında gereken daha fazla paketi 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.10 paketleri için cp310 Linux işletim sistemini hedefleyen .whl dosyalarını kullanın.

7. İ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ını oluşturmaya devam edebilirsiniz; aksi takdirde portal, değiştirmeniz gereken ayarları gösterir.

Çalışma Zamanı Ortamları 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.4 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=2024-10-23 

{ 
  "properties": { 
    "runtime": { 
        "language": "PowerShell",  
        "version": "7.4" 
        }, 
        "defaultPackages": { 
            "Az": "12.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=2024-10-23

{ 
  "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=2024-10-23 

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

Azure portalı

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

1. Otomasyon hesabınızda, İşlem Otomasyonu altında Çalışma Zamanı Ortamları'nı seçin.

   

REST API

GET 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments?api-version=2024-10-23

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

Azure portalı

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

1. Otomasyon hesabınızda, İşlem Otomasyonu altında Çalışma Zamanı Ortamları'nı 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=2024-10-23

Ç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ı

Çalışma zamanı ortamını güncelleştirmek için şu adımları izleyin:

1. Otomasyon hesabınızda, İşlem Otomasyonu altında Çalışma Zamanı Ortamları'nı 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' seçeneğini veya PowerShell Galerisi'nden paketleri karşıya yüklemek için 'Galeriden ekle' seçeneğini belirleyin.

   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=2024-10-23
{ 

  "properties": { 

        "defaultPackages": { 

            "Az": "12.3.0" 

        } 

     } 

} 

Runtime ortamına bağlı runbook’ların yönetimi

Runbook oluşturun

Ç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ızda, İşlem Otomasyonu altında Runbooklar'ı 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 girin. Bir harfle başlamalıdır ve yalnızca harf, sayı, alt çizgi ve tire içerebilir.

   2. Çalıştırma kitabı türü açılır listesinden, oluşturmak istediğiniz çalıştırma kitabı 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ı girin.

      

   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ıyla ilişkilendirilmiştir. 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 bunu runbook oluşturmada girdi olarak sağlayın.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2024-10-23

{ 
  "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 bir ya da birden fazla runbook seçebilirsiniz. Çalışıyor durumdaki runbook, bu runbook’a bağlı çalışma zamanı ortamının değiştirilmesinden etkilenmezdi.

Azure portalı

Runbook'u güncelleştirmek için şu adımları izleyin:

1. Otomasyon hesabınızda, İşlem Otomasyonu altında Runbooklar'ı seçin.

2. Güncelleştirmek istediğiniz runbook’lar için onay kutusunu seçin.

3. Çalışma Zamanı Ortamını 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. Eski deneyimde, bir runbook’a bağlı çalışma zamanı ortamında yapılan tüm değişiklikler runbook yürütmesi sırasında kalıcı olurdu.

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=2024-10-23
{ 
  "properties": { 
    "type": "PowerShell",
    "runtimeEnvironment": "<runtimeEnvironmentName>" 
  } 
} 

Not

Runbook için Görüntüleme/Silme çağrıları aynı kalır ve Runbook - REST API Azure Otomasyonu | Microsoft Learn başvuru olarak kullanılabilir.

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. Amaç, runbook’un beklendiği gibi çalışmasını sağlamaktı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 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, metin düzenleyicisini açmak için Portal'da Düzenle'yi seçin.

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 düğmesini 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ı kullanan bir runbook için test görevi ç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=2024-10-23
{ 
  "properties": { 
    "runtimeEnvironment": "<runtimeEnvironmentName>" 
    "runOn": "" 
  } 
} 

Bulut İşi Oluşturma

Azure portalı

Çalışma Zamanı Ortamına bağlı runbook'ları hem Azure'da hem de Karma Çalışanı'nda yürütebilirsiniz.

REST API

İşler, çalışma zamanı ortamını runbook'tan devralır. Yayımlanmış bir runbook için bir bulut işi çalıştırın.

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

Not

İş oluşturma/görüntüleme çağrıları aynı kalır ve bunlara Job-REST API (Azure Otomasyonu) | Microsoft Learn başlığından başvurabilirsiniz.

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ı hakkında genel bilgi için.
• Çalışma zamanı desteği ve kullanımdan kaldırma hakkında bilgi için bkz. Azure Otomasyonu için dil çalışma zamanı desteği ve kullanımdan kaldırma ilkesi.
• Runbook yürütmeyle ilgili sorunları gidermek için Runbook sorunlarını giderme bölümüne bakın.