Gerenciando imagens customizadas usando a IU

É possível gerenciar uma imagem usando o console do IBM Cloud.

1. No site IBM Cloud console, acesse o ícone “ Menu de navegação ” > Infraestrutura > Computação > Imagens.
2. Na guia Imagens Customizadas, clique no ícone Ações para uma imagem específica e selecione entre as opções disponíveis. As imagens customizadas criptografadas são identificadas por um ícone de bloqueio após o nome da imagem. É possível selecionar por meio das ações a seguir:

Listando imagens customizadas usando a CLI

É possível listar todas as imagens customizadas do IBM Cloud VPC em sua região usando a interface da linha de comandos (CLI).

Para listar todas as imagens customizadas usando a CLI, use o comando ibmcloud is images. As imagens customizadas são privadas para a conta na qual elas são criadas, portanto, a opção --visibility é private

ibmcloud is images --visibility private

Para obter mais informações, consulte a seção “ibmcloud is images” na página de referência da CLI do VPC.

Listar todas as imagens usando a API

É possível listar todas as imagens do IBM Cloud VPC na região usando a interface de programação de aplicativos (API).

Para listar todas as imagens usando a API, use Listar todas as imagens. As imagens customizadas são privadas para a conta na qual elas são criadas, portanto, é possível configurar a propriedade visibility como private para recuperar apenas imagens customizadas

curl -X GET \
”$vpc_api_endpoint/v1/images?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"

Listando todas as imagens usando o Terraform

É possível listar todas as imagens do IBM Cloud VPC em sua região usando o Terraform.

Para listar todas as imagens usando o Terraform, use o comando de origem de dados do Terraform ibm_is_images As imagens customizadas são privadas para a conta na qual elas são criadas, portanto, é possível configurar o atributo visibility como private para recuperar apenas imagens customizadas

data "ibm_is_images" "images" {
  visibility = "public"
}

Visualização dos detalhes de uma imagem personalizada por meio da interface do usuário

Você pode visualizar os seguintes detalhes de uma imagem customizada:

• Expressões de uso permitido
• Grupo de recursos designado
• Soma de verificação
• Data da criação
• CRN
• Data de descontinuação (se configurada)
• Tipo de criptografia
• Local
• Nome e ID
• Data de obsolescência (se definida)
• Sistema operacional e versão
• Tamanho
• Tipo de origem

É possível editar o nome da imagem customizada, incluir tags para a capacidade de procura e visualizar e copiar o Cloud Resource Name (CRN) exclusivo. O valor da soma de verificação SHA256 para a imagem está acessível.

Para visualizar detalhes para uma imagem customizada, conclua as etapas a seguir.

1. No site IBM Cloud console, acesse o ícone “ Menu de navegação ” > Infraestrutura > Computação > Imagens.
2. Na guia Custom images (Imagens personalizadas ), clique no nome de uma imagem personalizada e, no painel seguinte, clique em View image details.
3. Na página Detalhes da imagem, você pode editar o nome da imagem, copiar a soma de verificação, adicionar tags, copiar o CRN da imagem e editar as expressões de uso permitido da imagem.
4. No menu “Ações” da página de detalhes da imagem, você pode realizar ações como criar uma instância de servidor virtual a partir da imagem personalizada ou excluir a imagem. Para obter uma lista completa de possíveis ações, consulte Gerenciando imagens customizadas usando a IU

Visualizando detalhes da imagem customizada usando a CLI

É possível visualizar os detalhes de uma imagem customizada, como nome e ID, sistema operacional e versão, status de criptografia, datas de descontinuação ou obsolescência e grupo de recursos designado, usando a interface da linha de comandos (CLI)

Para visualizar os detalhes de uma imagem personalizada por meio da CLI, utilize o ibmcloud is image comando. Especifique o nome ou ID da imagem customizada com a variável IMAGE.

ibmcloud is image IMAGE

Para obter mais informações, consulte “ibmcloud is image” na página de referência da CLI do VPC.

Recuperando detalhes da imagem customizada usando a API

É possível visualizar os detalhes de uma imagem customizada, como nome e ID, sistema operacional e versão, status de criptografia, datas de descontinuação ou obsolescência e grupo de recursos designados, usando a interface de programação de aplicativos (API).

Para recuperar os detalhes de uma imagem customizada específica usando a API, use Recuperar uma imagem Para a variável $image_id, especifique o ID da imagem customizada que deseja recuperar.

curl -X GET \
”$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"

Recuperando detalhes da imagem customizada usando o Terraform

É possível visualizar os detalhes de uma imagem customizada, como nome e ID, sistema operacional e versão, status de criptografia, data de descontinuação ou obsolescência e grupo de recursos designado, usando o Terraform.

Para visualizar os detalhes de uma imagem usando o Terraform, use o comando de origem de dados do Terraform ibm_is_images Para a variável name, especifique o nome da imagem customizada que deseja recuperar.

data "ibm_is_images" "image_name" {
}

Compartilhando uma imagem customizada para um catálogo privado usando a UI

Você pode compartilhar uma imagem customizada IBM Cloud VPC customizada para um catálogo privado existente. Se você ainda não tem um catálogo privado, consulte Onboarding uma imagem de servidor virtual para VPC.

A ação Share image to private catalog não está disponível para as imagens a seguir:

• A imagem já foi compartilhada com um catálogo privado. Uma imagem em um catálogo privado pode existir em apenas uma versão dentro de uma oferta de produto em um catálogo privado. Você deve remover a imagem da versão em que ela está em primeiro antes que a imagem possa ser compartilhada em uma versão diferente.
• A imagem é criptografada.
• A imagem não é uma imagem x86.

Para compartilhar uma imagem customizada para um catálogo privado, complete as etapas a seguir.

1. No site IBM Cloud console, acesse o ícone “ Menu de navegação ” > Infraestrutura > Computação > Imagens.
2. Na guia Imagens customizadas clique no ícone Ações e selecione Compartilhar no catálogo.
3. Na página Compartilhar imagem para catálogo privado, selecione um Catálogo Privado a partir da lista de catálogos privados disponíveis.
4. Insira um número de versão em Versão de software.
5. Clique em Criar oferta de catálogo para compartilhar a imagem para o catálogo privado.
6. Depois que a imagem for criada, clique em Validar imagem.

Esse processo compartilha a imagem personalizada somente com o catálogo privado. O processo de validação ocorre dentro do catálogo privado. Clicar em Validar imagem leva você para uma nova página e a partir desta tela, você pode começar com Etapa 3: Validar a imagem do servidor virtual no Onboarding uma imagem do servidor virtual para VPC para concluir o processo de validação.

Compartilhando uma imagem customizada para um catálogo privado usando a CLI

Você pode compartilhar uma imagem personalizada somente em um catálogo privado em IBM Cloud VPC usando a interface do usuário. Para obter mais informações sobre a integração em um catálogo privado usando a CLI, consulte Software de integração em sua conta.

Compartilhando uma imagem customizada para um catálogo privado usando a API

Você pode compartilhar uma imagem personalizada somente em um catálogo privado em IBM Cloud VPC usando a interface do usuário. Para obter mais informações sobre a integração em um catálogo privado usando a API, consulte Software de integração em sua conta.

Compartilhando uma imagem customizada para um catálogo privado usando o Terraform

Você pode compartilhar uma imagem personalizada somente em um catálogo privado em IBM Cloud VPC usando a interface do usuário. Para obter mais informações sobre a integração em um catálogo privado usando o Terraform, consulte Software de integração em sua conta.

Agende uma alteração personalizada do status do ciclo de vida da imagem no console

É 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 É possível fazer uma mudança de status imediata apenas se você não tiver planejado uma mudança de status futura

Siga estas 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 menu de navegação > de infraestrutura > Computação > Imagens.
2. Na guia Imagens Customizadas, clique no ícone 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.

Siga estas 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 menu de navegação > de infraestrutura > Computação > Imagens.

2. Na guia Imagens Customizadas, clique no ícone 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.

Mude o status do ciclo de vida da imagem customizada usando a CLI

É possível mudar o status do ciclo de vida de uma imagem customizada IBM Cloud VPC usando a 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-obsoleto. 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.

Remover uma mudança de status do ciclo de vida da imagem customizada 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.

Mude o status do ciclo de vida da imagem customizada usando a API..

É possível mudar o status do ciclo de vida de uma imagem customizada IBM Cloud VPC usando 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..

Remova o status do ciclo de vida da imagem customizada planejada anteriormente 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 }'
  

Alterar o status do ciclo de vida da imagem personalizada usando o Terraform

Para fazer uma alteração imediata de status usando o Terraform, use o comando ibm_is_image_deprecate ou ibm_is_image_obsolete use um dos exemplos a seguir. Para a variável name, especifique o nome da imagem customizada para a mudança de status.

É possível fazer uma mudança de status imediata apenas 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 da imagem customizada planejada usando o Terraform. 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.

  resource "ibm_is_image" "example" {
    name               = "example-image"
    href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
    operating_system   = "ubuntu-16-04-amd64"
    encrypted_data_key = "eJxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx0="
    encryption_key     = "crn:v1:bluemix:public:kms:us-south:a/6xxxxxxxxxxxxxxx:xxxxxxx-xxxx-xxxx-xxxxxxx:key:dxxxxxx-fxxx-4xxx-9xxx-7xxxxxxxx"
  }
  resource "ibm_is_image_deprecate" "example" {
    image               = ibm_is_image.example.id
  }
  

• Altere o status de ciclo da imagem para obsolete.

  resource "ibm_is_image" "example" {
    name               = "example-image"
    href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
    operating_system   = "ubuntu-16-04-amd64"
    encrypted_data_key = "eJxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx0="
    encryption_key     = "crn:v1:bluemix:public:kms:us-south:a/6xxxxxxxxxxxxxxx:xxxxxxx-xxxx-xxxx-xxxxxxx:key:dxxxxxx-fxxx-4xxx-9xxx-7xxxxxxxx"
  }
  resource "ibm_is_image_obsolete" "example" {
    image               = ibm_is_image.example.id
  }
  

Para planejar uma mudança de status, use um dos exemplos a seguir:

Para o atributo 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 com quatro dígitos
• MM é o mês com dois dígitos
• DD é o dia de dois dígitos
• T separa as informações de data e hora
• hh é o horário de dois dígitos
• mm são os minutos com dois dígitos
• +hh:mm ou -hh:mm é o fuso horário do Tempo Universal Coordenado

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

Quando você agenda a data e a hora, não pode usar a data e a 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.

  resource "ibm_is_image" "example" {
    name               = "example-image"
    href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
    operating_system   = "ubuntu-16-04-amd64"
    deprecation_at     = "2023-11-28T15:10:00.000Z"
  }
  

• Planejar uma mudança de status para obsolete.

  resource "ibm_is_image" "example" {
    name               = "example-image"
    href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
    operating_system   = "ubuntu-16-04-amd64"
    obsolescence_at    = "2023-11-28T15:10:00.000Z"
  }
  

  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 com as novas datas e horas.

Remover o status do ciclo de vida da imagem personalizada agendada anteriormente usando o Terraform

Para remover qualquer mudança de status planejada, atualize os atributos deprecation_at ou obsolescence_at para null.. Essa mudança de atributo remove a data e a 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..

  resource "ibm_is_image" "example" {
    name               = "example-image"
    href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
    operating_system   = "ubuntu-16-04-amd64"
    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 atributo removerá o estado obsolete e o 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 atributo será movida de obsolete de volta para available.

  resource "ibm_is_image" "example" {
    name               = "example-image"
    href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
    operating_system   = "ubuntu-16-04-amd64"
    obsolescence_at    = null
  }
  

• Para alterar uma imagem que tenha as propriedades deprecation_at ou obsolescence_at configuradas novamente para available, deve-se atualizar os atributos deprecation_at ou obsolescence_at.

  resource "ibm_is_image" "example" {
    name               = "example-image"
    href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
    operating_system   = "ubuntu-16-04-amd64"
    deprecation_at     = null
    obsolescence_at    = null
  }