Perbarui aplikasi pada kluster ECS menggunakan toolkit-maven-plugin - Enterprise Distributed Application Service

Saat perlu mendorong perubahan kode ke aplikasi Spring Cloud, Dubbo, atau High-Speed Service Framework (HSF) yang berjalan di kluster Elastic Compute Service (ECS), toolkit-maven-plugin memungkinkan Anda membangun dan menerapkan langsung dari proyek Maven tanpa beralih ke konsol Enterprise Distributed Application Service (EDAS).

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

Aplikasi Spring Cloud, Dubbo, atau HSF yang telah diterapkan ke kluster ECS di EDAS
ID aplikasi dan ID wilayah untuk aplikasi target (tersedia di konsol EDAS)
Pasangan AccessKey untuk Pengguna Resource Access Management (RAM) dengan izin Application Management

Panduan ini mencakup penerapan pada kluster ECS. Untuk memperbarui aplikasi di kluster Kubernetes, lihat Use Alibaba Cloud Toolkit to release an application to all instances in a Kubernetes cluster at a time.

Langkah 1: Tambahkan dependensi plug-in

Tambahkan dependensi toolkit-maven-plugin ke file pom.xml di direktori root proyek Anda:

<build>
    <plugins>
        <plugin>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>toolkit-maven-plugin</artifactId>
            <version>1.1.5</version>
        </plugin>
    </plugins>
</build>

Gunakan versi 1.1.5. Versi yang lebih baru mungkin belum didukung sepenuhnya.

toolkit-maven-plugin adalah alat open source yang dapat digunakan untuk membangun kerangka kerja siklus hidup aplikasi lengkap dan menyiapkan lingkungan penerapan proyek. Untuk detail selengkapnya, lihat toolkit-maven-plugin overview.

Langkah 2: Buat file konfigurasi penerapan

Buat file bernama .edas_config.yaml di direktori root proyek dan definisikan parameter penerapan Anda.

Resolusi file konfigurasi

Kondisi	Perilaku
`.edas_config.yaml` ada di direktori root proyek	Plug-in secara otomatis memuatnya sebagai konfigurasi default
`-Dedas_config=<config-file-name>` diberikan	Plug-in menggunakan file yang ditentukan alih-alih file default
File default dan `-Dedas_config` keduanya tersedia	File yang ditentukan memiliki prioritas lebih tinggi
Proyek merupakan submodule Maven	Letakkan file konfigurasi di direktori root submodule tersebut

Untuk detail pengaturan multi-modul, lihat Deploy multi-module projects.

Konfigurasi contoh

Perbarui semua kelompok instans

Untuk memperbarui setiap kelompok instans aplikasi, cukup tentukan ID wilayah dan ID aplikasi:

env:
    region_id: cn-beijing
app:
    app_id: eb20****-e6ee-4f6d-a36f-5f6a5455****

Perbarui kelompok instans tertentu dengan versi paket

Untuk menargetkan satu kelompok instans dan mengatur versi paket penerapan:

env:
    region_id: cn-beijing
app:
    app_id: eb20dc8a-e6ee-4f6d-a36f-5f6a5455****
    package_version: 1.2
    group_id: 06923bb9-8c5f-4508-94d8-517b692f****

Ganti nilai placeholder dengan ID wilayah, ID aplikasi, ID kelompok, dan versi paket aktual Anda.

Untuk daftar lengkap parameter penerapan, lihat Configure the parameters related to application deployment.

Langkah 3: Buat file AccessKey

Buat file YAML di mesin lokal Anda untuk menyimpan kredensial Anda:

access_key_id: <your-access-key-id>
access_key_secret: <your-access-key-secret>

Ganti placeholder dengan nilai aktual Anda:

Placeholder	Deskripsi	Lokasi pencarian
`<your-access-key-id>`	ID AccessKey dari Pengguna RAM	AccessKey Pair di konsol RAM
`<your-access-key-secret>`	Rahasia AccessKey dari Pengguna RAM yang sama	Halaman yang sama seperti di atas

Gunakan pasangan AccessKey dari Pengguna RAM dengan izin Application Management, bukan dari akun root Alibaba Cloud. Plug-in hanya menggunakan pasangan AccessKey untuk menghasilkan tanda tangan permintaan. Kredensial tidak dikirimkan untuk tujuan lain.

Langkah 4: Bangun dan terapkan

Dari direktori root proyek (atau direktori submodule untuk proyek Maven multi-modul), jalankan:

mvn clean package toolkit:deploy -Daccess_key_file=<path-to-access-key-file>

Parameter perintah

Parameter	Deskripsi
`toolkit:deploy`	Memicu penerapan melalui plug-in setelah proses packaging selesai
`-Daccess_key_file`	Path ke file AccessKey yang dibuat pada Langkah 3

Untuk cara lain mengonfigurasi kredensial, lihat Account configurations and priorities.

Terapkan paket yang telah dibangun tanpa membangun ulang

Untuk melewati langkah build dan menerapkan file JAR atau WAR yang sudah ada, gunakan parameter -Djar_path:

mvn toolkit:deploy -Daccess_key_file=<path-to-access-key-file> -Djar_path=target/demo.jar

Path dapat berupa absolut atau relatif terhadap direktori root proyek.

Penting

Parameter -Djar_path memiliki prioritas lebih tinggi daripada parameter env dalam file konfigurasi. Anda juga dapat mengatur path file AccessKey di bagian env file konfigurasi. Untuk detailnya, lihat Configure the parameters related to application deployment.

Verifikasi penerapan

Setelah perintah deploy selesai, periksa hasilnya:

Output terminal

Tinjau output Maven di terminal Anda:

BUILD SUCCESS dalam output menegaskan bahwa penerapan telah selesai.
Jika output berisi ERROR, tinjau pesan error, perbaiki masalahnya, lalu terapkan ulang.

Konsol EDAS

Masuk ke EDAS console dan periksa halaman change records serta application details untuk memastikan pembaruan telah diterapkan. Untuk detailnya, lihat Check the result.

Dukungan Apsara Stack

Plug-in toolkit-maven-plugin tersedia di Apsara Stack Enterprise V3.8.0 dan versi setelahnya. Sebelum menggunakan plug-in ini di Apsara Stack, konfigurasikan titik akhir EDAS. Untuk detail konfigurasi titik akhir, lihat Configure the parameters related to application deployment. Untuk mendapatkan titik akhir tersebut, hubungi dukungan teknis EDAS.