Kelola dan gunakan ConfigMaps (K8s ConfigMaps) -

ConfigMap (Kubernetes ConfigMap) dapat digunakan sebagai variabel lingkungan untuk waktu proses aplikasi atau dimuatkan sebagai file konfigurasi ke sistem file kontainer aplikasi. Penggunaan ConfigMap memungkinkan Anda mengubah konfigurasi setelah penerapan aplikasi tanpa harus membuat ulang citra.

Topik ini tidak berlaku untuk skenario di mana Anda perlu mendapatkan informasi konfigurasi secara dinamis dari pusat konfigurasi. Untuk informasi lebih lanjut, lihat Gunakan Nacos dalam MSE atau Kelola Konfigurasi Terdistribusi (ACM).

Untuk menyimpan informasi sensitif seperti kunci dan sertifikat, lihat Mengelola dan Menggunakan K8s Secrets.

Buat ConfigMap

Di halaman SAE ConfigMaps, pilih wilayah tujuan dan namespace di bagian atas halaman, lalu klik Create. Pastikan Anda memilih namespace tempat aplikasi target berada.

Tentukan nama kustom untuk Configuration Item Name.

Configuration Mapping: Pilih mode edit dan konfigurasikan pemetaan nama variabel dan nilainya.

Edit With Form: Klik Add Variable dan masukkan nama variabel serta nilainya. Anda dapat menambahkan beberapa variabel. Untuk konten konfigurasi yang panjang, Anda dapat mengklik ikon di sebelah nilai variabel untuk menempel dan mengedit konten tersebut.

Edit In JSON Format: Di kotak kode, masukkan satu atau lebih pemetaan nama variabel dan nilainya. Nama variabel dan nilainya harus dilingkupi dengan "". Contohnya:

{
    "nv_shell": "/bin/sh",
    "nginx_conf": "daemon            off;\nworker_processes  2;\nuser              www-data;\n\nevents {\n    use           epoll;\n    worker_connections  128;\n}\n\nerror_log         logs/error.log info;\n\nhttp {\n    server_tokens off;\n    include       mime.types;\n    charset       utf-8;\n\n    access_log    logs/access.log  combined;\n\n    server {\n        server_name   localhost;\n        listen        127.0.0.1:80;\n\n        error_page    500 502 503 504  /50x.html;\n\n        location      / {\n            root      html;\n        }\n\n    }"
}

Use YAML Format: Di kotak kode, masukkan satu atau lebih pemetaan nama variabel dan nilainya. Berikut adalah contoh konfigurasi:

nv_shell: /bin/sh
nginx_conf: |-
  daemon            off;
  worker_processes  2;
  user              www-data;

  events {
      use           epoll;
      worker_connections  128;
  }

  error_log         logs/error.log info;

  http {
      server_tokens off;
      include       mime.types;
      charset       utf-8;

      access_log    logs/access.log  combined;

      server {
          server_name   localhost;
          listen        127.0.0.1:80;

          error_page    500 502 503 504  /50x.html;

          location      / {
              root      html;
          }

      }

Di daftar ConfigMap, Anda dapat melihat ConfigMaps yang telah dibuat dan melakukan operasi seperti Edit, Copy, View History, dan Delete.
Penting
- Setelah Anda membuat ConfigMap, Anda harus menggunakan ConfigMap sebagai variabel lingkungan untuk aplikasi atau memasang ConfigMap sebagai file konfigurasi ke sistem file aplikasi agar dapat berfungsi.
- Jika Anda memodifikasi ConfigMap, Anda harus menerapkan ulang aplikasi yang mereferensinya agar perubahan tersebut berlaku.
- Menghapus ConfigMap memengaruhi operasi aplikasi yang mereferensinya. Sebelum Anda menghapus ConfigMap, pastikan Anda telah menghapus referensinya dari aplikasi.

Gunakan ConfigMap sebagai variabel lingkungan untuk aplikasi

Buat aplikasi
Di halaman Daftar Aplikasi SAE, pilih wilayah tujuan dan namespace di bagian atas lalu klik Create Application. Di halaman Application Basic Information, konfigurasikan parameter dan klik Next: Advanced Settings.
Ubah aplikasi yang sedang berjalan
Peringatan
Setelah Anda menerapkan ulang aplikasi, aplikasi akan di-restart. Untuk mencegah kesalahan tak terduga seperti gangguan bisnis, kami sarankan Anda menerapkan aplikasi selama jam-jam sepi.
Di halaman Daftar Aplikasi SAE, pilih wilayah tujuan dan namespace di bagian atas lalu klik Application ID target.Di panel navigasi di sebelah kiri, klik Basic Information. Di pojok kanan atas, klik Deploy Application.
Ubah aplikasi yang dihentikan
Di halaman Daftar Aplikasi SAE, pilih wilayah tujuan dan namespace di bagian atas lalu klik Application ID target.Di panel navigasi di sebelah kiri, klik Basic Information lalu klik Modify Application Configuration.

Di bagian Environment Variable, atur Type menjadi Reference Configuration Item dan tentukan nama kustom untuk Variable Name untuk aplikasi saat ini. Jika Anda mereferensikan semua kunci, Anda tidak perlu menentukan nama variabel karena nama kunci digunakan sebagai nama variabel. Lalu, pilih Configuration Item Name dan Key yang ada. Kunci adalah variabel dalam item konfigurasi. Mereferensikan semua kunci juga didukung. Anda dapat menambahkan beberapa item konfigurasi.
Tunggu hingga aplikasi diterapkan. Untuk memverifikasi bahwa konfigurasi efektif, masuk ke webshell instans aplikasi dan jalankan perintah env | grep <nama variabel>. Ganti <nama variabel> dengan nama variabel yang Anda konfigurasikan. Jika perintah mengembalikan pemetaan nama variabel dan nilainya, konfigurasi tersebut efektif.

Pasang ConfigMap sebagai file konfigurasi ke sistem file aplikasi

Anda dapat memasang ConfigMap ke sistem file kontainer aplikasi. Nilai ConfigMap digunakan sebagai konten file. Anda dapat menyesuaikan jalur file dan nama. Jika file dengan nama yang sama ada di jalur tersebut, file yang dipasang akan menimpa file aslinya.

File yang dipasang sering digunakan sebagai file konfigurasi aplikasi. Ini memungkinkan Anda mengubah konfigurasi tanpa harus membuat ulang citra. Untuk memodifikasi file konfigurasi yang ada di kontainer aplikasi, pertama-tama salin konten file asli ke mesin lokal Anda. Setelah Anda memodifikasi kontennya, simpan sebagai nilai ConfigMap. Lalu, ikuti petunjuk dalam topik ini untuk memasang ConfigMap ke sistem file aplikasi.

Buat aplikasi
Di halaman Daftar Aplikasi SAE, pilih wilayah tujuan dan namespace di bagian atas lalu klik Create Application. Di halaman Application Basic Information, konfigurasikan parameter dan klik Next: Advanced Settings.
Ubah aplikasi yang sedang berjalan
Peringatan
Setelah Anda menerapkan ulang aplikasi, aplikasi akan di-restart. Untuk mencegah kesalahan tak terduga seperti gangguan bisnis, kami sarankan Anda menerapkan aplikasi selama jam-jam sepi.
Di halaman Daftar Aplikasi SAE, pilih wilayah tujuan dan namespace di bagian atas lalu klik Application ID target.Di panel navigasi di sebelah kiri, klik Basic Information. Di pojok kanan atas, klik Deploy Application.
Ubah aplikasi yang dihentikan
Di halaman Daftar Aplikasi SAE, pilih wilayah tujuan dan namespace di bagian atas lalu klik Application ID target.Di panel navigasi di sebelah kiri, klik Basic Information lalu klik Modify Application Configuration.

Di area Configuration Management, klik + Add. Pilih Configuration Item Name dan Key dari item konfigurasi yang ada. Kunci adalah nama variabel dalam item konfigurasi. Anda dapat memasang satu kunci atau semua kunci. Lalu, tentukan jalur pemasangan kustom Mount Path. Untuk memasang satu kunci, masukkan jalur mutlak yang mencakup nama file. Untuk memasang semua kunci, masukkan jalur mutlak yang tidak mencakup nama file. SAE secara otomatis menggunakan nama kunci dari setiap item konfigurasi sebagai nama file. Anda dapat menambahkan beberapa item konfigurasi.
Tunggu hingga aplikasi diterapkan. Untuk memverifikasi bahwa konfigurasi efektif, masuk ke webshell instans aplikasi dan lihat konten file di jalur pemasangan.

Contoh skenario

Konfigurasikan php-fpm.conf untuk aplikasi PHP

Buat ConfigMap.

Atur ConfigMap Name menjadi php-fpm.

Untuk Configuration Mapping, pilih Edit With YAML dan masukkan konfigurasi YAML berikut di kotak kode:

www_conf: |
  [www]
  user = www-data
  group = www-data
  listen = 127.0.0.1:9000
  pm = dynamic
  pm.max_children = 5
  pm.start_servers = 2
  pm.min_spare_servers = 1
  pm.max_spare_servers = 3

Pasang ConfigMap sebagai file konfigurasi ke sistem file aplikasi PHP yang Anda buat.
1. Atur Configuration Item Name menjadi php-fpm.
2. Atur Key menjadi www_conf.
3. Atur jalur pemasangan menjadi /usr/local/etc/php-fpm.d/www.conf.

Konfigurasikan nginx.conf untuk Nginx

Untuk informasi lebih lanjut, lihat Terapkan Layanan Nginx menggunakan SAE.