All Products
Search

This Product

    DataWorks:SSH node

    Document Center

    DataWorks:SSH node

    Last Updated:Sep 22, 2026

    Di DataWorks, Anda dapat menggunakan SSH node untuk mengakses host jarak jauh melalui sumber data SSH yang telah ditentukan dan memicu skrip agar dijalankan di host tersebut. Topik ini menjelaskan alur kerja pengembangan SSH node.

    Pendahuluan

    SSH node memungkinkan DataWorks mengakses host jarak jauh melalui sumber data SSH. Misalnya, Anda dapat mengakses Instance Elastic Compute Service (ECS) secara jarak jauh dari DataWorks dan menjalankan skrip secara berkala di dalamnya.

    Prasyarat

    • Pengguna RAM yang ingin Anda gunakan telah ditambahkan ke ruang kerja Anda.

      Jika Anda ingin menggunakan Pengguna RAM untuk mengembangkan task, Anda harus menambahkan Pengguna RAM tersebut ke ruang kerja sebagai anggota dan memberikan peran Develop atau Workspace Administrator kepada Pengguna RAM tersebut. Peran Workspace Administrator memiliki izin lebih banyak daripada yang diperlukan. Berhati-hatilah saat memberikan peran tersebut. Untuk informasi selengkapnya tentang cara menambahkan anggota dan memberikan peran, lihat Tambahkan anggota ke ruang kerja.

    • Kelompok resource arsitektur tanpa server telah dikaitkan dengan ruang kerja Anda. Untuk informasi selengkapnya, lihat topik dalam direktori Gunakan kelompok resource arsitektur tanpa server.

    • Anda telah membuat SSH node untuk pengembangan. Untuk informasi selengkapnya, lihat Buat node dalam alur kerja.

    • Anda telah membuat sumber data SSH.

      Anda harus terlebih dahulu membuat sumber data SSH untuk mengakses server SSH Anda secara jarak jauh. Setelah itu, Anda dapat mengembangkan dan menjadwalkan task SSH secara berkala dalam SSH node. Untuk informasi selengkapnya tentang cara membuat sumber data, lihat Sumber data SSH.

      Catatan

      SSH node hanya mendukung sumber data SSH yang dibuat dengan string koneksi JDBC. Untuk mencegah kegagalan task, pastikan sumber data tersebut dapat terhubung ke kelompok resource.

    Batasan

    Panjang kode maksimum untuk SSH node adalah 128KB.

    Peringatan

    • Jika task SSH node yang memulai proses pada host jarak jauh berhenti secara tidak terduga (misalnya, karena timeout) atau dihentikan secara manual, hanya proses di sisi client yang dihentikan. Proses pada host jarak jauh tidak dihentikan, dan DataWorks tidak mengirim perintah ke host jarak jauh untuk menghentikannya.

    • SSH node mendukung sintaksis shell standar tetapi tidak mendukung fitur interaktif.

    • Saat Anda menggunakan SSH node untuk menjalankan skrip pada Instance ECS, file temporary akan dibuat pada Instance ECS tersebut. Pastikan instans memiliki ruang disk yang cukup dan dapat membuat file yang diperlukan.

    • Jangan menjalankan beberapa task yang mengoperasikan file yang sama secara bersamaan, karena hal ini dapat menyebabkan kegagalan SSH node.

    Langkah 1: Kembangkan SSH node

    (Opsional) Pilih sumber data SSH

    Jika terdapat beberapa sumber data SSH di ruang kerja Anda, pilih sumber data yang sesuai pada halaman edit SSH node. Jika hanya ada satu, DataWorks akan menggunakannya secara default.

    Catatan

    SSH node hanya mendukung sumber data SSH yang dibuat dengan string koneksi JDBC. Untuk mencegah kegagalan task, pastikan sumber data tersebut dapat terhubung ke kelompok resource.

    Pengembangan kode: Contoh sederhana

    Tulis skrip yang ingin Anda jalankan di editor kode SSH node. Kode berikut memberikan contohnya.

    # 1. Siapkan lingkungan.
# Cari file yang ingin Anda eksekusi pada host jarak jauh. Misalnya, file bernama hello.sh ada di direktori /tmp host jarak jauh.
# Untuk memudahkan pengujian, Anda dapat menjalankan perintah berikut di SSH node untuk membuat file hello.sh.
echo "echo hello,dataworks" >/tmp/hello.sh
# 2. Jalankan skrip pada host jarak jauh.
# Gunakan SSH node DataWorks untuk menjalankan skrip /tmp/hello.sh.
sh /tmp/hello.sh

    Pengembangan kode: Menggunakan parameter penjadwalan

    Gunakan Scheduling Parameters DataWorks untuk meneruskan argumen secara dinamis ke kode Anda dalam skenario penjadwalan berkala. Anda dapat mendefinisikan variabel dalam kode task menggunakan format ${variable_name}. Pada halaman edit node, buka panel kanan Scheduling Settings > Scheduling Parameters untuk memberikan nilai pada variabel tersebut. Untuk informasi selengkapnya tentang format yang didukung dan detail konfigurasi parameter penjadwalan, lihat Konfigurasikan properti penjadwalan untuk node.

    Contoh berikut menunjukkan cara menggunakan parameter penjadwalan dalam SSH node:

    # Contoh ini menggunakan variabel ${myDate} untuk menulis waktu eksekusi node ke file log. Untuk melakukannya, berikan nilai $[yyyy-mm-dd hh24:mi:ss] ke variabel myDate di properti node.
echo ${myDate} >/tmp/sshnode.log
cat /tmp/sshnode.log

    Setelah Anda mengembangkan skrip untuk SSH node, Anda harus mengonfigurasi properti penjadwalannya agar task dijalankan secara berkala. Untuk informasi selengkapnya, lihat Konfigurasikan properti penjadwalan untuk node.

    Langkah 2: Deploy dan kelola node

    1. Setelah Anda mengonfigurasi properti penjadwalan, deploy SSH node ke lingkungan produksi. Untuk informasi selengkapnya, lihat Deploy node atau alur kerja.

    2. Setelah node di-deploy, node tersebut akan berjalan secara berkala sesuai konfigurasi penjadwalan Anda. Anda dapat membuka Operation and Maintenance Center > Node O&M > Auto Triggered Task O&M > Auto Triggered Task untuk melihat dan mengelola task berkala tersebut. Untuk informasi selengkapnya, lihat Pengenalan Operation Center.

    Dokumentasi terkait

    Untuk mempelajari cara menerapkan load balancing dan Ketersediaan tinggi untuk SSH node, lihat Terapkan load balancing dan Ketersediaan tinggi untuk SSH node.