SchedulerX:Hubungkan melalui agen (tugas skrip atau HTTP)

Kasus penggunaan

Berikut adalah kasus penggunaan umum saat menghubungkan agen ke SchedulerX:

• Gunakan skrip shell untuk membersihkan log secara berkala di semua node pekerja atau memulai layanan.

• Gunakan skrip Python untuk membersihkan data historis dari database secara berkala.

• Gunakan API HTTP untuk memindai pesanan secara berkala.

Persyaratan lingkungan

Diperlukan Java Runtime Environment (JRE) versi 1.8 atau lebih baru.

Terapkan agen secara manual

1. Unduh dan ekstrak agen.

   Jika node pekerja Anda memiliki Alamat IP publik, Anda dapat menjalankan perintah berikut untuk mengunduh agen:

   Catatan

   Ganti X.X.X dengan nomor versi yang diperlukan, misalnya, 1.12.5.

   wget https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-X.X.X.tar

   Version	Download url	Release notes
   Agent 1.14.0	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.14.0.tar.gz	New features: Tugas skrip kini mendukung terminasi paksa. clientInfo.log mencetak seluruh output skrip, yang dapat Anda kumpulkan melalui SLS.
   Agent 1.13.5	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.13.5.tar.gz	New features: Mendukung shutdown yang mulus untuk tugas dengan delay detik. Mendukung transfer data antara tugas hulu dan hilir dalam alur kerja untuk tugas skrip. Mendukung pengumpulan metrik performa sistem di cgroup v2.
   Agent 1.13.2	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.13.2.tar.gz	New features: Mendukung pengumpulan metrik CPU di cgroup v2. Mendukung penyesuaian ukuran kolam thread untuk eksekusi tugas. Parameter: share.pool.size.
   Agent 1.12.5	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.12.5.tar	New features: Mendukung penggunaan placeholder untuk memperoleh variabel sistem untuk tugas. Mendukung penyesuaian ukuran kolam thread untuk tugas HTTP. Memungkinkan tugas skrip mengembalikan baris terakhir dari output standar sebagai hasil.
   Agent 1.11.5	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.11.5.tar	Bug fixes: Memperbaiki kerentanan keamanan pada Netty dan Logback. Memperbaiki masalah "too old resource version" untuk tugas Kubernetes.
   Agent 1.10.13	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.10.13.tar	New features: Mendukung penerapan beberapa agen pada satu node pekerja. Mendukung tanggapan lebih besar dari 1.000 byte untuk tugas agen HTTP. Mengoptimalkan fitur logging untuk mengurangi penyimpanan log historis.
   Agent 1.10.5	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.10.5.tar	New features: Mendukung shutdown yang mulus. Fitur logging mendukung isolasi kelompok aplikasi.
   Agent 1.9.8	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.9.8.tar	New features: Mendukung tugas HTTP dalam mode agen. Mendukung pengembalian baris log terakhir jika tugas skrip gagal. Mendukung tugas Kubernetes.
   Agent 1.7.10	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.7.10.tar.gz	Bug fixes: Memperbaiki masalah di mana tugas dengan delay detik berjalan lambat. Memperbaiki masalah di mana fitur logging dapat menyebabkan error Out of Memory (OOM).
   Agent 1.4.2	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.4.2.tar.gz	New feature: Mendukung fitur logging.

   Penting

   Jika perintah wget timeout saat mengunduh agen, aktifkan Alamat IP publik untuk node pekerja Anda atau lihat Unggah atau unduh file (Linux).

2. Buka direktori schedulerxAgent/conf dan konfigurasikan file agent.properties.

   endpoint=addr-hz-internal.edas.aliyun.com
   namespace=fd2965c4-****-****-af52-bb62aa4*****
   groupId=hxm.test
   appKey=1234*****

   • endpoint: Titik akhir layanan. Untuk informasi selengkapnya, lihat Daftar titik akhir.

   • namespace: ID namespace. Anda dapat menemukannya di halaman Namespace atau .

   • groupId dan appKey adalah ID unik dan kunci aplikasi Anda. Anda dapat menemukannya di halaman Application Management.

3. Buka direktori schedulerxAgent/bin dan jalankan perintah start.sh.

   Catatan

   Untuk menentukan alokasi memori untuk agen saat startup, Anda dapat menjalankan start-200m.sh, start-500m.sh, atau start-1g.sh.

   Setelah agen dimulai, Anda dapat melakukan operasi berikut:

   • Untuk menghentikan agen, buka direktori schedulerxAgent/bin dan jalankan stop.sh.

   • Untuk melihat log, periksa file di ${user.home}/logs/schedulerx/worker.log.

     Variabel ${user.home} adalah direktori home pengguna yang menjalankan agen. Anda dapat mengidentifikasi pengguna tersebut dengan menjalankan perintah ps aux | grep java. Misalnya, jika proses dijalankan oleh pengguna admin, jalur log-nya adalah /home/admin/logs/schedulerx/worker.log. Jika dijalankan oleh pengguna root, jalurnya adalah /root/logs/schedulerx/worker.log.

   Pesan Schedulerx Worker started dalam output menunjukkan penerapan berhasil.

   Catatan

   Jika Anda menggunakan Java Development Kit (JDK) versi 14 atau lebih baru, Anda harus menghapus opsi -XX:+UseConcMarkSweepGC dari file schedulerxAgent/bin/start.sh di direktori instalasi agen.

   
   JAVA_OPTS="-Dproject.name=schedulerxAgent -XX:+UseConcMarkSweepGC -XX:+HeapDumpOxxx -XX:HeapDumpPath=${WORKER_LOG_DIR} -XX:+xxx lysis"
   if [ -n "${SCHEDULERX_STARTER_MODE}" ]; then
       JAVA_OPTS="${JAVA_OPTS} -Dschedulerx.stater.mode=${SCHEDULERX_STARTER_MODE}"

Terapkan dengan image Docker

1. Pilih image berdasarkan lingkungan jaringan dan arsitektur CPU Anda.

   Network	x86_64	arm64
   China (Hangzhou) (Public network)	schedulerx-registry.cn-hangzhou.cr.aliyuncs.com/schedulerx2/agent:latest-amd64	schedulerx-registry.cn-hangzhou.cr.aliyuncs.com/schedulerx2/agent:latest-arm64
   Singapore (Public network)	schedulerx-registry.ap-southeast-1.cr.aliyuncs.com/schedulerx2/agent:latest-amd64	schedulerx-registry.ap-southeast-1.cr.aliyuncs.com/schedulerx2/agent:latest-arm64

2. Terapkan agen.

   Deskripsi parameter:

   docker run  --env SCHEDULERX_ENDPOINT="addr-hz-internal.edas.aliyun.com" \
      --env SCHEDULERX_NAMESPACE="fd2965c4-****-****-af52-bb62aa4*****" \
      --env SCHEDULERX_GROUPID="hxm.test" \
      --env SCHEDULERX_APPKEY="1234*****" \
      -d {image id}

   • SCHEDULERX_ENDPOINT: Titik akhir.

   • SCHEDULERX_NAMESPACE: ID namespace. Anda dapat menemukannya di halaman Namespace atau di Konsol.

   • SCHEDULERX_GROUPID adalah groupId dan SCHEDULERX_APPKEY adalah kunci aplikasi. Anda dapat memperolehnya dari halaman Application Management di Konsol.

   Setelah penerapan dimulai, Anda dapat menjalankan perintah docker logs untuk melihat log.

Terapkan dengan Penyebaran Kubernetes

Jika Anda menggunakan Kubernetes, cara termudah untuk menerapkan agen adalah dengan menerapkan file schedulerx-agent.yaml.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: schedulerx-agent
  labels:
    app: schedulerx-agent
spec:
  replicas: 1
  selector:
    matchLabels:
      app: schedulerx-agent
  template:
    metadata:
      labels:
        app: schedulerx-agent
    spec:
      containers:
      - name: schedulerx-agent
        image: schedulerx-registry.cn-hangzhou.cr.aliyuncs.com/schedulerx2/agent:latest-amd64
        imagePullPolicy: Always
        resources:
          requests:
            cpu: 500m
        env:
          - name: "SCHEDULERX_ENDPOINT"
            value: "${SCHEDULERX_ENDPOINT}"
          - name: "SCHEDULERX_NAMESPACE"
            value: "${SCHEDULERX_NAMESPACE}"
          - name: "SCHEDULERX_GROUPID"
            value: "${SCHEDULERX_GROUPID}"
          - name: "SCHEDULERX_APPKEY"
            value: "${SCHEDULERX_APPKEY}"
          - name: "SCHEDULERX_STARTER_MODE"
            value: "pod"
        livenessProbe: 
          exec: 
            command: ["/bin/bash","/root/health.sh"]
          timeoutSeconds: 30
          initialDelaySeconds: 30