Microservices Engine:Hubungkan agen (untuk pekerjaan skrip atau HTTP)

Prasyarat

• (Opsional) Namespace telah dibuat. Untuk informasi selengkapnya, lihat Buat namespace.

• Resource telah dibuat. Untuk informasi selengkapnya, lihat Buat resource.

Kasus penggunaan

Kasus penggunaan utama untuk menghubungkan agen ke SchedulerX meliputi:

• Menggunakan skrip Shell untuk membersihkan log secara berkala di semua node pekerja atau menjalankan layanan.

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

• Menggunakan API HTTP untuk memindai pesanan secara berkala.

Persyaratan lingkungan

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

Deploy agen secara manual

1. Unduh dan ekstrak paket agen.

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

   Catatan

   Ganti X.X.X dengan nomor versi yang Anda butuhkan, misalnya, 1.12.5.

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

   Versi	URL Unduh	Deskripsi
   agent 1.13.5	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.13.5.tar.gz	Fitur baru Mengaktifkan shutdown yang mulus untuk pekerjaan tingkat detik. Mengaktifkan pengiriman data antara pekerjaan hulu dan hilir dalam alur kerja untuk pekerjaan skrip. Mengaktifkan pengumpulan metrik performa sistem dengan cgroup v2.
   agent 1.13.2	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.13.2.tar.gz	Fitur baru Mengaktifkan pengumpulan metrik CPU dengan CGroup v2. Mengaktifkan kustomisasi ukuran kolam thread eksekusi pekerjaan menggunakan kunci parameter share.pool.size.
   agent 1.12.5	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.12.5.tar	Fitur baru: Mengaktifkan pengambilan variabel sistem pekerjaan menggunakan placeholder. Mengaktifkan kustomisasi ukuran kolam thread untuk pekerjaan HTTP. Memungkinkan pekerjaan skrip mengembalikan baris terakhir dari output standar sebagai hasil eksekusi.
   agent 1.11.5	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.11.5.tar	Perbaikan bug: Memperbaiki kerentanan keamanan pada Netty dan Logback. Memperbaiki masalah "versi resource terlalu lama" untuk pekerjaan Kubernetes.
   agent 1.10.13	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.10.13.tar	Fitur baru: Mengaktifkan deploy multiple agen pada satu node pekerja. Mendukung respons lebih besar dari 1.000 byte untuk pekerjaan HTTP. Mengoptimalkan logging untuk mengurangi penyimpanan log historis.
   agent 1.10.5	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.10.5.tar	Fitur baru: Mengaktifkan shutdown yang mulus. Mengaktifkan isolasi kelompok aplikasi dalam layanan logging.
   agent 1.9.8	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.9.8.tar	Fitur baru: Mengaktifkan pekerjaan HTTP berbasis agen. Memungkinkan pekerjaan skrip mengembalikan baris terakhir log saat gagal. Mengaktifkan pekerjaan Kubernetes.
   agent 1.7.10	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.7.10.tar.gz	Perbaikan bug: Memperbaiki masalah pekerjaan tingkat kedua yang berjalan lambat. Memperbaiki masalah di mana layanan 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	Fitur baru: Memperkenalkan layanan logging.

   Penting

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

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

   Konfigurasikan parameter berikut:

   endpoint=addr-hz-internal.edas.aliyun.com
   # Untuk akses jaringan publik, gunakan domainName alih-alih endpoint.
   # domainName={domainName}
   namespace=fd2965c4-xxxx-xxxx-af52-bb62aa4f19f2
   groupId=hxm.test
   appKey=12******789

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

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

   • groupId dan appKey: ID aplikasi dan kunci aplikasi. Temukan keduanya di halaman Application Management.

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

   Catatan

   Untuk mengatur memori saat menjalankan Agent, Anda dapat menjalankan start-200m.sh, start-500m.sh, atau start-1g.sh.

   Saat startup, Anda dapat:

   • Hentikan agen: Buka direktori schedulerxAgent/bin dan jalankan stop.sh.

   • Lihat log: Jalur log adalah ${user.home}/logs/schedulerx/worker.log.

     Untuk mendapatkan nilai user.home, jalankan perintah ps aux | grep java. Jika Anda menjalankan proses sebagai pengguna admin, jalur log-nya adalah /home/admin/logs/schedulerx/worker.log. Jika Anda menjalankannya sebagai pengguna root, jalur log-nya adalah /root/logs/schedulerx/worker.log.

   Jika respons berisi Schedulerx Worker started, agen telah berhasil dijalankan.

   Catatan

   Agen memerlukan JDK 1.8 hingga 14. Jika Anda menggunakan versi yang 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:+xxxlysis"
   if [ -n "${SCHEDULERX_STARTER_MODE}" ]; then
       JAVA_OPTS="${JAVA_OPTS} -Dschedulerx.stater.mode=${SCHEDULERX_STARTER_MODE}"
   fi

Deploy menggunakan image Docker

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

   Catatan

   Alamat image berikut dapat diakses melalui internet publik.

   Jaringan	x86_64	arm64
   China (Hangzhou) (Jaringan Publik)	schedulerx-registry.cn-hangzhou.cr.aliyuncs.com/schedulerx2/agent:latest-amd64	schedulerx-registry.cn-hangzhou.cr.aliyuncs.com/schedulerx2/agent:latest-arm64
   Singapura (Jaringan Publik)	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. Deploy agen.

   Parameter:

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

   • SCHEDULERX_ENDPOINT: Titik akhir layanan.

   • SCHEDULERX_NAMESPACE menentukan ID namespace. Anda dapat memperoleh ID tersebut dari halaman Namespaces di konsol.

   • SCHEDULERX_GROUPID adalah ID aplikasi.

   • SCHEDULERX_APPKEY adalah kunci aplikasi. Anda dapat memperoleh kunci aplikasi di halaman Application Management di konsol.

   Setelah Anda menjalankan pekerjaan deploy, Anda dapat menggunakan perintah docker logs untuk melihat log.

Deploy sebagai Deployment Kubernetes

Jika Anda sudah memiliki lingkungan Kubernetes, Anda dapat menggunakan file schedulerx-agent.yaml untuk melakukan deploy secara langsung.

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