Os caches de imagem aceleram o pull de imagens e reduzem o tempo de inicialização das instâncias de contêiner elástico. Este tópico descreve como criar, consultar, atualizar e excluir um cache de imagem.
Criar um cache de imagem
Crie manualmente um cache de imagem pelo console do Elastic Container Instance ou chame uma operação de API.
O Elastic Container Instance oferece suporte à criação automática de cache de imagem. Ative a correspondência automática de caches de imagem ao criar uma instância de contêiner elástico. Assim, se nenhum cache for encontrado, o sistema cria um automaticamente.
Precauções
A criação de caches de imagem gera custos. Consulte as informações de faturamento relevantes com antecedência. Para obter mais detalhes sobre o faturamento de caches de imagem, consulte Caches de imagem.
Antes de criar um cache de imagem, estime o tamanho total das imagens que deseja armazenar em cache. Se o tamanho total das imagens exceder o tamanho especificado para o cache, a criação falhará.
Durante a criação do cache de imagem, o sistema gera automaticamente uma instância de contêiner elástico intermediária e um disco para o cache. Não exclua essa instância intermediária nem o disco enquanto o cache estiver sendo criado, pois isso impedirá a conclusão do processo.
Um snapshot local temporário e uma quantidade específica de snapshots regulares são gerados durante a criação do cache de imagem. Não exclua esses snapshots; caso contrário, o cache de imagem ficará inválido.
Criar um cache de imagem chamando uma operação de API
Chame a operação de API CreateImageCache para criar um cache de imagem. A tabela a seguir descreve os parâmetros dessa operação. Para obter mais informações, consulte CreateImageCache.
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
RegionId |
string |
cn-hangzhou |
O ID da região do cache de imagem. |
|
SecurityGroupId |
string |
sg-uf66jeqopgqa9hdn**** |
O ID do grupo de segurança. |
|
VSwitchId |
string |
vsw-uf6h3rbwbm90urjwa**** |
O ID do vSwitch. |
|
ImageCacheName |
string |
testcache |
O nome do cache de imagem. |
|
Image.N |
array |
registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl |
A imagem de contêiner N usada como base para a criação do cache de imagem. |
|
ImageCacheSize |
integer |
20 |
O tamanho do cache de imagem. Unidade: GiB. Valor padrão: 20. |
|
RetentionDays |
integer |
7 |
O período de retenção do cache de imagem. Quando o período especificado expira, o cache é excluído. Unidade: dias. |
|
AutoMatchImageCache |
boolean |
false |
Define se o reúso de camadas de imagem deve ser ativado. Se você ativar esse recurso e o cache que deseja criar compartilhar camadas duplicadas com um cache existente, o sistema reutilizará essas camadas para criar o novo cache, acelerando o processo. Valor padrão: false. |
|
Flash |
boolean |
true |
Define se o recurso de cache de imagem instantâneo deve ser ativado. Esse recurso acelera a criação de caches de imagem. Valor padrão: false. |
Ao criar um cache de imagem, configure os parâmetros AcrRegistryInfo para fazer pull de imagens de uma instância do Container Registry Enterprise Edition sem usar um secret. Para obter mais informações, consulte Fazer pull de imagens de uma instância do Container Registry sem usar um secret.
Criar um cache de imagem pelo console do Elastic Container Instance
No painel de navegação à esquerda do console do Elastic Container Instance, clique em Image Cache. Na página Image Cache, clique em Create Image Cache.
-
Na página exibida, configure os parâmetros.
Descrição dos parâmetros:
-
Parâmetros básicos: Configure itens como Region and Zone, Network Type e Security Group para criar uma instância intermediária.
ImportanteSe você precisar fazer pull de imagens pela Internet e nenhuma NAT gateway estiver configurada na virtual private cloud (VPC), associe um elastic IP address (EIP) à instância de contêiner elástico.
Image Cache: Insira um nome para o cache de imagem, selecione o diretório e o número da versão da imagem usada para criar o cache e defina o tamanho e o período de retenção conforme sua necessidade.
Credential: Caso a imagem utilizada para criar o cache seja privada, insira o endereço, o nome de usuário e a senha do repositório de imagens.
-
Leia e aceite os Termos de Serviço do Elastic Container Instance. Clique em Create e siga as instruções na tela para concluir as operações subsequentes.
-
Retorne à página Image Cache para visualizar o novo cache de imagem.
O progresso de criação aparece na coluna Status. Quando o status mudar para Created, o cache de imagem estará pronto. Clique no ID do cache para acessar a página de detalhes e visualizar informações básicas e eventos relacionados.
Consultar um cache de imagem
Após criar um cache de imagem, consulte suas informações. O cache estará disponível para uso quando atingir o estado Created (Ready).
Utilize um dos métodos abaixo para consultar um cache de imagem:
Chame a operação de API DescribeImageCaches. Para obter mais informações, consulte DescribeImageCaches.
No console do Elastic Container Instance, acesse a página Image Cache para visualizar informações como nome e status do cache. Também é possível clicar no ID do cache para ver detalhes, incluindo eventos associados.
Atualizar um cache de imagem
Se um cache de imagem estiver no estado Created (Ready) ou UpdateFailed, chame a operação de API UpdateImageCache para atualizá-lo. Isso permite modificar a imagem de contêiner, o período de retenção e o repositório de imagens do cache. Para obter mais informações, consulte UpdateImageCache.
Excluir um cache de imagem
Como os caches de imagem são snapshots, mantê-los gera custos de armazenamento. Caso não tenha definido um período de retenção, recomendamos excluir o cache quando ele não for mais necessário.
A Alibaba Cloud gerencia os caches de imagem criados automaticamente pelo sistema e os exclui após um determinado período.
O sistema exclui automaticamente um cache de imagem não utilizado após 7 dias.
O sistema também exclui o cache se ele permanecer sem uso por mais de 30 dias.
Escolha um dos métodos a seguir para excluir um cache de imagem:
Chame a operação de API DeleteImageCache. Para obter mais informações, consulte DeleteImageCache.
Na página Image Cache do console do Elastic Container Instance, selecione o cache de imagem desejado e clique em Delete Image Cache abaixo da lista de caches.