Gerenciamento de imagens de um volume
As imagens customizadas criadas a partir de um volume são independentes do volume original. É possível atualizar a imagem e exclui-la conforme necessário. É possível excluir o volume original e a imagem customizada persistir. É possível planejar a descontinuação e tornar a imagem obsoleta no console, por meio da CLI ou da API.
Expressões de uso permitido: Você pode usar uma expressão de uso permitido com sua imagem personalizada para definir os recursos e as restrições de uma imagem e ajudá-lo a encontrar combinações compatíveis de imagem e perfil durante a criação do servidor. O valor padrão das expressões de uso permitido para quaisquer imagens personalizadas criadas a partir de um volume são as expressões de uso permitido do volume de origem original. No entanto, você pode editar essas expressões de uso permitido na imagem personalizada. Para obter mais informações, consulte Adição de expressões de uso permitido a imagens personalizadas.
Agendamento de uma alteração de status do ciclo de vida para uma imagem personalizada usando a interface do usuário
É possível planejar uma única mudança de status do ciclo de vida da imagem ou planejar as mudanças de status para todo o ciclo de vida da imagem
Use as seguintes etapas para planejar uma única mudança de status:
É possível planejar uma única mudança de status para uma imagem..
- No console IBM Cloud, acesse o
menu de navegação >
de infraestrutura > Computação > Imagens.
- Na guia Imagens Customizadas, clique no ícone Ações
para uma imagem específica e selecione entre as opções disponíveis.
- Selecione Ciclo de Vida de Planejamento
- Em Status da imagem, selecione a mudança de status da imagem.
- Em Detalhes da descontinuação, selecione se deseja mudar o status Imediatamente ou Planejar data futura.
- Se você selecionou Schedule future date (Agendar data futura ), é necessário preencher os seguintes campos:
- Selecione Por data do calendário ou Por número de dias.
- Se você tiver selecionado Por data do calendário, insira as informações de data e hora Esta é a data e a hora em que a mudança de status ocorrerá
- Se você selecionou Por número de dias, coloque o número de dias que passará antes que o status seja alterado.
- Selecione Por data do calendário ou Por número de dias.
- Clique em Salvar.
Use as seguintes etapas para planejar todo o ciclo de vida da imagem:
É possível planejar o ciclo de vida completo da imagem. A imagem é primeiro descontinuada e, em seguida, muda para obsoleta de acordo com o planejamento definido. Use as etapas a seguir para planejar uma mudança de ciclo de vida
-
No console IBM Cloud, acesse o
menu de navegação >
de infraestrutura > Computação > Imagens.
-
Na guia Imagens Customizadas, clique no ícone Ações
para uma imagem específica e selecione entre as opções disponíveis.
-
Selecione Ciclo de Vida de Planejamento
-
Selecione Programar ciclo de vida completo.
- Se você selecionou Por data do calendário, insira a data e hora para quando deseja que a mudança de status ocorra.
- Se você selecionou Por número de dias, coloque o número de dias que deseja passar antes que o status seja alterado.
A data para obsolescência deve ser posterior à data de descontinuação
-
Clique em Planejar.
Alteração do status do ciclo de vida de uma imagem personalizada usando a CLI
É possível mudar o status do ciclo de vida de uma imagem IBM Cloud VPC que foi criada por meio de um volume por meio da interface da linha de comandos (CLI). É possível fazer uma mudança de status imediata usando os comandos ibmcloud is image-deprecate ou ibmcloud is image-obsolete.. Também é possível planejar essas mudanças de status para uma data e hora futuras, usando o comando ibmcloud is image-update Especifique o nome ou ID da imagem customizada com a variável
IMAGE.
Para fazer uma mudança de status imediata, utilize um dos exemplos a seguir:
É possível fazer uma mudança de status imediata somente se uma mudança de status futura não for planejada Para remover uma mudança de status planejada, consulte Remover uma mudança de status de ciclo de vida de imagem customizada planejada usando a CLI. Depois de remover a mudança de status planejada, é possível fazer uma mudança de status imediata
-
Altere o status de ciclo da imagem para
deprecate.ibmcloud is image-deprecate IMAGE -
Altere o status de ciclo da imagem para
obsolete.ibmcloud is image-obsolete IMAGE
Para planejar uma mudança de status, use o exemplo a seguir:
Para a opção deprecate-at ou obsolete-at, especifique uma data no formato de data e hora ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm).
YYYYé o ano de quatro dígitosMMé o mês de dois dígitosDDé o dia de dois dígitosTsepara as informações de data e horahhé as horas de dois dígitosmmé os minutos de dois dígitos+hh:mmou-hh:mmé o fuso horário UTC
Assim, a data de 30 de setembro de 2023 às 20h no Fuso Horário Padrão Central da América do Norte (CST) seria 2023-09-30T20:00:00-06:00
Ao planejar a data e hora, não é possível usar sua data e hora atuais. Por exemplo, se for 8h em 12 de junho, a data e hora planejadas deverão ser após 8h em 12 de junho. Se você definir as datas deprecate-at e obsolete-at,
a data obsolete-at deverá ser posterior à data deprecate-at..
ibmcloud is image-update IMAGE [--deprecate-at YYYY-MM-DDThh:mm:ss+hh:mm] [--obsolete-at YYYY-MM-DDThh:mm:ss+hh:mm]
Se desejar alterar as entradas de data e hora deprecate-at e obsolete-at, será possível executar esses comandos novamente.. As datas e horas anteriores são então substituídas pelas novas datas e horas.
Remoção da alteração de status do ciclo de vida programada anteriormente usando a CLI
É possível remover uma mudança de status planejada usando as opções --reset-deprecate-at ou --reset-obsolete-at .. Se você usar uma dessas opções com o comando ibmcloud is image-update , a data e hora
serão removidas da imagem. A imagem não está mais planejada para essa mudança de status
ibmcloud is image-update IMAGE [--reset-deprecate-at] [--reset-obsolete-at]
Se você usar as opções --reset-deprecate-at e --reset-obsolete-at , o status da imagem retorna para available.
Alteração do status do ciclo de vida de uma imagem personalizada usando a API
É possível mudar o status do ciclo de vida de uma imagem IBM Cloud VPC que foi criada por meio do volume com a interface de programação de aplicativos (API). É possível fazer uma mudança de status imediata ou planejar uma mudança de status para acontecer mais tarde
Para fazer uma mudança de status imediata, utilize um dos exemplos a seguir: Para a variável $image_id, especifique o ID da imagem customizada para a mudança de status.
É possível fazer uma mudança de status imediata somente se uma mudança de status futura não for planejada Para remover uma mudança de status planejada, consulte Remover uma mudança de status do ciclo de vida da imagem customizada planejada usando a API Depois de remover a mudança de status planejada, é possível fazer uma mudança de status imediata
-
Altere o status do ciclo da imagem para
deprecated.curl -X POST "$vpc_api_endpoint/v1/images/$image_id/deprecate?version=2023-02-21&generation=2" -H “Authorization: Bearer $iam_token” -
Altere o status de ciclo da imagem para
obsolete.curl -X POST "$vpc_api_endpoint/v1/images/$image_id/obsolete?version=2023-12-21&generation=2" -H “Authorization: Bearer $iam_token”
Para planejar uma mudança de status, use um dos exemplos a seguir:
Para as propriedades deprecation_at ou obsolescence_at, especifique uma data no formato de data e hora ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm).
YYYYé o ano de quatro dígitosMMé o mês de dois dígitosDDé o dia de dois dígitosTsepara as informações de data e horahhé as horas de dois dígitosmmé os minutos de dois dígitos+hh:mmou-hh:mmé o fuso horário UTC
Assim, a data de 30 de setembro de 2023 às 20h no Fuso Horário Padrão Central da América do Norte (CST) seria 2023-09-30T20:00:00-06:00
Ao planejar a data e hora, não é possível usar sua data e hora atuais. Por exemplo, se for 8h em 12 de junho, a data e hora planejadas deverão ser após 8h em 12 de junho. Se você definir as datas e horas deprecation_at e obsolescence_at,
a data obsolescence_at deverá ser posterior à data e à hora deprecation_at
-
Planejar uma mudança de status para
deprecated.curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ "deprecation_at": "2023-03-01T06:11:28+05:30" }' -
Planejar uma mudança de status para
obsolete.curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ “obsolescence_at": "2023-12-31T06:11:28+05:30" }'Se desejar alterar as entradas de data e hora
deprecation_ateobsolescence_at, será possível executar esses comandos novamente.. As datas e horas anteriores são substituídas pelas novas datas e horas..
Remoção da alteração de status do ciclo de vida previamente programada usando a API
Faça uma solicitação de PATCH /images para remover qualquer mudança de status planejada atualizando deprecation_at ou obsolescence_at para null Esta mudança de propriedade remove a data e hora
da imagem e a imagem não é mais planejada para essa mudança de status..
-
Para alterar uma imagem de
deprecatedparaavailable, altere a propriedadedeprecation_atparanull..curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ "deprecation_at": null }' -
Para mudar uma imagem de
obsoletepara seu estado anterior, mudeobsolescence_atparanullSe a imagem anteriormente continha um valor diferente denullparadeprecation_at, essa mudança de propriedade removerá o estadoobsoletee a mudará de volta paradeprecated. Se o estado anterior eraavailable, o que significa que a imagem foi movida deavailablediretamente paraobsolete, essa mudança de propriedade será movida deobsoletede volta paraavailable.curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ “obsolescence_at": null }' -
Para mudar uma imagem que tenha as propriedades
deprecation_atouobsolescence_atconfiguradas novamente paraavailable, deve-se atualizar as propriedadesdeprecation_atouobsolescence_atcurl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ "deprecation_at": null, “obsolescence_at": null }'
Considerações sobre o Desempenho
Vários fatores podem influenciar a rapidez com que sua imagem do volume é colocada na fila e criada, como o tamanho da imagem e o número de tarefas na fila. Se uma imagem estiver demorando mais do que você quer esperar, será possível cancelar a tarefa.
Desempenho durante a criação de imagens
Ao criar a imagem, o parâmetro status_reasons da API indica image_request_queued, com a mensagem “A solicitação da imagem foi aceita e está aguardando a disponibilidade de recursos do sistema”. Ao ver esta
mensagem, pode levar um tempo para a tarefa iniciar. A tabela a seguir fornece algumas diretrizes que são baseadas no tamanho da imagem. Verifique se o status é “ in_progress ” para saber se a imagem está sendo criada. Novamente,
dependendo do tamanho da imagem, pode levar um tempo antes que a imagem esteja disponível.
| Tamanho da imagem | Tempo estimado até que a imagem esteja disponível |
|---|---|
| 5 GB | 5 min. |
| 10 GB | 10 min. |
| 25 GB | 25 min |
| 50 GB | 50 min |
| 75 GB | 1 h 15 min |
| 100 GB | 1 h 40 min |
O tempo para a tarefa iniciar é de cerca de 30 segundos. Esse tempo não reflete o tráfego na fila, o que pode aumentar a estimativa. A maioria das tarefas começa dentro de 5 a 10 minutos. Se levar mais tempo, cancele a criação de imagem
Cancelando uma imagem que está enfileirada para criação
É possível cancelar a criação de imagem, excluindo a imagem se a tarefa subjacente ainda não tiver iniciado. Para imagens em um estado pendente, a chamada da API GET /images retorna um código de razão image_request_queued.
É possível excluir a imagem pendente com uma solicitação DELETE /image{image_id}. Como alternativa, é possível utilizar a UI ou
CLI para excluir a imagem que está em um estado pendente..
Exclusão de uma imagem personalizada usando a interface do usuário
Você pode excluir da lista de imagens personalizadas uma imagem criada a partir de um volume. É possível excluir imagens que estão no estado pendente (enquanto estão sendo criadas) e no estado disponível.
- Acesse a lista de imagens customizadas. No site IBM Cloud console, acesse a página Menu de navegação
> Infraestrutura VPC
> Computação > Imagens.
- Na guia Imagens customizadas, localize a imagem que deseja excluir. No menu Ações
, selecione Excluir.
Excluindo uma imagem do volume usando a CLI
-
Localize a imagem do volume na lista de imagens.
ibmcloud is images -
Exclua a imagem por ID.
ibmcloud is image-delete IMAGE_ID
Excluindo uma imagem do volume usando a API
Faça uma solicitação DELETE /images e especifique o ID da imagem que foi criada a partir de um volume de inicialização.
-
Localizar o ID da imagem do volume:
curl -X GET "$vpc_api_endpoint/v1/images?version=2024-06-12&generation=2" -H "Authorization: Bearer $iam_token" -
Excluir a imagem por ID:
curl -X DELETE "$vpc_api_endpoint/v1/images/$image_id?version=2024-06-12&generation=2" -H "Authorization: Bearer $iam_token"
Próximas etapas
Conheça o processo completo de criação de uma imagem a partir de um volume; depois, você poderá usar essa imagem ao criar uma nova instância de servidor virtual. Para obter mais informações, consulte o Tutorial de imagem do volume.