Custom Environment Variables

Environment variables adalah semacam placeholder tempat menyimpan nilai parameter atau string yang sering digunakan, supaya Kamu tidak perlu menuliskannya secara manual berulang kali di dalam kode. Platform ini sudah menyediakan sejumlah default environment variables yang telah dikonfigurasi sebelumnya dan bisa langsung Kamu gunakan di dalam kode aplikasi, atau Kamu sesuaikan saat sebelum pembuatan node, agar lebih fleksibel dan nyaman saat bekerja di platform ini.

Dalam panduan ini, akan dijelaskan cara paling umum untuk menambahkan custom environment variable ke node manapun di platform, yaitu :

1. Melalui bagian khusus untuk variables di dashboard
2. Menggunakan file konfigurasi shell
3. Melalui file variables.conf (khusus Java)

Customize Variables Via UI #

1. Arahkan kursor ke grup node di dashboard, lalu perluas daftar Additionally dan pilih opsi Variables.

2. Di jendela yang terbuka, Kamu bisa menyesuaikan daftar environment variable sesuai kebutuhan Kamu (dengan menggunakan tombol-tombol yang ada di bagian alat).

 

 

Jangan lupa untuk menekan tombol Apply untuk menerapkan perubahan

Set Up Environment Variables via Shell Configs #

Kamu bisa menetapkan variabel kustom melalui file konfigurasi shell berikut:

• ~/.bash_profile dijalankan hanya saat login melalui konsol
• ~/.bashrc dijalankan setiap kali instance bash baru dimulai

Agar lebih mudah dikelola, platform secara otomatis menyertakan sumber dari konfigurasi .bashrc ke dalam .bash_profile. Dengan begitu, kamu cukup menetapkan variabel kustom melalui file .bashrc saja.

1. Lakukan koneksi SSH ke dalam kontainermu. Sebagai contoh, kita akan menggunakan Web SSH client bawaan dari platform.

2. Buat atau sesuaikan file .bashrc di dalam direktori home (~) dengan menambahkan variabel kustom menggunakan format berikut :

export {var_name}= {var_value}

Penjelasan :

• {var_name} adalah nama variabel yang ingin kamu tentukan, misalnya APP_ENV.
• {var_value} adalah nilai dari variabel tersebut, misalnya production.

3. Sekarang, setiap instansi bash baru akan otomatis menggunakan variabel kustom kamu. Untuk langsung menerapkan perubahan di sesi terminal saat ini, jalankan perintah berikut:

source ~/.bashrc 
echo $ {var_name}

Seperti yang bisa Kamu lihat, perubahan telah berhasil diterapkan.

Adjust Java Environment Variables via Configuration Manager #

Berikut adalah alur kerja sederhana yang berlaku sama untuk semua server aplikasi Java yang dikelola oleh platform:

1. Klik tombol Config pada server aplikasi kamu untuk membuka file manager kontainer.

2. Di tab yang terbuka, navigasikan ke file variables.conf yang terletak di salah satu jalur berikut:

 

• Tomcat, TomEE: /opt/tomcat/conf/variables.conf
• Jetty: /opt/jetty/etc/variables.conf
• Spring Boot: /opt/shared/conf/variables.conf
• GlassFish: /opt/glassfish/glassfish/domains/domain1/config/variables.conf
• Payara: /opt/payara/glassfish/domains/domain1/config/variables.conf
• WildFly: /opt/wildfly/conf/variables.conf

3. Di dalam file ini, kamu bisa menambahkan variabel custom milikmu (setiap variabel dipisahkan dengan spasi atau ditulis di baris baru) atau menyesuaikan opsi Java untuk aplikasimu. Sebagai contoh : 

-Dvar1=value1 -Dvar2=value2
-Dmy.var3=/my/value

 

Jangan lupa untuk menyimpan konfigurasi yang telah Kamu buat ya.

4. Restart node dari application server-mu untuk menerapkan perubahan.

5. Variabel baru ini bisa dipanggil melalui kode Java kamu dengan menggunakan metode System.getProperty(“nama_variabel”) untuk menetapkan nilai yang telah ditentukan ke argumen yang dibutuhkan. Contohnya:

• String var1 = System.getProperty(“var1”);
• String var2 = System.getProperty(“var2”);
• String var3 = System.getProperty(“my.var3”);

Sekarang, kamu bisa menyesuaikan kode aplikasimu menggunakan variabel-variabel baru ini.