Enterprise Distributed Application Service：Gunakan plug-in toolkit-maven-plugin untuk memperbarui aplikasi yang diterapkan di kluster ECS

Prosedur

1. Tambahkan dependensi berikut untuk plug-in toolkit-maven-plugin ke file pom.xml di direktori lokal proyek.

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

   Catatan

   Disarankan untuk mengatur versi menjadi 1.1.5. Versi terbaru mungkin tidak didukung.

2. Buat file konfigurasi bernama .edas_config.yaml di direktori root proyek dan konfigurasikan parameter penerapan di dalam file tersebut.

   • File dengan awalan . merupakan file konfigurasi default dari lingkungan pengembangan terintegrasi (IDE). Jika tidak ada file konfigurasi lain yang ditentukan, plug-in akan menggunakan file .edas_config.yaml di direktori root proyek sebagai file konfigurasi.

   • Jika file konfigurasi tanpa awalan . dibuat, Anda dapat mengonfigurasi parameter -Dedas_config=xxx untuk menentukan file konfigurasi saat mengenkapsulasi proyek.

   • Jika file konfigurasi default ada dan Anda menentukan file konfigurasi lain menggunakan parameter sebelumnya, plug-in akan menggunakan file konfigurasi yang ditentukan.

   Catatan

   Jika proyek saat ini adalah submodul dari proyek Maven, file konfigurasi default harus disimpan di direktori root submodul. Untuk informasi tentang cara menerapkan proyek multi-modul, lihat Terapkan Proyek Multi-modul.

   Contoh konfigurasi untuk skenario pembaruan tipikal:

   • Perbarui semua grup instance dari sebuah aplikasi.

     Sebagai contoh, aplikasi dengan ID eb20****-e6ee-4f6d-a36f-5f6a5455**** di wilayah China (Beijing) memiliki beberapa grup instance, dan Anda ingin memperbarui semua grup instance dari aplikasi tersebut. Contoh kode berikut memberikan contoh konfigurasi:

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

     Ganti nilai parameter dalam kode sebelumnya dengan nilai aktual.

   • Perbarui grup instance tertentu dari sebuah aplikasi dan tentukan versi paket penerapan untuk aplikasi tersebut.

     Sebagai contoh, aplikasi dengan ID eb20dc8a-e6ee-4f6d-a36f-5f6a545**** di wilayah China (Beijing) memiliki beberapa grup instance, dan Anda ingin memperbarui grup instance dengan ID 06923bb9-8c5f-4508-94d8-517b692f**** serta menentukan 1.2 sebagai versi paket penerapan untuk aplikasi tersebut. Contoh kode berikut memberikan contoh konfigurasi:

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

   Anda mungkin perlu mengonfigurasi lebih banyak parameter dalam skenario kompleks. Untuk informasi lebih lanjut, lihat Konfigurasikan Parameter Terkait Penerapan Aplikasi.

3. Buat file akun dalam format YAML di mesin lokal Anda dan tentukan ID AccessKey dan Rahasia AccessKey di dalam file tersebut.

   Disarankan untuk menggunakan ID AccessKey dan Rahasia AccessKey dari pengguna Resource Access Management (RAM) yang telah diberikan izin Application Management. Dengan cara ini, Anda dapat mengelola izin pada aplikasi, meningkatkan keamanannya. Anda dapat melihat ID AccessKey dan Rahasia AccessKey dari pengguna RAM di halaman Pasangan AccessKey konsol RAM.

   Contoh file akun:

   access_key_id:yourAccessKeyId
   access_key_secret:yourAccessKeySecret

   Catatan

   Ganti nilai parameter yourAccessKeyId dan yourAccessKeySecret dengan ID AccessKey dan Rahasia AccessKey aktual Anda. ID AccessKey dan Rahasia AccessKey dalam file akun hanya digunakan untuk menghasilkan tanda tangan permintaan. Pasangan AccessKey tidak digunakan untuk tujuan lain, seperti transmisi data.

4. Di direktori lokal proyek atau direktori submodul proyek Maven, jalankan perintah berikut untuk mengenkapsulasi proyek dan menerapkan aplikasi di EDAS:

   mvn clean package toolkit:deploy -Daccess_key_file={account file path}                        

   Deskripsi parameter perintah:

   • toolkit:deploy: Menentukan apakah akan menerapkan aplikasi menggunakan plug-in toolkit-maven-plugin. Aplikasi diterapkan setelah proyek dienkapsulasi hanya jika Anda mengonfigurasi parameter ini.

   • access_key_file: Jalur file akun.

     Catatan

     Untuk informasi lebih lanjut tentang cara menentukan pasangan kunci, lihat Konfigurasi Akun dan Prioritas.

   • -Djar_path: Jalur file paket penerapan yang sudah ada. Anda dapat menggunakan paket penerapan yang sudah ada untuk menerapkan aplikasi tanpa perlu mengenkapsulasi proyek. Jalur paket penerapan bisa berupa jalur absolut atau relatif. Untuk menentukan jalur file paket penerapan yang sudah ada, jalankan perintah berikut:

     mvn toolkit:deploy -Daccess_key_file={account file path} -Djar_path=target/demo.jar                        

     Penting

     Anda juga dapat mengonfigurasi jalur file akun saat mengonfigurasi parameter env. Untuk informasi lebih lanjut, lihat Konfigurasikan Parameter Terkait Penerapan Aplikasi. Namun, parameter -Djar_path memiliki prioritas lebih tinggi daripada parameter env.

Periksa hasil

1. Jalankan perintah untuk mengenkapsulasi proyek dan menerapkan aplikasi, lalu periksa log keluaran di antarmuka Terminal IDE.

   • Jika log keluaran berisi BUILD SUCCESS, aplikasi berhasil diterapkan.

   • Jika log keluaran berisi ERROR, identifikasi penyebab kesalahan berdasarkan log. Perbaiki kesalahan dan terapkan ulang aplikasi.

2. Masuk ke EDAS, lihat change records dan application details, dan periksa apakah aplikasi diperbarui atau diterapkan. Untuk informasi lebih lanjut, lihat Periksa Hasil.

Dukungan Apsara Stack

Plug-in toolkit-maven-plugin dapat digunakan di Apsara Stack Enterprise V3.8.0 dan versi lebih baru. Sebelum menggunakan plug-in, konfigurasikan titik akhir EDAS di plug-in. Untuk informasi lebih lanjut, lihat Konfigurasikan Parameter Terkait Penerapan Aplikasi. Untuk mendapatkan titik akhir, hubungi dukungan teknis EDAS.