Todos os produtos
Search
Central de documentação

Elastic Container Instance:Configurar uma imagem de contêiner

Última atualização: Jun 27, 2026

Uma imagem de contêiner contém os programas, as bibliotecas e as configurações necessários para executar uma aplicação em contêiner.

Contexto

Antes de criar uma Elastic Container Instance, envie uma imagem de contêiner para um repositório de imagens. A Elastic Container Instance (ECI) permite baixar imagens de repositórios como Docker Hub e Alibaba Cloud Container Registry (ACR). O ACR ajuda a compilar, distribuir e gerenciar suas imagens de contêiner. Para mais informações, consulte O que é o Container Registry?.

Observações de uso

Se você baixar uma imagem da internet e sua VPC não tiver um NAT gateway, associe um elastic IP address (EIP) à Elastic Container Instance.

Configuração

API

Ao chamar a operação CreateContainerGroup para criar uma Elastic Container Instance, use parâmetros como Container.N.Image para configurar a imagem do contêiner. Para mais informações, consulte CreateContainerGroup.

Parâmetro

Tipo

Exemplo

Descrição

Container.N.Image

String

registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:latest

Imagem usada pelo contêiner.

InitContainer.N.Image

String

registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:latest

Imagem usada pelo init container.

Para imagens de diferentes origens, configure também os seguintes parâmetros:

  • Se a imagem vier de um repositório privado, use os parâmetros ImageRegistryCredential para configurar a credencial de acesso ao repositório.

    Parâmetro

    Tipo

    Exemplo

    Descrição

    ImageRegistryCredential.N.Password

    String

    yourpassword

    Senha do repositório.

    ImageRegistryCredential.N.Server

    String

    registry-vpc.cn-hangzhou.aliyuncs.com

    Endpoint de registro do repositório.

    ImageRegistryCredential.N.UserName

    String

    yourusername

    Nome de usuário do repositório.

  • Para imagens provenientes de um repositório do Container Registry Enterprise Edition, use os parâmetros AcrRegistryInfo para baixar imagens sem precisar de um secret. Para mais detalhes, consulte Fazer pull de imagens de uma instância do Container Registry sem usar um secret.

  • Se a imagem vier de um repositório autogerenciado que usa o protocolo HTTP ou certificado autoassinado, configure o parâmetro PlainHttpRegistry ou InsecureRegistry para evitar falhas no download da imagem. Para mais informações, consulte Fazer pull de imagem de um repositório de imagens autogerenciado.

Console

Ao criar uma Elastic Container Instance na página de compra da Elastic Container Instance, configure o contêiner na página Basic Settings e selecione um dos seguintes tipos de imagem:

  • Common Images: Imagens de teste open source fornecidas pela ECI para validação rápida de recursos.

  • Docker Official Images: Imagens públicas disponíveis no Docker Hub.

  • My Images: Imagens armazenadas nos seus repositórios do Container Registry Personal Edition.

  • Container Registry Enterprise Edition image: Imagens armazenadas nos seus repositórios do Container Registry Enterprise Edition.

As imagens comuns incluem eci_open/nginx, eci_open/redis, eci_open/tomcat, eci_open/rabbitmq e eci_open/fluentd.

Se utilizar uma imagem privada (não disponível publicamente via ECI, ACR ou Docker Hub), insira o endereço e a tag na seção de configuração de imagem. Em seguida, na página Other Settings (Optional), configure a credencial de acesso ao repositório.

Na seção Image Registry Credential, preencha os campos Server (por exemplo, registry-vpc.cn-hangzhou.aliyuncs.com), Username e Password. Para adicionar múltiplas credenciais, clique em Add Credential.