Yerel PowerShell betiklerini kullanarak şirket içinde barındırılan tümleştirme çalışma zamanı yüklemesini otomatikleştirme

  • Makale

Yerel makinelere şirket içinde barındırılan Integration Runtime yüklemesini otomatikleştirmek için (bunun yerine Resource Manager şablonundan yararlanabildiğimiz Azure VM'leri dışında), yerel PowerShell betiklerini kullanabilirsiniz. Bu makalede kullanabileceğiniz iki betik tanıtılabilir.

Önkoşullar

  • Yerel makinenizde PowerShell'i başlatın. Betikleri çalıştırmak için Yönetici Olarak Çalıştır'ı seçmeniz gerekir.
  • Şirket içinde barındırılan tümleştirme çalışma zamanı yazılımını indirin. İndirilen dosyanın bulunduğu yolu kopyalayın.
  • Şirket içinde barındırılan tümleştirme çalışma zamanını kaydetmek için bir kimlik doğrulama anahtarına da ihtiyacınız vardır.
  • El ile yapılan güncelleştirmeleri otomatikleştirmek için önceden yapılandırılmış, şirket içinde barındırılan tümleştirme çalışma zamanına sahip olmanız gerekir.

Betiklere giriş

Not

Bu betikler, şirket içinde barındırılan tümleştirme çalışma zamanında belgelenmiş komut satırı yardımcı programı kullanılarak oluşturulur. Gerekirse bu betikleri otomasyon gereksinimlerini karşılayacak şekilde özelleştirebilirsiniz. Betiklerin düğüm başına uygulanması gerektiğinden, yüksek kullanılabilirlik kurulumu (2 veya daha fazla düğüm) durumunda tüm düğümler arasında çalıştırdığınızdan emin olun.

  • Kurulumu otomatikleştirmek için: InstallGatewayOnLocalMachine.ps1 kullanarak şirket içinde barındırılan yeni bir tümleştirme çalışma zamanı düğümü yükleme ve kaydetme - Betik, şirket içinde barındırılan tümleştirme çalışma zamanı düğümünü yüklemek ve bunu bir kimlik doğrulama anahtarıyla kaydetmek için kullanılabilir. Betik, önce yerel diskte şirket içinde barındırılan tümleştirme çalışma zamanının konumunu, ikincisindekimlik doğrulama anahtarını (şirket içinde barındırılan IR düğümünü kaydetmek için) belirten iki bağımsız değişken kabul eder.

  • El ile yapılan güncelleştirmeleri otomatikleştirmek için: Şirket içinde barındırılan IR düğümünü belirli bir sürümle veya en son sürüm script-update-gateway.ps1 güncelleştirin- Bu, otomatik güncelleştirmeyi kapatmış olmanız veya güncelleştirmeler üzerinde daha fazla denetim sahibi olmak istemeniz durumunda da desteklenir. Betik, şirket içinde barındırılan tümleştirme çalışma zamanı düğümünü en son sürüme veya belirtilen daha yüksek bir sürüme güncelleştirmek için kullanılabilir (eski sürüm çalışmaz). Sürüm numarasını belirtmek için bir bağımsız değişken kabul eder (örnek: -version 3.13.6942.1). Sürüm belirtilmediğinde, şirket içinde barındırılan IR'yi her zaman indirmelerde bulunan en son sürüme güncelleştirir.

    Not

    Yalnızca son 3 sürüm belirtilebilir. İdeal olarak bu, mevcut bir düğümü en son sürüme güncelleştirmek için kullanılır. ŞIRKET IÇINDE BARıNDıRıLAN KAYıTLı BIR IR'NIZ OLDUĞU VARSAYıLıR.

Kullanım örnekleri

Kurulumu otomatikleştirmek için

  1. Şirket içinde barındırılan IR'yi indirin.

  2. Yukarıdaki indirilen SHIR MSI'nin (yükleme dosyası) bulunduğu yolu belirtin. Örneğin, yol C:\Users\username\Downloads\IntegrationRuntime_4.7.7368.1.msiise, bu görev için aşağıdaki PowerShell komut satırı örneğini kullanabilirsiniz:

    PS C:\windows\system32> C:\Users\username\Desktop\InstallGatewayOnLocalMachine.ps1 -path "C:\Users\username\Downloads\IntegrationRuntime_4.7.7368.1.msi" -authKey "[key]"

    Not

    IR'nizi kaydetmek için [key] değerini kimlik doğrulama anahtarıyla değiştirin. "kullanıcı adı" yerine kullanıcı adınızı yazın. Betiği çalıştırırken "InstallGatewayOnLocalMachine.ps1" dosyasının konumunu belirtin. Bu örnekte masaüstünde depoladık.

  3. Makinenizde önceden yüklenmiş bir şirket içinde barındırılan IR varsa, betik bunu otomatik olarak kaldırır ve sonra yeni bir IR yapılandırılır. Şu pencerenin gösterildiğini göreceksiniz: tümleştirme çalışma zamanını yapılandırma

  4. Yükleme ve anahtar kaydı tamamlandığında Ağ geçidini yüklemeyi başar ve Ağ geçidi sonuçlarını yerel PowerShell'inize kaydetmek için başarılı seçeneğini görürsünüz. betik 1 çalıştırma sonucu

El ile güncelleştirmeleri otomatikleştirmek için

Bu betik, şirket içinde barındırılan en son tümleştirme çalışma zamanını güncelleştirmek/yüklemek ve kaydetmek için kullanılır. Betik çalıştırması aşağıdaki adımları gerçekleştirir:

  1. Şirket içinde barındırılan geçerli IR sürümünü denetleme
  2. Bağımsız değişkenden en son sürümü veya belirtilen sürümü alma
  3. Geçerli sürümden daha yeni bir sürüm varsa:
    • şirket içinde barındırılan IR msi'lerini indirme
    • yükseltin

Bu betiği kullanmak için aşağıdaki komut satırı örneğini izleyebilirsiniz:

  • En son ağ geçidini indirme ve yükleme:

    PS C:\windows\system32> C:\Users\username\Desktop\script-update-gateway.ps1

  • Belirtilen sürümün ağ geçidini indirin ve yükleyin:

    PS C:\windows\system32> C:\Users\username\Desktop\script-update-gateway.ps1 -version 3.13.6942.1

    Geçerli sürümünüz zaten en son sürümse, güncelleştirme gerekmediğini öneren aşağıdaki sonucu görürsünüz. [betik 2 çalıştırma sonucu](media/self-hosted-integration-runtime-automation-scripts/script-2-run-result.png)