Konfigurasi variabel lingkungan - Enterprise Distributed Application Service

Anda perlu mengonfigurasi variabel lingkungan untuk menjalankan aplikasi di sistem. Sebagai contoh, perintah aplikasi Java hanya dapat dijalankan setelah variabel lingkungan JAVA_HOME dan PATH dikonfigurasi. Topik ini menjelaskan cara mengonfigurasi variabel lingkungan untuk aplikasi di Konsol Enterprise Distributed Application Service (EDAS).

Informasi latar belakang

Konsol EDAS memungkinkan Anda mengonfigurasi tiga jenis variabel lingkungan berikut:

Variabel Lingkungan Kustom: Variabel yang disesuaikan saat membuat aplikasi.
ConfigMaps: Konfigurasi yang telah ditentukan sebelumnya dan tidak perlu dirahasiakan. Jika ingin menerapkan ConfigMap ke aplikasi, pastikan aplikasi tersebut berada di wilayah, kluster, dan namespace Kubernetes yang sama dengan ConfigMap. Jika tidak, aplikasi tidak dapat menggunakan ConfigMap.
Untuk informasi lebih lanjut tentang cara membuat ConfigMap, lihat Buat Item Konfigurasi.
Rahasia: Konfigurasi yang telah ditentukan sebelumnya, seperti kata sandi dan sertifikat, yang perlu dirahasiakan. Jika ingin menerapkan rahasia ke aplikasi, pastikan aplikasi tersebut berada di wilayah, kluster, dan namespace Kubernetes yang sama dengan rahasia tersebut. Jika tidak, aplikasi tidak dapat menggunakan rahasia tersebut.
Untuk informasi lebih lanjut tentang cara membuat rahasia, lihat Buat Rahasia.

Konfigurasi variabel lingkungan saat Anda membuat aplikasi

Masuk ke .
Masuk ke Konsol EDAS. Di panel navigasi kiri, pilih Application Management > Applications. Halaman Applications akan muncul. Di bilah navigasi atas, pilih wilayah. Di bagian atas halaman, pilih namespace. Di sudut kiri atas, klik Create Application.

Di langkah Basic Information, tentukan Jenis Kluster dan Lingkungan Runtime aplikasi, lalu klik Next. Tabel berikut menjelaskan parameter-parameter tersebut.

Parameter

Deskripsi

Cluster Type

Jenis kluster tempat Anda ingin menyebarkan aplikasi. Pilih Kubernetes Clusters.

Application Runtime Environment

Lingkungan runtime aplikasi. Pilih lingkungan runtime aplikasi berdasarkan jenis aplikasi yang di-hosting.

Java
- Custom: Pilih opsi ini jika Anda ingin menggunakan gambar kustom untuk menyebarkan aplikasi di kluster Kubernetes.
- Java: Pilih opsi ini jika Anda ingin menggunakan paket JAR universal untuk menyebarkan aplikasi sebagai aplikasi Dubbo atau Spring Boot. Anda dapat mengatur parameter Lingkungan Java setelah memilih opsi ini.
- Tomcat: Pilih opsi ini jika Anda ingin menggunakan paket WAR universal untuk menyebarkan aplikasi sebagai aplikasi Dubbo atau Spring. Anda dapat mengatur parameter Lingkungan Java dan Versi Kontainer setelah memilih opsi ini.
- EDAS-Container (HSF): Pilih opsi ini jika Anda ingin menggunakan paket WAR atau FatJar untuk menyebarkan aplikasi sebagai aplikasi High-speed Service Framework (HSF). Anda dapat mengatur parameter Lingkungan Java, Versi Pandora, dan Versi Ali-Tomcat setelah memilih opsi ini.
PHP: Pilih opsi ini jika aplikasi adalah aplikasi PHP yang berjalan di Apache HTTP Server.
Node.js, C++, Go, and Other Languages: Pilih opsi ini jika Anda ingin menggunakan gambar kustom untuk menyebarkan aplikasi di kluster Kubernetes. Proses konfigurasi untuk aplikasi multi-bahasa tidak dijelaskan dalam topik ini.

Di langkah Configurations, konfigurasikan informasi lingkungan, informasi dasar, dan metode penyebaran aplikasi, atur parameter sumber daya terkait, lalu klik Next.

Di langkah Advanced Settings, klik Environment Variables dan konfigurasikan variabel lingkungan sesuai kebutuhan.

Saat membuat aplikasi, lewatkan variabel lingkungan yang telah dikonfigurasi ke kontainer yang dibuat. Dengan cara ini, Anda tidak perlu menambahkan variabel lingkungan yang sering digunakan secara berulang. EDAS memungkinkan Anda menyesuaikan variabel lingkungan dan mengonfigurasi variabel lingkungan menggunakan ConfigMaps dan rahasia. EDAS juga memungkinkan Anda menambahkan satu atau beberapa variabel lingkungan sekaligus. Pilih metode sesuai kebutuhan.

Tambahkan variabel lingkungan satu per satu.
- Sesuaikan variabel lingkungan.
  Catatan
  - Jika ingin menentukan parameter untuk memori heap mesin virtual Java (JVM), properti JVM, dan agen Java, tambahkan parameter pada langkah ini:
    Nama Variabel: CATALINA_OPTS
    Nilai Variabel: [Parameter yang akan ditambahkan] $(EDAS_CATALINA_OPTS)
  - Jika menggunakan gambar MySQL, Anda dapat mengonfigurasi variabel lingkungan berikut:
    MYSQL_ROOT_PASSWORD: Wajib. Memungkinkan Anda mengatur kata sandi root MySQL.
    MYSQL_USER dan MYSQL_PASSWORD: Opsional. Memungkinkan Anda membuat akun selain akun root dan mengatur kata sandi.
    MYSQL_DATABASE: Opsional. Memungkinkan Anda menentukan database yang ingin dibuat saat kontainer dibuat.
  - Jika menggunakan jenis gambar lain, konfigurasikan variabel lingkungan sesuai kebutuhan.
- Gunakan ConfigMap untuk mengonfigurasi variabel lingkungan.
  Pilih ConfigMap dari daftar drop-down Variable Value/Variable Reference. ConfigMap mungkin berisi beberapa pasangan kunci-nilai. Pilih pasangan kunci-nilai sesuai kebutuhan.
- Gunakan rahasia untuk mengonfigurasi variabel lingkungan.
  Pilih rahasia dari daftar drop-down Variable Value/Variable Reference. Rahasia mungkin berisi beberapa pasangan kunci-nilai. Pilih pasangan kunci-nilai sesuai kebutuhan.

Tambahkan beberapa variabel lingkungan

Parameter	Deskripsi
Type	Tipe variabel lingkungan. Pilih Configuration Items atau Secret sesuai kebutuhan. Custom tidak didukung. Dalam contoh ini, pilih Item Konfigurasi.
Configuration Mode	Mode di mana variabel lingkungan dikonfigurasi. Nilai valid: env dan envFrom. env: Setelah Anda memilih ConfigMap, Anda juga harus memilih pasangan kunci-nilai dalam ConfigMap. envFrom: Setelah Anda memilih ConfigMap, Anda tidak dapat memilih pasangan kunci-nilai dalam ConfigMap. Secara default, semua pasangan kunci-nilai dipilih. Catatan Anda dapat menambahkan maksimal 100 variabel lingkungan sekaligus.
Configuration Items	Pilih ConfigMap dari daftar drop-down.
Reference Environment Variable	Pilih pasangan kunci-nilai yang ingin Anda konfigurasikan dalam mode env.

Catatan

Setelah menambahkan variabel lingkungan, atur nama variabel lingkungan sesuai kebutuhan Anda.

Klik Create Application.
Di halaman Creation Completed, periksa informasi di bagian Basic Information, Configurations, dan Advanced Settings. Lalu, klik Create Application.
Di bagian atas halaman Application Overview, klik View Details. Di halaman Change List, lihat proses perubahan aplikasi. Tunggu beberapa menit hingga aplikasi disebarkan. Setelah proses perubahan aplikasi selesai, lihat status instance di bagian Basic Information halaman Application Overview. Jika status menunjukkan bahwa pod sedang berjalan, aplikasi telah disebarkan.

Konfigurasi variabel lingkungan saat Anda memperbarui aplikasi

Jika Anda belum mengonfigurasi variabel lingkungan saat membuat aplikasi, Anda dapat melakukannya saat menyebarkan aplikasi.

Masuk ke .
Di panel navigasi kiri, klik Application Management > Applications. Di bilah navigasi atas, pilih wilayah. Di bagian atas halaman, pilih namespace. Pilih Container Service or Serverless Kubernetes Cluster dari daftar drop-down Cluster Type. Kemudian, temukan aplikasi yang ingin diperbarui dan klik nama aplikasi.
Di halaman Overview atau Basic information, pilih Deploy > Deploy di sudut kanan atas.
Di halaman Select Deployment Mode, pilih mode penyebaran dan klik Start Deployment di sudut kanan atas bagian mode penyebaran tertentu.

Atur lingkungan runtime dan paket penyebaran untuk aplikasi, klik Environment Variables, lengkapi konfigurasi sesuai kebutuhan, lalu klik OK.

Tambahkan variabel lingkungan satu per satu.
- Sesuaikan variabel lingkungan.
  Catatan
  - Jika ingin menentukan parameter untuk memori heap mesin virtual Java (JVM), properti JVM, dan agen Java, tambahkan parameter pada langkah ini:
    Nama Variabel: CATALINA_OPTS
    Nilai Variabel: [Parameter yang akan ditambahkan] $(EDAS_CATALINA_OPTS)
  - Jika menggunakan gambar MySQL, Anda dapat mengonfigurasi variabel lingkungan berikut:
    MYSQL_ROOT_PASSWORD: Wajib. Memungkinkan Anda mengatur kata sandi root MySQL.
    MYSQL_USER dan MYSQL_PASSWORD: Opsional. Memungkinkan Anda membuat akun selain akun root dan mengatur kata sandi.
    MYSQL_DATABASE: Opsional. Memungkinkan Anda menentukan database yang ingin dibuat saat kontainer dibuat.
  - Jika menggunakan jenis gambar lain, konfigurasikan variabel lingkungan sesuai kebutuhan.
- Gunakan ConfigMap untuk mengonfigurasi variabel lingkungan.
  Pilih ConfigMap dari daftar drop-down Variable Value/Variable Reference. ConfigMap mungkin berisi beberapa pasangan kunci-nilai. Pilih pasangan kunci-nilai sesuai kebutuhan.
- Gunakan rahasia untuk mengonfigurasi variabel lingkungan.
  Pilih rahasia dari daftar drop-down Variable Value/Variable Reference. Rahasia mungkin berisi beberapa pasangan kunci-nilai. Pilih pasangan kunci-nilai sesuai kebutuhan.

Tambahkan beberapa variabel lingkungan

Parameter	Deskripsi
Type	Tipe variabel lingkungan. Pilih Configuration Items atau Secret sesuai kebutuhan. Custom tidak didukung. Dalam contoh ini, pilih Item Konfigurasi.
Configuration Mode	Mode di mana variabel lingkungan dikonfigurasi. Nilai valid: env dan envFrom. env: Setelah Anda memilih ConfigMap, Anda juga harus memilih pasangan kunci-nilai dalam ConfigMap. envFrom: Setelah Anda memilih ConfigMap, Anda tidak dapat memilih pasangan kunci-nilai dalam ConfigMap. Secara default, semua pasangan kunci-nilai dipilih. Catatan Anda dapat menambahkan maksimal 100 variabel lingkungan sekaligus.
Configuration Items	Pilih ConfigMap dari daftar drop-down.
Reference Environment Variable	Pilih pasangan kunci-nilai yang ingin Anda konfigurasikan dalam mode env.

Catatan

Setelah menambahkan variabel lingkungan, atur nama variabel lingkungan sesuai kebutuhan Anda.

Penting

Aplikasi akan dimulai ulang setelah Anda klik OK. Kami menyarankan Anda mengonfigurasi variabel lingkungan selama jam-jam sepi.

Verifikasi hasil

Metode 1
Di panel navigasi kiri halaman detail aplikasi, klik Change Records untuk melihat detail perubahan aplikasi. Jika nilai di kolom Status Perubahan adalah Sukses, aplikasi telah disebarkan dan konfigurasi berlaku.
Metode 2
Di halaman Application Overview, klik Pod Berjalan (Klik Lihat) di sebelah Running Status. Di bagian Pod panel Konfigurasi Aplikasi, periksa kolom Status pod. Jika titik hijau muncul, aplikasi berada dalam status berjalan. Ini berarti aplikasi disebarkan sesuai harapan dan konfigurasi berlaku.