Um cache de imagem acelera o pull de imagens e reduz o tempo de inicialização das instâncias do Elastic Container Instance (ECI). Este tópico descreve como criar, consultar, atualizar e excluir caches de imagem.
Crie um cache de imagem
Crie um cache de imagem manualmente no console ou chamando uma operação de API.
O ECI pode criar caches de imagem automaticamente. Ao criar uma instância do ECI com a correspondência automática de cache de imagem ativada, o sistema gera um novo cache caso nenhum existente seja compatível.
Antes de começar
A criação de um cache de imagem gera custos. Revise os detalhes de faturamento antes de prosseguir. Para mais informações, consulte Image cache billing.
Antes de criar o cache, estime o tamanho total das imagens de contêiner a serem armazenadas. 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 provisiona automaticamente uma instância intermediária do ECI e um disco em cloud. Não exclua esses recursos durante o processo; caso contrário, a criação do cache falhará.
A criação de um cache de imagem gera um snapshot correspondente. Não exclua esse snapshot; caso contrário, o cache de imagem ficará inválido.
Crie um cache de imagem via API
Chame a operação de API CreateImageCache para criar um cache de imagem. A tabela a seguir descreve os principais parâmetros da requisição. Para mais informações, consulte CreateImageCache.
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
RegionId |
string |
cn-hangzhou |
O ID da região. |
|
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 |
As imagens de contêiner usadas para criar o cache de imagem. |
|
ImageCacheSize |
integer |
20 |
O tamanho do cache de imagem em GiB. O valor padrão é 20. |
|
RetentionDays |
integer |
7 |
O período de retenção do cache de imagem, em dias. O cache é excluído após o término desse período. |
|
AutoMatchImageCache |
boolean |
false |
Define se o reaproveitamento de camadas de imagem deve ser ativado. Ao ativar esse recurso, um novo cache pode reutilizar camadas de um cache existente, acelerando o processo de criação. O 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 do cache de imagem. O valor padrão é false. |
Ao criar um cache de imagem, configure os parâmetros AcrRegistryInfo para fazer o pull de imagens de uma instância do Container Registry Enterprise Edition sem credenciais. Para mais informações, consulte Configure password-free access to a Container Registry Enterprise Edition instance.
Crie um cache de imagem no console
Na página Image Cache do Elastic Container Instance console, clique em Create Image Cache.
-
Na página exibida, configure os parâmetros.
-
Parâmetros básicos: especifique a região, a zona de disponibilidade, a Virtual Private Cloud (VPC) e o grupo de segurança da instância intermediária.
ImportanteSe o pull das imagens de contêiner ocorrer pela internet e a Virtual Private Cloud (VPC) selecionada não tiver um gateway NAT, atribua um elastic IP address (EIP).
Image Cache: insira um nome, selecione o endereço e a versão da imagem e especifique o tamanho e o período de retenção do cache de imagem.
Image Repository Credentials: para imagens privadas, insira o endereço, o nome de usuário e a senha do repositório de imagens.
-
Marque a caixa de seleção dos Termos de Serviço, clique em Confirm Creation e siga as instruções na tela para concluir o processo.
-
Na página Image Cache, verifique o status da criação.
A coluna Status exibe o progresso da criação. O cache de imagem é criado com sucesso quando o status muda para Ready. Clique no ID do cache de imagem para visualizar seus detalhes e eventos.
Consultar caches de imagem
Após criar um cache de imagem, consulte seus detalhes. Um cache de imagem só pode ser utilizado quando estiver no estado Ready.
Consulte um cache de imagem de uma das seguintes maneiras:
Chame a operação de API DescribeImageCaches para consultar os caches de imagem. Para mais informações, consulte DescribeImageCaches.
Na página Image Cache do Elastic Container Instance console, visualize o nome e o status de um cache de imagem. Também é possível clicar no ID do cache para visualizar seus detalhes e eventos.
Atualize um cache de imagem
Se um cache de imagem estiver no estado Ready ou UpdateFailed, chame a operação de API UpdateImageCache para atualizá-lo. É possível atualizar propriedades como a imagem de contêiner, o período de retenção e as informações do repositório de imagens. Para mais informações, consulte UpdateImageCache.
Exclua um cache de imagem
Cada cache de imagem está associado a um snapshot, o que gera taxas de armazenamento. Caso não precise mais de um cache de imagem criado sem período de retenção, exclua-o prontamente para evitar cobranças desnecessárias.
O Alibaba Cloud gerencia os caches de imagem criados automaticamente e os exclui após um período específico.
O sistema exclui automaticamente um cache de imagem não utilizado após 7 dias.
O sistema exclui automaticamente um cache de imagem se ele permanecer sem uso por mais de 30 dias.
Exclua um cache de imagem de uma das seguintes maneiras:
Chame a operação de API DeleteImageCache para excluir um cache de imagem. Para mais informações, consulte DeleteImageCache.
Na página Image Cache do Elastic Container Instance console, selecione o cache de imagem que deseja excluir e clique em Delete Image Cache na parte inferior da página.