Manage and use K8s ConfigMaps - Serverless App Engine - Alibaba Cloud Dokümantasyon Merkezi

ConfigMap'ler, uygulama konteynerlerinde ortam değişkeni veya monte edilmiş yapılandırma dosyası olarak işlev görür. Bu sayede, görüntüyü yeniden oluşturmadan dağıtımdan sonra yapılandırmaları değiştirebilirsiniz.

SAE ortam değişkenleri yalnızca örnek çalışma zamanı aşamasında etkili olur. Oluşturma aşamasında ortam değişkeni eklenmesi desteklenmez. Uygulamanın bir dağıtım niteliği olan ortam değişkenleri, konteyner başlatıldığında çalışma zamanı ortamına enjekte edilir ve görüntü oluşturma sürecine dahil edilmez.

Yapılandırma verilerini bir yapılandırma merkezinden dinamik olarak almak için bkz. MSE'de Nacos kullanma veya Dağıtılmış yapılandırmaları yönetme (ACM).

Anahtarlar ve sertifikalar gibi hassas bilgileri depolamak için bkz. Secret'leri (K8s Secret) yönetme ve kullanma.

ConfigMap oluşturma

SAE ConfigMaps sayfasında, uygulamanız için bölgeyi ve ad alanını seçin, ardından Create öğesine tıklayın.

Özel bir ConfigMap Name belirtin.

Configure Mappings bölümünde, anahtar-değer çiftlerini tanımlamak için bir düzenleme modu seçin:

Edit using form: Add Variable öğesine tıklayın ve ardından bir anahtar ile değerini girin. Birden fazla anahtar-değer çifti ekleyebilirsiniz. Uzun yapılandırma içeriği için, değerin yanındaki simgesine tıklayarak değeri daha büyük bir düzenleyicide yapıştırıp düzenleyebilirsiniz.

Edit in JSON format: Kod düzenleyicisinde bir veya daha fazla anahtar-değer çifti girin. Anahtarlar ve dize değerleri çift tırnak ("") içine alınmalıdır. Örneğin:

{
    "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    }"
}

Edit in YAML format: Kod düzenleyicisinde bir veya daha fazla anahtar-değer çifti girin. Örneğin:

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;
          }

      }

Oluşturduğunuz ConfigMap'i Configuration Item (ConfigMap) listesinde bulun. Daha sonra bu öğeyi Edit, Copy, View Record veya Delete edebilirsiniz.
Önemli
- Bir ConfigMap, bunu ortam değişkeni olarak kullandıktan veya uygulamanızın dosya sistemine dosya olarak monte ettikten sonra etkili olur.
- Bir ConfigMap'i değiştirirseniz, değişikliklerin etkili olması için başvuruda bulunan uygulamayı yeniden dağıtmanız gerekir.
- Bir ConfigMap'i silmek, buna başvuran uygulamaların başarısız olmasına neden olabilir. Bir ConfigMap'i silmeden önce, uygulamalarınızdan buna yapılan tüm başvuruları kaldırın.

ConfigMap'i ortam değişkeni olarak kullanma

Uygulama oluşturma

SAE Application List sayfasında, üst gezinme çubuğundan hedef bölgeyi ve ad alanını seçin, ardından Create Application öğesine tıklayın. Application Basic Information sayfasında parametreleri yapılandırın ve Next: Advanced Settings öğesine tıklayın.

Çalışan bir uygulamayı değiştirme

Uyarı
Bir uygulamayı yeniden dağıttıktan sonra uygulama yeniden başlatılır. İş kesintisi gibi öngörülemeyen hataları önlemek için uygulamaları yoğun olmayan saatlerde dağıtmanızı öneririz.

SAE Application List sayfasında, üst gezinme çubuğundan hedef bölgeyi ve ad alanını seçin. Hedef Application kimliğine tıklayarak uygulama ayrıntıları sayfasını açın. Soldaki gezinme bölmesinde Basic Information öğesine tıklayın. Sağ üst köşede Deploy Application öğesine tıklayın.

Durdurulmuş bir uygulamayı değiştirme

SAE Application List sayfasında, üst gezinme çubuğundan hedef bölgeyi ve ad alanını seçin. Hedef Application kimliğine tıklayarak uygulama ayrıntıları sayfasını açın. Basic Information öğesine tıklayın ve ardından Modify Application Configuration öğesine tıklayın.

Environment Variable bölümünde, Type ayarını Reference ConfigMap olarak belirleyin. Uygulamanızdaki ortam değişkeni için özel bir Variable Name belirtin ve ardından başvurmak istediğiniz ConfigMap Name ile Key öğelerini seçin. Birden fazla değişken ekleyebilirsiniz. ConfigMap'teki tüm anahtarlara başvurmayı seçerseniz, orijinal anahtar adları ortam değişkeni adı olarak kullanıldığından bir Variable Name belirtmeniz gerekmez.
Uygulamanın dağıtılmasını bekleyin. Yapılandırmayı doğrulamak için uygulama örneğinin web kabuğuna oturum açın ve env | grep <variable_name> komutunu çalıştırın. <variable_name> ifadesini yapılandırdığınız değişken adıyla değiştirin. Çıktıda doğru değişken adı ve değeri görünüyorsa yapılandırma başarılı olmuştur.

ConfigMap'i dosya olarak montajlama

Bir ConfigMap'i dosya olarak monte etmek, belirtilen anahtarın değerini dosya içeriği olarak yazar. Dosya yolunu ve adını özelleştirebilirsiniz. Monte edilen dosya, aynı yoldaki mevcut herhangi bir dosyanın üzerine yazar.

Konteyner görüntüsünü yeniden oluşturmadan yapılandırma dosyalarını yönetmek için bu yaklaşımı kullanın. Mevcut bir yapılandırma dosyasını değiştirmek için içeriğini bir ConfigMap değerine kopyalayın ve ardından ConfigMap'i özgün dosya yoluna monte edin.

Uygulama oluşturma

SAE Application List sayfasında, üst gezinme çubuğundan hedef bölgeyi ve ad alanını seçin, ardından Create Application öğesine tıklayın. Application Basic Information sayfasında parametreleri yapılandırın ve Next: Advanced Settings öğesine tıklayın.

Çalışan bir uygulamayı değiştirme

Uyarı
Bir uygulamayı yeniden dağıttıktan sonra uygulama yeniden başlatılır. İş kesintisi gibi öngörülemeyen hataları önlemek için uygulamaları yoğun olmayan saatlerde dağıtmanızı öneririz.

SAE Application List sayfasında, üst gezinme çubuğundan hedef bölgeyi ve ad alanını seçin. Hedef Application kimliğine tıklayarak uygulama ayrıntıları sayfasını açın. Soldaki gezinme bölmesinde Basic Information öğesine tıklayın. Sağ üst köşede Deploy Application öğesine tıklayın.

Durdurulmuş bir uygulamayı değiştirme

SAE Application List sayfasında, üst gezinme çubuğundan hedef bölgeyi ve ad alanını seçin. Hedef Application kimliğine tıklayarak uygulama ayrıntıları sayfasını açın. Basic Information öğesine tıklayın ve ardından Modify Application Configuration öğesine tıklayın.

Configuration Management bölümünde + Add öğesine tıklayın. Montajlamak istediğiniz ConfigMap Name ve Key öğelerini seçin (veya tüm anahtarları monte etmeyi seçin). Ardından Mount Path değerini belirtin. Tek bir anahtar montajlıyorsanız, dosya adı dahil olmak üzere mutlak bir yol girin. Tüm anahtarları montajlıyorsanız, bir dizin için mutlak bir yol girin; SAE otomatik olarak anahtar adlarını dosya adı olarak kullanır. Birden fazla montaj ekleyebilirsiniz.
Uygulamanın dağıtılmasını bekleyin. Yapılandırmayı doğrulamak için uygulama örneğinin web kabuğuna oturum açın ve montaj yolundaki dosyanın içeriğini kontrol edin.

Örnekler

php-fpm.conf yapılandırma

Bir ConfigMap oluşturun.

ConfigMap Name değerini php-fpm olarak ayarlayın.

Configure Mappings için Edit in YAML format öğesini seçin ve aşağıdaki yapılandırmayı girin:

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

ConfigMap'i PHP uygulamanızın dosya sistemine bir yapılandırma dosyası olarak monte edin.
1. ConfigMap Name değerini php-fpm olarak ayarlayın.
2. Key değerini www_conf olarak ayarlayın.
3. Montaj yolu /usr/local/etc/php-fpm.d/www.conf şeklindedir.

nginx.conf yapılandırma

SAE kullanarak bir Nginx hizmeti dağıtma