Share via

Mengotomatiskan instalasi runtime integrasi yang dihost sendiri menggunakan skrip PowerShell lokal

  • Artikel

Untuk mengotomatiskan instalasi Integration Runtime yang Dihost sendiri di komputer lokal (selain Azure VM dimana kita dapat memanfaatkan templat Resource Manager), Anda dapat menggunakan skrip PowerShell lokal. Artikel ini memperkenalkan dua skrip yang dapat Anda gunakan.

Prasyarat

  • Luncurkan PowerShell di komputer lokal Anda. Untuk menjalankan skrip, Anda harus memilih Jalankan sebagai Administrator.
  • Unduh perangkat lunak runtime integrasi yang dihost sendiri. Salin jalur tempat file yang diunduh.
  • Anda juga memerlukan kunci otentikasi untuk mendaftarkan runtime integrasi yang dihost sendiri.
  • Untuk mengotomatiskan pembaruan manual, Anda harus memiliki runtime integrasi yang dihost sendiri yang telah dikonfigurasi sebelumnya.

Pengenalan skrip

Catatan

Skrip ini dibuat menggunakan utilitas baris perintah yang didokumentasikan dalam runtime integrasi yang dihost sendiri. Jika diperlukan, Anda dapat mengkustomisasi skrip ini sesuai dengan kebutuhan otomatisasi Anda. Skrip perlu diterapkan per simpul, jadi pastikan untuk menjalankannya di semua simpul jika terjadi pengaturan ketersediaan tinggi (2 simpul atau lebih).

  • Untuk pengaturan otomatis: Pasang dan daftarkan node runtime integrasi yang dihost sendiri menggunakan InstallGatewayOnLocalMachine.ps1 - Skrip dapat digunakan untuk memasang node runtime integrasi yang dihost sendiri dan mendaftarkannya dengan kunci autentikasi. Skrip menerima dua argumen, pertama-tama menentukan lokasi runtime integrasi yang dihost sendiri pada disk lokal, kedua menentukan kunci otentikasi (untuk mendaftarkan simpul IR yang dihost sendiri).

  • Untuk mengotomatiskan pembaruan manual: Perbarui simpul IR yang dihost sendiri dengan versi tertentu atau ke versi terbaru script-update-gateway.ps1 - Tindakan ini juga didukung jika Anda telah mematikan pembaruan otomatis, atau ingin memiliki kontrol lebih banyak atas pembaruan. Skrip dapat digunakan untuk memperbarui simpul runtime integrasi yang dihost sendiri ke versi terbaru atau ke versi yang lebih tinggi yang ditentukan (turun tingkat tidak berfungsi). Skrip Ini menerima argumen untuk menentukan nomor versi (misalnya: -version 3.13.6942.1). Jika tidak ada versi yang ditentukan, IR yang dihost sendiri selalu diperbarui ke versi terbaru yang ditemukan dalam unduhan.

    Catatan

    Hanya 3 versi terakhir yang dapat ditentukan. Idealnya ini digunakan untuk memperbarui simpul yang ada ke versi terbaru. SKRIP INI MENGASUMSIKAN BAHWA ANDA MEMILIKI IR YANG DIHOST SENDIRI YANG SUDAH TERDAFTAR.

Contoh penggunaan

Untuk pengaturan otomatisasi

  1. Unduh IR yang dihost sendiri.

  2. Tentukan jalur tempat SHIR MSI yang diunduh di atas (file penginstalan) berada. Misalnya, jika jalurnyaC:\Users\username\Downloads\IntegrationRuntime_4.7.7368.1.msi, maka Anda dapat menggunakan contoh baris perintah PowerShell berikut untuk tugas ini:

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

    Catatan

    Ganti [kunci] dengan kunci autentikasi untuk mendaftarkan runtime integrasi Anda. Ganti "nama pengguna" dengan nama pengguna Anda. Tentukan lokasi file "InstallGatewayOnLocalMachine.ps1" ketika menjalankan skrip. Dalam contoh ini kami menyimpannya di Desktop.

  3. Jika ada satu IR yang dihost sendiri yang telah diinstal sebelumnya di komputer Anda, skrip secara otomatis manghapus instalasinya dan kemudian mengkonfigurasi yang baru. Anda akan melihat jendela berikut muncul: mengonfigurasi runtime integrasi

  4. Ketika penginstalan dan pendaftaran kunci selesai, Anda akan melihat hasil Berhasil menginstal gateway dan Berhasil mendaftarkan gateway di PowerShell lokal Anda. skrip 1 jalankan hasil

Untuk mengotomatisasi pembaruan manual

Skrip ini digunakan untuk memperbarui/menginstal + mendaftarkan runtime integrasi terbaru yang dihost sendiri. Eksekusi skrip akan melakukan langkah-langkah berikut:

  1. Periksa versi IR yang dihost sendiri saat ini
  2. Dapatkan versi terbaru atau versi yang ditentukan dari argumen
  3. Jika ada versi yang lebih baru dari versi saat ini:
    • unduh IR yang dihost sendiri msi
    • tingkatkan

Anda dapat mengikuti contoh baris perintah di bawah ini untuk menggunakan skrip ini:

  • Unduh dan instal gateway terbaru:

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

  • Unduh dan instal gateway dari versi yang ditentukan:

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

    Jika versi yang Anda gunakan saat ini adalah versi terbaru, Anda akan melihat hasil berikut, menunjukkan tidak ada pembaruan yang diperlukan. [script 2 run result](media/self-hosted-integration-runtime-automation-scripts/script-2-run-result.png)