Todos os produtos
Search
Central de documentação

Serverless App Engine:Adicionar um contêiner sidecar

Última atualização: Jun 28, 2026

Serverless App Engine (SAE) permite adicionar um contêiner sidecar a uma aplicação para ampliar a funcionalidade do contêiner principal. O contêiner sidecar ajuda a desacoplar e padronizar funções não relacionadas ao negócio, como monitoramento e coleta de logs. Essa abordagem separa as tarefas auxiliares do contêiner principal da aplicação, permitindo que ele se concentre em sua lógica de negócio central.

Pontos de entrada

  1. 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 reimplantação de uma aplicação reinicia o serviço. Para evitar erros imprevisíveis, como interrupções de serviço, implante 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 desejada 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 desejada para abrir a página de detalhes da aplicação.Clique em Basic Information e, em seguida, clique em Modify Application Configuration.

  2. Localize e expanda a seção Add a sidecar container. e clique em Add.

Configuração

No painel Sidecar container, configure os seguintes parâmetros e clique em OK.

  1. Insira um Container name personalizado.

  2. Conforme a origem da imagem do sidecar, selecione Images of Current Alibaba Cloud Account ou Custom Image:

    • Images of Current Alibaba Cloud Account: obtém uma imagem do repositório do Container Registry (ACR) na conta atual. Use o Container Registry Personal Edition ou o Container Registry Enterprise Edition.

      Pré-requisitos: crie uma imagem e envie-a para um repositório de imagens do ACR na conta atual. Para mais informações, consulte Exemplos de criação de imagem, Criar imagens usando instâncias do Enterprise Edition ou Enviar e obter imagens usando instâncias do Personal Edition.

      • Container Registry Personal Edition: especifique a imagem do sidecar selecionando um Image Repository Namespace, um Image Repository Name e uma Image Version.

        Por exemplo, defina o namespace do repositório de imagens como demo, o nome do repositório de imagens como nginx e a tag da imagem como latest.

      • Container Registry Enterprise Edition: especifique a imagem do sidecar selecionando uma instância na lista Enterprise Edition Instances e, em seguida, um Image Repository Namespace, um Image Repository Name e uma Image Version.

    • Custom Image: obtém uma imagem de um repositório de imagens privado em outra conta da Alibaba Cloud ou de um repositório de imagens de terceiros.

      • Repositório de imagens privado em outra conta da Alibaba Cloud:

        Se o contêiner principal da aplicação obtiver sua imagem de um repositório ACR em outra conta da Alibaba Cloud, o contêiner sidecar também poderá obter uma imagem do mesmo repositório. O SAE reutiliza automaticamente o acrAssumeRoleArn e o secret configurados para o contêiner principal da aplicação.

        Insira o Image address completo. O formato é <image repository address>:<image tag>. Por exemplo: registry.cn-beijing.aliyuncs.com/sae-demo-******:nginx.

      • Repositório de imagens de terceiros:

        Para obter uma imagem de um repositório de terceiros, como docker Hub, Harbor ou GitHub Container Registry, certifique-se de que o endereço do repositório seja acessível pela internet pública.

        Insira o Image address completo. O formato é <image name>:<image tag>. Por exemplo: registry.openanolis.cn/******/nginx:1.14.1-8.6.

        Importante

        Por padrão, as aplicações do SAE não têm acesso à internet pública e, portanto, não conseguem obter imagens de repositórios públicos. Para habilitar esse acesso, configure um NAT Gateway para a Virtual Private Cloud (VPC) da sua aplicação. Para mais informações, consulte Configurar um NAT Gateway para habilitar o acesso à rede pública para aplicações do SAE.

  3. Defina o Maximum number of CPU resources e o Maximum number of memory resources para o Sidecar container.

    Nota

    O contêiner sidecar compartilha recursos de cpu e memória com o contêiner principal da aplicação. Para garantir o funcionamento adequado do contêiner principal, defina limites de recursos adequados para o contêiner sidecar e evite consumo excessivo.

  4. (Opcional) Clique em Advanced Settings para configurar os seguintes parâmetros do contêiner sidecar.

    1. Na seção Startup Command, configure um comando de inicialização para o contêiner sidecar. Para mais informações, consulte Definir um comando de inicialização.

    2. Na seção Environment Variable, configure variáveis de ambiente para o contêiner sidecar. Para mais informações, consulte Definir variáveis de ambiente.

    3. Na seção Configuration Management, injete a configuração necessária no contêiner sidecar montando um ConfigMap. Para mais informações, consulte Injetar configurações.

    4. Na seção Share temporary storage, crie e monte um diretório de armazenamento temporário tanto para o contêiner principal da aplicação quanto para o contêiner sidecar.

      Insira um Temporary Storage Name e um Container Path.

      Nota

      O nome do armazenamento temporário pode conter apenas letras minúsculas, dígitos e hifens (-).

Verificação da implantação

  • Na página Log Management, visualize os logs em tempo real do contêiner principal da aplicação e do contêiner sidecar.

    Na lista suspensa Container, na parte superior da página, selecione Sidecar container sidecar-nginx para visualizar seus logs em tempo real.

  • Na página Instances, use o Webshell para fazer login em uma instância. A página do Webshell exibe detalhes tanto do contêiner principal da aplicação quanto do contêiner sidecar.

    Use a lista suspensa na parte superior para alternar entre o Main application container e o Sidecar container sidecar-nginx.

  • No diretório /tmp do contêiner principal da aplicação e do contêiner sidecar, verifique a existência de um diretório test.