Node SSH - DataWorks

Node SSH dapat dibuat dan digunakan berdasarkan sumber data SSH tertentu di DataWorks untuk mengakses host yang terhubung secara remote serta memicu eksekusi skrip pada host tersebut. Topik ini menjelaskan cara membuat dan menggunakan node SSH.

Pengenalan Node

Di DataWorks, Anda dapat menambahkan sumber data SSH dan mengonfigurasi informasi akses host untuk menerapkan akses jarak jauh ke sebuah host. Kemudian, Anda dapat menggunakan node SSH untuk mengakses host secara remote berdasarkan sumber data. Sebagai contoh, Anda dapat menggunakan metode ini untuk mengakses Instance ECS (Elastic Compute Service) dari DataWorks secara remote dan memicu penjadwalan periodik skrip pada instance ECS tersebut.

Prasyarat

Pengguna RAM yang ingin digunakan telah ditambahkan ke ruang kerja Anda.
Jika Anda ingin menggunakan Pengguna RAM untuk mengembangkan tugas, tambahkan Pengguna RAM ke ruang kerja Anda sebagai anggota dan berikan peran Develop atau Workspace Administrator. Peran Workspace Administrator memiliki lebih banyak izin daripada yang diperlukan. Berhati-hatilah saat memberikan peran Workspace Administrator. Untuk informasi lebih lanjut tentang cara menambahkan anggota dan menetapkan peran kepada anggota, lihat Tambahkan anggota ke ruang kerja.
Kelompok sumber daya tanpa server telah dikaitkan dengan ruang kerja Anda. Untuk informasi lebih lanjut, lihat topik-topik dalam direktori Gunakan kelompok sumber daya tanpa server.
Sebuah node SSH telah dibuat sebelum Anda mengembangkan tugas pada node tersebut. Untuk informasi lebih lanjut, lihat Buat node tugas.
Sumber data SSH telah ditambahkan.
Anda harus menambahkan sumber data SSH untuk mengakses server SSH Anda secara remote sebelum mengembangkan dan menjadwalkan tugas SSH secara periodik dalam node SSH. Untuk informasi tentang cara menambahkan sumber data, lihat Sumber data SSH.
Catatan
Anda dapat menggunakan node SSH untuk mengembangkan tugas hanya berdasarkan sumber data SSH yang ditambahkan ke DataWorks dalam mode string koneksi Java Database Connectivity (JDBC). Selain itu, pastikan bahwa sumber data Anda terhubung ke kelompok sumber daya yang diinginkan untuk mencegah kegagalan eksekusi tugas.

Batasan

Kode yang dijalankan dalam node SSH tidak boleh melebihi ukuran 128 KB.

Perhatian

Ketika proses dimulai pada host jarak jauh menggunakan node SSH, operasi pada host jarak jauh yang mendasarinya tidak akan terpengaruh meskipun tugas pada node SSH keluar karena pengecualian, seperti waktu habis tugas. Dalam hal ini, DataWorks tidak mengeluarkan perintah penghentian proses ke host jarak jauh.
Node SSH mendukung sintaks shell standar tetapi tidak mendukung sintaks interaktif.
Ketika node SSH digunakan untuk memicu eksekusi skrip pada instance ECS, file sementara akan dihasilkan pada instance ECS. Pastikan kapasitas penyimpanan dan jumlah maksimum file pada instance ECS memenuhi persyaratan bisnis Anda.
Jangan jalankan beberapa tugas pada file yang sama secara bersamaan, karena ini dapat menyebabkan kegagalan node SSH.

Langkah 1: Gunakan node SSH untuk mengembangkan tugas

(Opsional) Pilih sumber data SSH

Jika beberapa sumber data SSH ditambahkan ke ruang kerja Anda, pilih salah satu dari daftar drop-down Pilih Sumber Data di bagian atas tab konfigurasi node sesuai kebutuhan bisnis Anda. Jika hanya satu sumber data SSH yang ditambahkan ke ruang kerja Anda, sumber data SSH tersebut digunakan untuk mengembangkan tugas.

Catatan

Anda dapat menggunakan node SSH untuk mengembangkan tugas hanya berdasarkan sumber data SSH yang ditambahkan ke DataWorks dalam mode string koneksi JDBC. Selain itu, pastikan bahwa sumber data Anda terhubung ke kelompok sumber daya yang diinginkan untuk mencegah kegagalan eksekusi tugas.

Kembangkan kode: Contoh sederhana

Di editor kode pada tab konfigurasi node SSH, tulis kode tugas. Kode berikut digunakan dalam contoh ini.

# 1. Siapkan lingkungan.
# Temukan file yang ingin Anda jalankan pada host jarak jauh. Sebagai contoh, file nihao.sh disimpan di direktori tmp host jarak jauh.
# Untuk memudahkan pengujian, Anda dapat menjalankan perintah berikut pada node SSH untuk membuat file nihao.sh:
echo "echo nihao,dataworks" >/tmp/nihao.sh
# 2. Gunakan node SSH untuk memicu eksekusi file pada host jarak jauh.
# Gunakan node SSH di DataWorks untuk memicu eksekusi file nihao.sh.
sh /tmp/nihao.sh

Kembangkan kode: Gunakan parameter penjadwalan

DataWorks menyediakan parameter penjadwalan yang nilainya diganti secara dinamis dalam kode tugas berdasarkan konfigurasi parameter penjadwalan dalam skenario penjadwalan periodik. Anda dapat mendefinisikan variabel dalam kode tugas dalam format ${Variable} dan memberikan nilai kepada variabel di bagian Scheduling Parameter tab Properties. Untuk informasi tentang cara mengonfigurasi parameter penjadwalan dan format yang didukung dari parameter penjadwalan, lihat Konfigurasi penjadwalan.

Berikut adalah contoh penggunaan parameter penjadwalan dalam node SSH:

# Persyaratan: Tulis waktu eksekusi node SSH ke file sshnode.log yang disimpan di direktori /tmp setiap hari.
# Implementasi: Gunakan variabel ${myDate} dalam file sshnode.log dan tetapkan $[yyyy-mm-dd hh24:mi:ss] ke variabel myDate sebagai nilai.
echo ${myDate} >/tmp/sshnode.log
cat /tmp/sshnode.log

Setelah Anda mengembangkan tugas berdasarkan node SSH, konfigurasikan properti penjadwalan untuk node tersebut agar sistem dapat menjadwalkan tugas secara periodik. Untuk informasi lebih lanjut, lihat Konfigurasi penjadwalan.

Langkah 2: Terapkan node SSH dan lakukan operasi O&M

Setelah kode node dan properti penjadwalan dikonfigurasi, terapkan node ke lingkungan produksi. Untuk informasi lebih lanjut, lihat Terapkan node.
Setelah penerapan selesai, buka halaman Auto Triggered Nodes di Operation Center untuk melihat node yang diterapkan dan melakukan operasi O&M pada node tersebut. Sistem secara berkala menjalankan node berdasarkan properti penjadwalan yang Anda konfigurasikan. Untuk informasi lebih lanjut, lihat Memulai dengan Pusat Operasi.