Variabel lingkungan memisahkan konfigurasi dari kode aplikasi sehingga Anda dapat menyesuaikan perilaku waktu proses di berbagai lingkungan tanpa perlu menerapkan ulang aplikasi. Variabel ini juga menjaga data sensitif—seperti kredensial database dan Kunci API—agar tidak masuk ke dalam kode sumber.
Informasi latar belakang
EDAS mendukung tiga jenis variabel lingkungan untuk aplikasi yang diterapkan pada kluster Kubernetes:
|
Type |
Description |
Use case |
|
Custom |
Pasangan kunci-nilai yang Anda definisikan secara langsung |
Pengaturan khusus aplikasi seperti |
|
ConfigMap |
Referensi ke entri ConfigMap Kubernetes |
Konfigurasi bersama yang tidak sensitif di beberapa aplikasi |
|
Secret |
Referensi ke entri Secret Kubernetes |
Password, Sertifikat, Kunci API |
ConfigMap dan Secret harus berada di Wilayah, kluster, dan namespace Kubernetes yang sama dengan aplikasi yang mereferensikannya.
Untuk membuat ConfigMap, lihat Buat item konfigurasi. Untuk membuat Secret, lihat Buat Secret.
Prasyarat
Sebelum memulai, pastikan Anda telah memiliki:
-
Akun EDAS dengan akses ke Konsol EDAS
-
Kluster Kubernetes yang dibuat di EDAS
-
(Opsional) ConfigMap atau Secret di Wilayah, kluster, dan namespace Kubernetes yang sama dengan aplikasi Anda
Tambahkan variabel lingkungan
Anda dapat mengonfigurasi variabel lingkungan saat membuat aplikasi atau saat menerapkan aplikasi yang sudah ada. Dalam kedua kasus tersebut, variabel akan diteruskan ke kontainer saat startup.
Menyimpan perubahan variabel lingkungan akan merestart aplikasi. Konfigurasikan variabel lingkungan selama jam sepi untuk meminimalkan dampak.
Tambahkan variabel saat pembuatan aplikasi
-
Masuk ke Konsol EDAS.
-
Di bilah navigasi atas, pilih Wilayah. Di bagian atas halaman, pilih namespace.
-
Di pojok kiri atas, klik Create Application.
-
Pada langkah Basic Information, atur Cluster Type menjadi Kubernetes Clusters dan pilih Application Runtime Environment Anda (lihat Opsi runtime aplikasi), lalu klik Next.
-
Pada langkah Configurations, konfigurasikan informasi lingkungan, informasi dasar, metode penyebaran, dan parameter sumber daya, lalu klik Next.
-
Pada langkah Advanced Settings, klik Environment Variables dan tambahkan variabel menggunakan salah satu metode yang dijelaskan di Metode konfigurasi variabel.
-
Klik Create Application.
-
Di halaman Creation Completed, tinjau pengaturan di bagian Basic Information, Configurations, dan Advanced Settings, lalu klik Create Application.
-
Di halaman Application Overview, klik View Details. Di halaman Change List, pantau progres penyebaran. Setelah perubahan selesai, verifikasi bahwa status pod di bagian Basic Information menunjukkan pod sedang Berjalan.
Tambahkan variabel saat penyebaran aplikasi
Jika Anda belum mengonfigurasi variabel lingkungan saat pembuatan aplikasi, tambahkan saat menerapkan atau menerapkan ulang aplikasi.
-
Masuk ke Konsol EDAS.
-
Di bilah navigasi atas, pilih Wilayah. Di bagian atas halaman, pilih namespace.
-
Dari daftar drop-down Cluster Type, pilih Container Service or Serverless Kubernetes Cluster.
-
Temukan aplikasi target dan klik namanya.
-
Di halaman Overview atau Basic information, pilih Deploy > Deploy di pojok kanan atas.
-
Di halaman Select Deployment Mode, pilih mode penyebaran dan klik Start Deployment.
-
Atur lingkungan runtime dan paket penyebaran, lalu klik Environment Variables untuk menambahkan variabel menggunakan salah satu metode yang dijelaskan di Metode konfigurasi variabel.
-
Klik OK.
Metode konfigurasi variabel
Anda dapat menambahkan variabel satu per satu atau secara massal.
Tambahkan satu variabel
Pilih salah satu metode berikut berdasarkan jenis variabel Anda:
Custom variable
Masukkan nama dan nilai variabel secara langsung.

Untuk mengonfigurasi memori heap JVM, properti JVM, atau parameter Java agent, atur sebagai berikut:
-
Variable Name: CATALINA_OPTS
-
Variable Value: [Parameter to be added] $(EDAS_CATALINA_OPTS)
Variabel lingkungan umum untuk image MySQL:
|
Variable |
Required |
Description |
|
|
Yes |
Mengatur password root MySQL |
|
|
No |
Membuat akun pengguna tambahan dengan password |
|
|
No |
Menentukan database yang akan dibuat saat startup kontainer |
Untuk jenis image lainnya, konfigurasikan variabel lingkungan sesuai dokumentasi image tersebut.
ConfigMap reference
Pilih ConfigMap dari daftar drop-down Variable Value/Variable Reference, lalu pilih pasangan kunci-nilai dari ConfigMap tersebut.
Secret reference
Pilih Secret dari daftar drop-down Variable Value/Variable Reference, lalu pilih pasangan kunci-nilai dari Secret tersebut.
Tambahkan beberapa variabel secara massal
Untuk menyuntikkan variabel lingkungan secara massal dari ConfigMap atau Secret, konfigurasikan parameter berikut:
|
Parameter |
Description |
|
Type |
Pilih Configuration Items (ConfigMap) atau Secret. Variabel custom tidak didukung dalam mode massal. |
|
Configuration Mode |
env: Pilih pasangan kunci-nilai tertentu dari ConfigMap atau Secret. envFrom: Menyuntikkan semua pasangan kunci-nilai dari ConfigMap atau Secret. |
|
Configuration Items |
Pilih ConfigMap dari daftar drop-down. |
|
Reference Environment Variable |
Pilih pasangan kunci-nilai yang akan disuntikkan (tersedia hanya dalam mode env). |
Anda dapat menambahkan maksimal 100 variabel lingkungan sekaligus. Setelah menambahkan variabel, atur nama variabel sesuai kebutuhan Anda.
Verifikasi hasil
Konfirmasi bahwa variabel lingkungan aktif menggunakan salah satu metode berikut:
-
Change records: Di panel navigasi kiri halaman detail aplikasi, klik Change Records. Jika kolom Change Status menampilkan Success, konfigurasi telah berlaku.
-
Pod status: Di halaman Application Overview, klik Running Pods (Click View) di samping Running Status. Di bagian Pod, periksa kolom Status. Titik hijau menunjukkan aplikasi sedang Berjalan dengan konfigurasi yang telah diperbarui.
Opsi runtime aplikasi
Pilih lingkungan runtime yang sesuai dengan jenis aplikasi Anda:
|
Runtime |
Description |
|
Java > Custom |
Lakukan penyebaran menggunakan custom image di kluster Kubernetes |
|
Java > Java |
Lakukan penyebaran aplikasi Dubbo atau Spring Boot menggunakan paket JAR. Dapat dikonfigurasi: Java Environment. |
|
Java > Tomcat |
Lakukan penyebaran aplikasi Dubbo atau Spring menggunakan paket WAR. Dapat dikonfigurasi: Java Environment, Container Version. |
|
Java > EDAS-Container (HSF) |
Lakukan penyebaran aplikasi HSF menggunakan paket WAR atau FatJar. Dapat dikonfigurasi: Java Environment, Pandora Version, Ali-Tomcat Version. |
|
PHP |
Lakukan penyebaran aplikasi PHP yang berjalan di Apache HTTP Server |
|
Node.js, C++, Go, dan Bahasa Lainnya |
Lakukan penyebaran menggunakan custom image di kluster Kubernetes |