Microservices Engine:Hubungkan ke SchedulerX menggunakan agen (skrip atau tugas HTTP)

Prasyarat

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

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

Skenario

Skenario umum penggunaan agen untuk menghubungkan ke SchedulerX meliputi:

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

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

• Menggunakan antarmuka HTTP untuk secara berkala memindai pesanan.

Persyaratan lingkungan

Lingkungan runtime harus menggunakan Java Runtime Environment (JRE) 1.8 atau versi yang lebih baru.

Deploy agen secara manual

1. Unduh dan ekstrak agen.

   Jika mesin Anda memiliki Alamat IP publik, jalankan 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

   
   

   Versi	URL Unduhan	Panduan versi
   Agent 1.13.5	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.13.5.tar.gz	Fitur baru Tugas second_delay kini mendukung graceful shutdown Tugas skrip kini mendukung transfer data hulu dan hilir dalam alur kerja Mendukung cgroup v2 untuk mengumpulkan metrik performa sistem
   https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.13.2.tar.gz	Fitur baru Mendukung pengumpulan metrik CPU di bawah CGroup V2. Mendukung ukuran kolam thread kustom untuk kolam thread eksekusi tugas. Kunci parameter adalah share.pool.size.
   Agent 1.12.5	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.12.5.tar	Fitur baru: Mendukung pengambilan variabel sistem tugas menggunakan placeholder. Untuk informasi selengkapnya, lihat Dapatkan variabel sistem tugas menggunakan placeholder. Mendukung ukuran kolam thread kustom untuk tugas HTTP. Memungkinkan tugas 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 masalah: Memperbaiki kerentanan keamanan pada Netty dan Logback. Memperbaiki masalah "too old resource version" untuk tugas Kubernetes (K8s).
   Agent 1.10.13	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.10.13.tar	Fitur baru: Mendukung deploy multiple agen pada satu mesin. Mendukung tugas agen HTTP dengan respons lebih besar dari 1000 byte. Mengoptimalkan log untuk mengurangi penyimpanan log historis.
   Agent 1.10.5	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.10.5.tar	Fitur baru: Mendukung shutdown yang mulus. Layanan Log Sederhana mendukung pemagaran kelompok aplikasi.
   Agent 1.9.8	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.9.8.tar	Fitur baru: Mendukung tugas HTTP dalam mode agen. Mendukung pengembalian baris terakhir log jika tugas skrip gagal. Mendukung tugas K8s.
   Agent 1.7.10	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.7.10.tar.gz	Perbaikan masalah: Memperbaiki masalah tugas tingkat kedua yang berjalan lambat. Memperbaiki masalah di mana Layanan Log Sederhana dapat menyebabkan error kehabisan memori (OOM).
   Agent 1.4.2	https://schedulerx2.oss-cn-hangzhou.aliyuncs.com/agent/schedulerxAgent-1.4.2.tar.gz	Fitur baru: Mendukung Layanan Log Sederhana.

   Penting

   Jika koneksi timeout saat menggunakan perintah wget untuk mengunduh agen, aktifkan akses jaringan publik untuk mesin Anda atau lihat Unggah atau unduh file (Linux).

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

   Konfigurasi mencakup 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. Untuk informasi selengkapnya, lihat Titik akhir.

   • namespace: ID namespace. Anda dapat memperoleh ID ini di halaman Namespace atau .

   • groupId dan appKey: ID unik dan kunci untuk aplikasi. Anda dapat memperolehnya di halaman Application Management.

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

   Catatan

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

   Setelah agen dimulai, Anda dapat melakukan operasi berikut sesuai kebutuhan:

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

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

     Anda dapat menemukan path user.home dengan menjalankan 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.

   Tanggapan yang berisi Schedulerx Worker started menunjukkan bahwa agen berhasil dimulai.

   Catatan

   Lingkungan runtime harus menggunakan Java Development Kit (JDK) 1.8 hingga 14. Jika Anda menggunakan versi JDK yang lebih baru dari 14, hapus parameter -XX:+UseConcMarkSweepGC dari file schedulerxAgent/bin/start.sh di direktori instalasi agen.

   

Deploy agen menggunakan image Docker

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

   Catatan

   Alamat registri image berikut digunakan untuk akses jaringan publik.

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

   Deskripsi 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.

   • SCHEDULERX_NAMESPACE: ID namespace. Anda dapat memperoleh ID ini dari halaman Namespace atau di Konsol.

   • SCHEDULERX_GROUPID: ID aplikasi.

   • SCHEDULERX_APPKEY: Kunci aplikasi. Anda dapat memperoleh ID dan kunci aplikasi dari halaman Application Management atau halaman di Konsol.

   Setelah deployment dimulai, Anda dapat melihat log dengan menjalankan perintah docker logs.

Deploy Penyebaran menggunakan image K8s

Jika Anda memiliki lingkungan Kubernetes, Anda dapat langsung menerapkan agen 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