SchedulerX:Hubungkan menggunakan agent (untuk task skrip atau HTTP)

Skenario

Skenario umum penggunaan agent untuk terhubung ke SchedulerX meliputi hal-hal berikut:

• Menggunakan skrip Shell untuk membersihkan log secara berkala di semua mesin atau memulai layanan.

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

• Menggunakan API HTTP untuk memindai pesanan secara berkala.

Persyaratan

Lingkungan runtime memerlukan JRE 1.8 atau yang lebih baru.

Deploy agent secara manual

1. Unduh dan ekstrak agent.

   Jika mesin Anda memiliki Alamat IP publik, jalankan perintah berikut untuk mengunduh agent:

   Catatan

   X.X.X adalah placeholder untuk nomor versi. Ganti dengan nomor versi yang Anda butuhkan, 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.13.2	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.13.2.tar.gz	New features Supports CPU metric collection under CGroup V2. Supports custom thread pool size for task execution (Parameter key: share.pool.size).
   Agent 1.12.5	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.12.5.tar	New features: Supports obtaining task system variables using placeholders. Supports custom thread pool size for HTTP tasks. Allows script tasks to return the last line of standard output as the execution result.
   Agent 1.11.5	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.11.5.tar	Bug fixes: Fixed security vulnerabilities in Netty and Logback. Fixed the "too old resource version" issue for Kubernetes tasks.
   Agent 1.10.13	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.10.13.tar	New features: Supports deploying multiple agents on a single machine. Supports responses larger than 1000 bytes for HTTP agent tasks. Optimized logging to reduce historical log storage.
   Agent 1.10.5	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.10.5.tar	New features: Supports graceful shutdown. Simple Log Service supports isolation by application group.
   Agent 1.9.8	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.9.8.tar	New features: Supports HTTP tasks in agent mode. Supports returning the last line of the log if a script task fails. Supports Kubernetes tasks.
   Agent 1.7.10	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.7.10.tar.gz	Bug fixes: Fixed an issue where second-level tasks run slowly. Fixed an issue where Simple Log Service could cause an out-of-memory (OOM) error.
   Agent 1.4.2	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.4.2.tar.gz	New feature: Supports Simple Log Service.

   Penting

   Jika koneksi timeout saat Anda menggunakan perintah wget untuk mengunduh agent, aktifkan Alamat IP publik, atau lihat Upload or download files (Linux).

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

   Konfigurasikan parameter berikut:

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

   • Endpoint adalah alamat endpoint. Untuk informasi selengkapnya, lihat Endpoint list.

   • namespace adalah ID namespace. Anda dapat memperolehnya dari halaman Namespace .

   • groupId adalah ID aplikasi, dan appKey adalah kunci aplikasi. Anda dapat memperolehnya dari halaman Application Management.

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

   Catatan

   Untuk mengatur memori startup agent, jalankan start-200m.sh, start-500m.sh, atau start-1g.sh.

   Saat startup, Anda dapat melakukan operasi berikut:

   • Untuk menghentikan agent: Buka direktori schedulerxAgent/bin dan jalankan stop.sh.

   • Untuk melihat log, path log-nya adalah ${user.home}/logs/schedulerx/worker.log.

     Untuk mengetahui path user.home, jalankan perintah ps aux | grep java. Misalnya, jika proses dijalankan oleh pengguna admin, path log-nya adalah /home/admin/logs/schedulerx/worker.log. Jika proses dijalankan oleh pengguna root, path log-nya adalah /root/logs/schedulerx/worker.log.

   Jika pesan respons berisi Schedulerx Worker started, agent berhasil dideploy.

   Catatan

   Lingkungan runtime memerlukan JDK 1.8 hingga 14. Jika Anda menggunakan versi JDK yang lebih baru dari 14, hapus opsi -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) China (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.

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

   • SCHEDULERX_NAMESPACE adalah ID namespace. Anda dapat memperolehnya dari halaman Namespace di Konsol.

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

   Setelah memulai task deployment, lihat log dengan menjalankan perintah docker logs.

Deploy Deployment menggunakan image K8s

Jika Anda memiliki lingkungan Kubernetes, cara termudah untuk mendeploy agent adalah dengan menggunakan 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