Function Compute:Ekstensi ARMS untuk runtime kustom

Langkah 1: Tambahkan layer agen ARMS

1. Masuk ke Konsol Function Compute. Di panel navigasi kiri, klik Services & Functions.

2. Di bilah navigasi atas, pilih Wilayah tempat fungsi Anda diterapkan.

3. Pada halaman Services, klik layanan yang berisi fungsi Anda.

4. Pada halaman Functions, temukan fungsi Anda dan klik Configure di kolom Actions.

5. Pada bagian Layers, klik Add Official Common Layer dan tambahkan layer yang sesuai dengan versi Java Anda. Gunakan nilai Nama Sumber Daya Alibaba Cloud (ARN) berikut untuk mengidentifikasi layer agen ARMS yang tersedia. Ganti {region} dengan ID Wilayah aktual Anda (misalnya, cn-hangzhou).

   # Untuk runtime kustom Java 8 atau Java 11
   acs:fc:{region}:official:layers/ArmsAgent273x/versions/2
   
   # Untuk runtime kustom Java 17
   acs:fc:{region}:official:layers/ArmsAgent273x_JDK17/versions/1

Langkah 2: Atur variabel lingkungan

Pada bagian Environment Variables di halaman konfigurasi fungsi, tambahkan dua variabel lingkungan berikut:

Langkah 3: Buat file bootstrap

Agen ARMS memerlukan tiga parameter startup JVM. Gunakan skrip bootstrap untuk meneruskan parameter ini saat fungsi dimulai.

Di WebIDE pada halaman kode fungsi, buat file bernama bootstrap dengan konten berikut:

#!/bin/bash
set -eo pipefail

# 1. Atur nama aplikasi ARMS.
#    Default: FC:{ServiceName}.{FunctionName}
appName="FC:Custom_Java_Arms_Demo"
if [ -n "${FC_SERVICE_NAME}" ] || [ -n "${FC_FUNCTION_NAME}" ]; then
    appName="FC:${FC_SERVICE_NAME}.${FC_FUNCTION_NAME}"
fi

echo "appName: ${appName}"
params=" "

# 2. Tambahkan parameter JVM ARMS.
if [[ -n "${FC_EXTENSIONS_ARMS_LICENSE_KEY}" ]]; then
    echo "FC_EXTENSIONS_ARMS_LICENSE_KEY: ${FC_EXTENSIONS_ARMS_LICENSE_KEY}"
    params+="-Dfc.instanceId=$HOSTNAME@`hostname -i` "
    # Path ke JAR agen ARMS yang disediakan oleh layer umum
    params+="-javaagent:/opt/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar "
    params+="-Darms.licenseKey=${FC_EXTENSIONS_ARMS_LICENSE_KEY} "
    params+="-Darms.appName=${appName} "
else
    echo "Variabel lingkungan FC_EXTENSIONS_ARMS_LICENSE_KEY tidak ada, harap atur variabel lingkungan FC_EXTENSIONS_ARMS_LICENSE_KEY!"
    exit 1
fi

# 3. Jalankan aplikasi.
echo "params: ${params}"
exec java $params \
    -Dserver.port=9000 \
    -jar /code/target/demo-0.0.1-SNAPSHOT.jar

Tiga parameter ARMS yang ditambahkan dalam skrip tersebut adalah:

• -javaagent: path ke file JAR agen ARMS. Saat menggunakan layer umum, path ini adalah /opt/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar.

• -Darms.licenseKey: kunci lisensi ARMS, dibaca dari variabel lingkungan FC_EXTENSIONS_ARMS_LICENSE_KEY.

• -Darms.appName: nama aplikasi ARMS. Nilai default-nya adalah FC:{ServiceName}.{FunctionName}.

Setelah membuat file tersebut, berikan izin eksekusi dengan menjalankan perintah berikut di terminal WebIDE:

chmod +x bootstrap

Kemudian klik Deploy.