Saat menggunakan toolkit-maven-plugin untuk menerapkan dan memperbarui aplikasi, Anda perlu mengonfigurasi berbagai parameter sesuai skenario penggunaannya. Topik ini menjelaskan cara mengonfigurasi parameter yang digunakan saat menerapkan aplikasi dengan toolkit-maven-plugin.
Parameter-parameter tersebut dikelompokkan ke dalam tiga kategori berikut:
- Lingkungan dasar (env)
- Konfigurasi aplikasi (app)
- Konfigurasi penyimpanan (oss)
| Item Konfigurasi | Parameter | Wajib/Contoh | Deskripsi |
| env | region_id | Ya | ID wilayah tempat aplikasi akan diterapkan. |
| jar_path | target/demo.jar | Jalur paket yang digunakan untuk menerapkan aplikasi. Anda dapat menentukan jalur absolut atau relatif. Jika Anda menentukan jalur ini, Anda tidak perlu memaketkan file aplikasi di Maven. | |
| endpoint | Tidak | Titik kehadiran (POP) gerbang yang terhubung ke gerbang untuk aplikasi yang diterapkan di Apsara Stack. | |
| app | app_id | Ya | ID aplikasi. |
| release_type | 1 | Jenis rilis aplikasi. Nilai yang valid:
| |
| package_version | Tidak | Versi paket penyebaran. Secara default, nilainya adalah string yang terdiri dari versi file pom.xml Anda dan waktu pembuatan instans saat ini, misalnya 1.0 (2018-09-27 19:00:00). | |
| desc | Tidak | Deskripsi penerapan. | |
| group_id | Tidak | ID kelompok instansi aplikasi. Secara default, instans aplikasi termasuk dalam semua kelompok. | |
| batch | Tidak | Jumlah batch untuk rilis. Nilai default adalah 1 dan nilai maksimum adalah 5. | |
| batch_wait_time | Tidak | Interval antara dua batch rilis berturut-turut. Satuan: menit. Nilai default adalah 0. | |
| stage_timeout | Tidak | Periode waktu habis untuk setiap tahap proses perubahan. Satuan: menit. Secara default, periode waktu habis adalah 5 menit. Jika Anda menentukan nilai batch_wait_time, nilai batch_wait_time yang ditentukan secara otomatis ditambahkan ke nilai parameter stage_timeout. Saat aplikasi sedang berjalan, plugin akan keluar secara otomatis jika suatu tahap menunggu lebih lama daripada nilai ambang batas ini. | |
| oss | region_id | Tidak | ID wilayah tempat bucket diterapkan. Nilai default adalah ID wilayah tempat aplikasi akan diterapkan. |
| bucket | Tidak | Nama bucket tempat Anda ingin mengunggah data Anda. Secara default, bucket Object Storage Service (OSS) gratis yang disediakan oleh Enterprise Distributed Application Service (EDAS) digunakan. Jika Anda menggunakan OSS untuk penyimpanan, Anda harus menentukan parameter bucket. Jika tidak, bucket OSS gratis yang dialokasikan secara otomatis oleh EDAS akan digunakan. | |
| key | Tidak | Jalur kustom yang digunakan untuk mengunggah paket aplikasi ke OSS. Secara default, bucket OSS gratis yang disediakan oleh EDAS digunakan. Jika Anda menggunakan bucket OSS tertentu, Anda dapat menggunakan parameter ini untuk menentukan jalur penyimpanan paket aplikasi. Anda juga dapat menggunakan variabel berikut untuk menentukan jalur secara terparameterisasi: {region_id}, {app_id}, dan {version}. Misalnya, Anda dapat mengatur jalur menjadi pkgs/petstore/{version}/store.war. Secara default, nilainya mengikuti format {region_id}/{app_id}/{version}. | |
| access_key_id | Tidak | ID AccessKey yang digunakan untuk mengunggah paket aplikasi ke OSS. | |
| access_key_secret | Tidak | Rahasia AccessKey yang digunakan untuk mengunggah paket aplikasi ke OSS. | |
| use_vpc_endpoint | true | Secara default, plugin menggunakan titik akhir publik bucket OSS yang ditentukan untuk mengunggah paket Anda. Untuk menggunakan titik akhir internal bucket OSS yang ditentukan untuk mengunggah paket Anda, atur nilainya menjadi true. |