Gerenciar e usar ConfigMaps do K8s - Serverless App Engine: Central de Documentação do Alibaba Cloud

Os ConfigMaps funcionam como variáveis de ambiente ou arquivos de configuração montados nos contêineres da aplicação, permitindo alterar configurações após a implantação sem reconstruir a imagem.

Para buscar dados de configuração dinamicamente em um centro de configuração, consulte Use Nacos in MSE ou Manage distributed configurations (ACM).

Para armazenar informações confidenciais, como chaves e certificados, consulte Manage and use Secrets (K8s Secret).

Criar um ConfigMap

Na página SAE ConfigMaps, selecione a região e o namespace da aplicação e clique em Create.

Especifique um ConfigMap Name personalizado.

Em Configure Mappings, escolha um modo de edição para definir os pares chave-valor:

Edit using form: Clique em Add Variable e insira uma chave com seu respectivo valor. É possível adicionar vários pares chave-valor. Para conteúdos de configuração longos, clique no ícone ao lado do valor para colar e editar o conteúdo em um editor maior.

Edit in JSON format: No editor de código, insira um ou mais pares chave-valor. As chaves e os valores do tipo string devem estar entre aspas duplas (""). Exemplo:

{
    "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: No editor de código, insira um ou mais pares chave-valor. Exemplo:

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

      }

Localize o ConfigMap criado na lista Configuration Item (ConfigMap). Em seguida, você pode Edit, Copy, View Record ou Delete o item.
Importante
- Um ConfigMap só entra em vigor após você use it as an environment variable ou mount it as a file to your application's file system.
- Ao modificar um ConfigMap, reimplemente qualquer aplicação que faça referência a ele para aplicar as alterações.
- Excluir um ConfigMap pode causar falhas nas aplicações que o referenciam. Antes da exclusão, remova todas as referências a ele nas suas aplicações.

Usar um ConfigMap como variável de ambiente

Criar uma aplicação

Na página SAE Application List, selecione a região e o namespace de destino na barra de navegação superior e clique em Create Application. Na página Application Basic Information, configure os parâmetros e clique em Next: Advanced Settings.

Alterar uma aplicação em execução

Aviso
A reimplementação reinicia a aplicação. Para evitar erros imprevisíveis, como interrupções de negócios, recomendamos implantar aplicações fora dos horários de pico.

Na página SAE Application List, selecione a região e o namespace de destino na barra de navegação superior. Clique no ID da Application alvo para abrir a página de detalhes da aplicação.No painel de navegação à esquerda, clique em Basic Information. No canto superior direito, clique em Deploy Application.

Alterar uma aplicação parada

Na página SAE Application List, selecione a região e o namespace de destino na barra de navegação superior. Clique no ID da Application alvo para abrir a página de detalhes da aplicação.Clique em Basic Information e, em seguida, clique em Modify Application Configuration.

Na seção Environment Variable, defina o Type como Reference ConfigMap. Especifique um Variable Name personalizado para a variável de ambiente na aplicação e selecione o ConfigMap Name e a Key a serem referenciados. É possível adicionar várias variáveis. Se optar por referenciar todas as chaves do ConfigMap, não será necessário especificar um Variable Name, pois os nomes originais das chaves serão usados como nomes das variáveis de ambiente.
Aguarde a implantação da aplicação. Para verificar a configuração, log on to the web shell of the application instance e execute o comando env | grep <variable_name>. Substitua <variable_name> pelo nome da variável configurada. Se a saída exibir o nome e o valor corretos da variável, a configuração foi bem-sucedida.

Montar um ConfigMap como arquivo

Montar um ConfigMap como arquivo grava o valor da chave especificada como conteúdo do arquivo. Você pode personalizar o caminho e o nome do arquivo. O arquivo montado substitui qualquer arquivo existente no mesmo caminho.

Use essa abordagem para gerenciar arquivos de configuração sem reconstruir a imagem do contêiner. Para modificar um arquivo de configuração existente, copie seu conteúdo para um valor do ConfigMap e monte o ConfigMap no caminho original do arquivo.

Criar uma aplicação

Na página SAE Application List, selecione a região e o namespace de destino na barra de navegação superior e clique em Create Application. Na página Application Basic Information, configure os parâmetros e clique em Next: Advanced Settings.

Alterar uma aplicação em execução

Aviso
A reimplementação reinicia a aplicação. Para evitar erros imprevisíveis, como interrupções de negócios, recomendamos implantar aplicações fora dos horários de pico.

Na página SAE Application List, selecione a região e o namespace de destino na barra de navegação superior. Clique no ID da Application alvo para abrir a página de detalhes da aplicação.No painel de navegação à esquerda, clique em Basic Information. No canto superior direito, clique em Deploy Application.

Alterar uma aplicação parada

Na página SAE Application List, selecione a região e o namespace de destino na barra de navegação superior. Clique no ID da Application alvo para abrir a página de detalhes da aplicação.Clique em Basic Information e, em seguida, clique em Modify Application Configuration.

Na seção Configuration Management, clique em + Add. Selecione o ConfigMap Name e a Key a serem montados (ou opte por montar todas as chaves). Em seguida, especifique o Mount Path. Ao montar uma única chave, forneça um caminho absoluto incluindo o nome do arquivo. Ao montar todas as chaves, forneça um caminho absoluto para um diretório; o SAE usará automaticamente os nomes das chaves como nomes de arquivo. É possível adicionar vários pontos de montagem.
Aguarde a implantação da aplicação. Para verificar a configuração, log on to the web shell of the application instance e verifique o conteúdo do arquivo no caminho de montagem.

Exemplos

Configurar php-fpm.conf

Crie um ConfigMap.

Defina o ConfigMap Name como php-fpm.

Em Configure Mappings, selecione Edit in YAML format e insira a seguinte configuração:

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

Monte o ConfigMap como um arquivo de configuração no sistema de arquivos da sua aplicação PHP.
1. Defina o ConfigMap Name como php-fpm.
2. Defina a Key como www_conf.
3. O caminho de montagem é /usr/local/etc/php-fpm.d/www.conf.

Configurar nginx.conf

Deploy an Nginx service by using SAE