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..

  1. No console IBM Cloud, acesse o ícone do menu de navegação > ícone da VPC de infraestrutura > Computação > Imagens.
  2. Na guia Imagens Customizadas, clique no ícone Ações ícone Mais Ações para uma imagem específica e selecione entre as opções disponíveis.
  3. Selecione Ciclo de Vida de Planejamento
  4. Em Status da imagem, selecione a mudança de status da imagem.
  5. Em Detalhes da descontinuação, selecione se deseja mudar o status Imediatamente ou Planejar data futura.
  6. 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.
  7. 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

  1. No console IBM Cloud, acesse o ícone do menu de navegação > ícone da VPC de infraestrutura > Computação > Imagens.

  2. Na guia Imagens Customizadas, clique no ícone Ações ícone Mais Ações para uma imagem específica e selecione entre as opções disponíveis.

  3. Selecione Ciclo de Vida de Planejamento

  4. 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

  5. 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ígitos
  • MM é o mês de dois dígitos
  • DD é o dia de dois dígitos
  • T separa as informações de data e hora
  • hh é as horas de dois dígitos
  • mm é os minutos de dois dígitos
  • +hh:mm ou -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ígitos
  • MM é o mês de dois dígitos
  • DD é o dia de dois dígitos
  • T separa as informações de data e hora
  • hh é as horas de dois dígitos
  • mm é os minutos de dois dígitos
  • +hh:mm ou -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_at e obsolescence_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 deprecated para available, altere a propriedade deprecation_at para null..

    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 obsolete para seu estado anterior, mude obsolescence_at para null Se a imagem anteriormente continha um valor diferente de null para deprecation_at, essa mudança de propriedade removerá o estado obsolete e a mudará de volta para deprecated. Se o estado anterior era available, o que significa que a imagem foi movida de available diretamente para obsolete, essa mudança de propriedade será movida de obsolete de volta para available.

    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_at ou obsolescence_at configuradas novamente para available, deve-se atualizar as propriedades deprecation_at ou obsolescence_at

    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, “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.

Tempo de espera estimado para a criação da imagem
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.

  1. Acesse a lista de imagens customizadas. No site IBM Cloud console, acesse a página Menu de navegação ícone do menu > Infraestrutura VPC Ícone do VPC > Computação > Imagens.
  2. Na guia Imagens customizadas, localize a imagem que deseja excluir. No menu Ações ícone Ações, selecione Excluir.

Excluindo uma imagem do volume usando a CLI

  1. Localize a imagem do volume na lista de imagens.

    ibmcloud is images
    
  2. 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.

  1. 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"
    
  2. 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.