SchedulerX:Koneksi agent (tugas skrip atau HTTP)

Kasus penggunaan

Kasus penggunaan umum untuk menghubungkan ke SchedulerX dengan agent meliputi:

• Menjalankan skrip Shell untuk membersihkan log secara berkala di semua mesin atau menjalankan layanan.

• Menjalankan skrip Python untuk membersihkan data historis dalam database secara berkala.

• Menggunakan API HTTP untuk memindai pesanan secara berkala.

Persyaratan lingkungan

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

Deploy agent secara manual

1. Unduh dan ekstrak paket agent.

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

   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	Description
   Agent 1.13.5	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.13.5.tar.gz	New features: tugas second_delay mendukung graceful shutdown. Tugas skrip mendukung penerusan data hulu/hilir dalam workflow. Mendukung pengumpulan metrik performa sistem melalui 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 bawah cgroup v2. Mendukung penyesuaian ukuran kolam thread eksekusi tugas. Kunci parameternya adalah share.pool.size.
   Agent 1.12.5	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.12.5.tar	New features: Mendukung mendapatkan variabel sistem tugas menggunakan placeholder. Mendukung ukuran kolam thread kustom untuk tugas HTTP. Tugas skrip dapat 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	Fixed issues: 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 deploy multiple agent pada satu mesin. Tugas agent HTTP mendukung tanggapan lebih besar dari 1.000 byte. Mengoptimalkan 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 graceful shutdown. Layanan log mendukung isolasi berdasarkan 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 agent. Mendukung pengembalian entri log terakhir sebagai hasil 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	Fixed issues: Memperbaiki masalah kinerja lambat pada pekerjaan tingkat kedua. Memperbaiki masalah di mana layanan log dapat menyebabkan error kehabisan memori (OOM).
   Agent 1.4.2	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.4.2.tar.gz	New feature: Mendukung layanan log.

   Penting

   Jika koneksi timeout saat Anda menggunakan perintah wget untuk mengunduh agent, aktifkan Alamat IP publik untuk mesin Anda atau lihat Unggah atau unduh file pada instans Linux.

2. Buka direktori schedulerxAgent/conf, lalu konfigurasikan file agent.properties.

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

   • Endpoint menentukan titik akhir. Untuk informasi selengkapnya, lihat daftar Endpoint.

   • namespace adalah ID namespace. Anda dapat memperoleh ID tersebut pada halaman Namespace .

   • application ID dan application key adalah pengenal unik dan akun aplikasi. Anda dapat memperolehnya pada halaman Application Management.

3. Buka direktori schedulerxAgent/bin dan jalankan skrip start.sh untuk menjalankan agent.

   Catatan

   Jika ingin mengatur memori startup untuk agent, Anda dapat menjalankan start-200m.sh, start-500m.sh, atau start-1g.sh.

   Untuk mengelola agent, gunakan perintah berikut:

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

   • Anda dapat melihat log di ${user.home}/logs/schedulerx/worker.log.

     Anda dapat menemukan direktori user.home dengan menjalankan perintah ps aux | grep java. Jika proses dijalankan oleh pengguna admin, jalur log-nya adalah /home/admin/logs/schedulerx/worker.log. Jika proses dijalankan oleh pengguna root, jalur log-nya adalah /root/logs/schedulerx/worker.log.

   Jika pesan yang dikembalikan berisi Schedulerx Worker started, deployment berhasil.

   Catatan

   Lingkungan runtime memerlukan JDK 1.8 hingga 14. Jika Anda menggunakan versi JDK lebih tinggi dari 14, hapus -XX:+UseConcMarkSweepGC dari file schedulerxAgent/bin/start.sh di direktori instalasi Agent.

   

Deploy agent menggunakan image Docker

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

   Network	x86_64	arm64
   (Public network) Tiongkok (Hangzhou)	schedulerx-registry.cn-hangzhou.cr.aliyuncs.com/schedulerx2/agent:latest-amd64	schedulerx-registry.cn-hangzhou.cr.aliyuncs.com/schedulerx2/agent:latest-arm64
   (Public network) Singapura	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 agent.

   Variabel lingkungan:

   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 adalah Endpoint.

   • SCHEDULERX_NAMESPACE adalah ID namespace, yang dapat Anda peroleh dari halaman Namespace atau di Konsol.

   • SCHEDULERX_GROUPID adalah application ID, dan SCHEDULERX_APPKEY adalah application key. Anda dapat memperolehnya pada halaman Application Management di Konsol.

   Setelah Anda memulai tugas deployment, Anda dapat menggunakan perintah docker logs untuk melihat log.

Deploy agent menggunakan deployment Kubernetes

Jika Anda sudah memiliki lingkungan k8s, opsi paling praktis adalah langsung deploy 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