Enterprise Distributed Application Service:Menyebarkan aplikasi ke EDAS dari Jenkins

Instal plugin edas-jenkins-plugin

1. Unduh file edas-jenkins-plugin.hpi.

2. Di Jenkins, buka Manage Jenkins > Manage Plugins.

3. Pada halaman Plugin Manager, pilih tab Advanced.

4. Pada bagian Upload Plugin, klik Select file, pilih file .hpi yang telah diunduh, lalu klik Upload.

5. Tunggu hingga proses instalasi selesai pada halaman Installing Plugins/Upgrades.

Konfigurasi kredensial EDAS

Setelah menginstal plug-in, tambahkan kredensial Alibaba Cloud Anda agar Jenkins dapat melakukan autentikasi dengan EDAS.

1. Di Jenkins, buka Manage Jenkins > Configure System.

2. Gulir ke bagian Deploy to EDAS dan konfigurasikan informasi akun. Klik Add, lalu klik Advanced untuk memasukkan informasi wilayah.

   Parameter	Deskripsi
   EDAS credentials name	Nama deskriptif untuk set kredensial ini, misalnya prod-edas atau staging-edas.
   EDAS Access Key ID	ID AccessKey dari Akun Alibaba Cloud Anda. Untuk informasi lebih lanjut, lihat Buat Pasangan Kunci Akses.
   EDAS Access Key Secret	Rahasia AccessKey dari Akun Alibaba Cloud Anda.
   EDAS Region	ID wilayah tempat aplikasi Anda disebarkan, seperti cn-hangzhou.
   Endpoint	(Hanya untuk Apsara Stack) Titik akhir EDAS. Hubungi dukungan teknis EDAS untuk nilai ini. Biarkan kosong jika menggunakan Alibaba Cloud.

3. Klik Add untuk menyimpan konfigurasi kredensial. Untuk menambahkan konfigurasi wilayah atau akun lainnya, klik Add lagi.

4. Klik Ping EDAS untuk memverifikasi konektivitas. Pesan success menandakan bahwa kredensial tersebut valid.

   

Menyebarkan dengan freestyle project

Gunakan freestyle project untuk penyebaran berbasis GUI tanpa skrip.

1. Pada halaman utama Jenkins, klik New Item.

2. Masukkan nama proyek, pilih Freestyle project, lalu klik OK.

3. Pada bagian Post-build Actions, klik Add post-build actions dan pilih Deploy to EDAS.

4. Pada bagian Deploy to EDAS, klik Add dan pilih mode penyebaran:

   Mode penyebaran	Kasus penggunaan
   EDAS ECS Application	Perbarui aplikasi yang sudah ada di kluster ECS. Lihat parameter penyebaran ECS.
   Create EDAS ECS Application	Buat dan sebarkan aplikasi baru di kluster ECS. Lihat parameter pembuatan ECS.
   EDAS K8s Application	Perbarui aplikasi yang sudah ada di kluster Container Service for Kubernetes. Lihat parameter penyebaran K8s.
   Create EDAS K8s Application	Buat dan sebarkan aplikasi baru di kluster Container Service for Kubernetes. Lihat parameter pembuatan K8s.

   

5. Klik Save atau Apply.

6. Pada panel navigasi sisi kiri, klik Build Now untuk memicu penyebaran.

   

Verifikasi hasil build

Setelah build selesai, entri baru muncul di bagian Build History. Klik nomor build untuk melihat status penyebaran dan log.

Menerapkan dengan skrip pipeline

Gunakan Pipeline Jenkins untuk mendefinisikan penyebaran sebagai kode. Plug-in ini mendukung Snippet Generator bawaan yang menghasilkan langkah penyebaran untuk Anda.

Menyebarkan dengan Job DSL

Gunakan Job DSL untuk mendefinisikan tugas penyebaran sebagai templat kode. Pendekatan ini berguna ketika Anda mengelola banyak tugas penyebaran serupa dan ingin menghasilkannya secara terprogram.

1. Pada halaman utama Jenkins, klik New Item.

2. Masukkan nama proyek, pilih Freestyle project, lalu klik OK.

3. Pada bagian Build, klik Add build step dan pilih Process Job DSLs.

   

4. Pilih Use the provided DSL script dan masukkan skrip Job DSL ke dalam bidang DSL Script. Contoh berikut membuat tugas penyebaran:

      job('edas') {                              // Nama tugas yang akan dibuat
          publishers {                           // Jenis plug-in EDAS
              edasClient {                       // Klien yang memanggil plug-in EDAS
                  deployApplication(
                      '',                        // namespace
                      '',                        // credentialsString
                      '',                        // group
                      '',                        // appId
                      ''                         // targetObject
                  )
              }
          }
      }

5. Klik Save atau Apply.

6. Di panel navigasi sisi kiri, klik Build Now untuk menghasilkan tugas penyebaran.

Setelah build selesai, tugas yang dihasilkan muncul di halaman utama Jenkins. Jalankan tugas yang dihasilkan tersebut untuk menyebarkan aplikasi Anda.

// Bentuk ringkas
void deployApplication(
    String namespace,          // ID namespace EDAS
    String credentialsString,  // Nama kredensial
    String group,              // Grup penyebaran
    String appId,              // ID aplikasi EDAS
    String targetObject        // Path ke artefak penyebaran (WAR/JAR)
)

// Bentuk lengkap
void deployApplication(
    String namespace,
    String credentialsString,
    String group,
    String appId,
    String targetObject,
    String versionLabelFormat,          // Pola label versi
    String versionDescriptionFormat,    // Pola deskripsi versi
    String batch,                       // Jumlah batch penyebaran
    String batchWaitTime,               // Waktu tunggu antar batch (detik)
    String releaseType                  // Jenis rilis
)

// Bentuk ringkas
void insertApplication(
    String namespace,
    String credentialsString,
    String applicationName,    // Nama aplikasi
    String packageType,        // WAR atau JAR
    String clusterId,          // ID kluster ECS tujuan
    String targetObject,
    String ecuInfo             // ID instans ECS
)

// Bentuk lengkap
void insertApplication(
    String namespace,
    String credentialsString,
    String applicationName,
    String packageType,
    String clusterId,
    String targetObject,
    String ecuInfo,
    String versionLabelFormat,
    String versionDescriptionFormat,
    String buildPackId,        // ID build pack untuk waktu proses
    String healthCheckUrl      // URL pemeriksaan kesehatan
)

// Bentuk ringkas
void deployK8sApplication(
    String namespace,
    String credentialsString,
    String appId,
    String targetObject,
    Boolean image              // true: sebarkan gambar kontainer; false: sebarkan WAR/JAR
)

// Bentuk lengkap
void deployK8sApplication(
    String namespace,
    String credentialsString,
    String appId,
    String targetObject,
    Boolean image,
    String edasContainerVersion,  // Versi kontainer EDAS
    String webContainer,          // Jenis kontainer web (misalnya, Apache Tomcat)
    String jdk,                   // Versi JDK
    String versionLabelFormat,
    String envs,                  // Variabel lingkungan (JSON)
    String startupCommand,
    String args,                  // Argumen startup
    String cpuLimit,              // Batas CPU (core)
    String memoryLimit,           // Batas memori (MiB)
    String cpuRequest,            // Permintaan CPU (core)
    String memoryRequest,         // Permintaan memori (MiB)
    String replicas,              // Jumlah replika pod
    String postStart,             // Perintah panggilan balik pasca-start
    String preStop,               // Perintah panggilan balik pra-stop
    String readiness,             // Konfigurasi probe kesiapan
    String liveness,              // Konfigurasi probe kelangsungan hidup
    String updateStrategy         // Strategi pembaruan (JSON)
)

// Bentuk ringkas
void insertK8sApplication(
    String namespace,
    String credentialsString,
    String applicationName,
    String packageType,
    String clusterId,
    String targetObject,
    String k8sNamespace,       // Namespace Kubernetes
    String jdk
)

// Bentuk lengkap
void insertK8sApplication(
    String namespace,
    String credentialsString,
    String applicationName,
    String packageType,
    String clusterId,
    String targetObject,
    String k8sNamespace,
    String jdk,
    String descFormat,                // Format deskripsi
    String edasContainerVersion,
    String webContainer,
    String versionLabelFormat,
    String envs,
    String startupCommand,
    String args,
    String cpuLimit,
    String memoryLimit,
    String cpuRequest,
    String memoryRequest,
    String replicas,
    String postStart,
    String preStop,
    String readiness,
    String liveness
)

Langkah selanjutnya

• Konfigurasi parameter penyebaran — deskripsi parameter lengkap untuk keempat mode penyebaran