Como obter a `olm-utils-v4` imagem antes de executar os IBM Software Hub comandos de instalação em uma rede restrita (Atualização da versão 5.1 para a versão 5.3 )

Se o seu cluster estiver em uma rede restrita, certifique-se de que uma versão compatível da olm-utils-v4 imagem esteja instalada na estação de trabalho do cliente a partir da qual você executará os comandos de instalação. Recomenda-se a versão que corresponde à versão do IBM Software Hub que você está instalando.

Fase de atualização

Atualizando a estação de trabalho do cliente
Recolha das informações necessárias
Preparação para executar uma atualização em uma rede restrita
Preparando-se para executar uma atualização a partir de um registro privado de contêineres
Atualização do software pré-requisito
Atualização de componentes compartilhados do cluster
Preparando-se para atualizar uma instância
Atualização de uma instância

Quem precisa realizar essa tarefa?

Todos os administradores — administradores de cluster, administradores de registro e administradores de instância — devem realizar esta tarefa.

Até quando você precisa concluir essa tarefa?

Em uma rede restrita, é necessário garantir que a olm-utils-v4 imagem esteja instalada na estação de trabalho do cliente.

Você tem as seguintes opções para concluir esta tarefa:

Configuração única : Se você espelhar as imagens IBM Software Hub de software em um registro de contêineres privado, o administrador do registro poderá concluir essa tarefa antes de espelhar as imagens. Assim, outros usuários podem baixar a imagem do registro de contêineres privado.
Repita conforme necessário. Se você planeja baixar as imagens do IBM Entitled Registry, execute esta tarefa em cada estação de trabalho que será usada para realizar as tarefas de atualização.

Procedimento

As etapas a serem seguidas dependem se você pretende usar a mesma estação de trabalho na rede do cluster e qual imagem você tem permissão para usar:

Você planeja usar a mesma estação de trabalho dentro da rede do cluster

Siga as etapas correspondentes à sua licença:

olm-utils-v4

Todos IBM Software Hub os clientes têm o direito de usar a olm-utils-v4 imagem.

Quando a estação de trabalho estiver conectada à Internet, execute o seguinte comando para atualizar a olm-utils-v4 imagem na estação de trabalho:
```
cpd-cli manage restart-container
```
Aguarde até que o cpd-cli retorne as seguintes mensagens:
```
[SUCCESS] ... Successfully pulled the container image icr.io/cpopen/cpd/olm-utils-v4:${VERSION}
[SUCCESS] ... Successfully started the container olm-utils-play-v4
[SUCCESS] ... Container olm-utils-play-v4 has been re-created
```
A versão da olm-utils-v4 imagem deve ser a mesma da versão que IBM Software Hub você pretende instalar.

olm-utils-premium-v4

Premium: É necessário adquirir a IBM Software Hub Premium Cartridge licença para usar a olm-utils-premium-v4 imagem.

Defina a variável OLM_UTILS_IMAGE de ambiente de acordo com o hardware do seu cluster:

Clusters x86-64

export OLM_UTILS_IMAGE=cp.icr.io/cp/cpd/olm-utils-premium-v4:${VERSION}.amd64

ppc64le agrupamentos

export OLM_UTILS_IMAGE=cp.icr.io/cp/cpd/olm-utils-premium-v4:${VERSION}.ppc64le

s390x agrupamentos

export OLM_UTILS_IMAGE=cp.icr.io/cp/cpd/olm-utils-premium-v4:${VERSION}.s390x

Quando a estação de trabalho estiver conectada à Internet, execute o seguinte comando para verificar se o cpd-cli está usando a olm-utils-premium-v4 imagem:

cpd-cli manage restart-container

Aguarde até que o cpd-cli retorne as seguintes mensagens:

[SUCCESS] ... Successfully pulled the container image cp.icr.io/cp/cpd/olm-utils-premium-v4:${VERSION}.${IMAGE_ARCH}
[SUCCESS] ... Successfully started the container olm-utils-play-v4
[SUCCESS] ... Container olm-utils-play-v4 has been re-created

Você planeja usar uma estação de trabalho diferente dentro da rede do cluster

Antes de iniciar: É necessário ter o cpd-cli instalado em uma estação de trabalho na rede do cluster

Sobre esta tarefa

Todos IBM Software Hub os clientes têm o direito de usar a olm-utils-v4 imagem.

Você deve adquirir a IBM Software Hub Premium Cartridge licença para usar a olm-utils-premium-v4 imagem.

A partir de um computador com acesso à Internet:
1. Certifique-se de que Docker ou Podman esteja em execução na estação de trabalho.
2. Execute o comando apropriado para salvar a olm-utils-v4 imagem olm-utils-premium-v4 na estação de trabalho do cliente.
  olm-utils-v4
  Clusters x86-64
  
  cpd-cli manage save-image \ --from=icr.io/cpopen/cpd/olm-utils-v4:${VERSION}.amd64
  
  Este comando salva a imagem como um arquivo TAR compactado chamado icr.io_cpd_olm-utils-v4_${VERSION}.amd64.tar.gz no cpd-cli-workspace/olm-utils-workspace/work/offline diretório.
  
  ppc64le agrupamentos
  
  cpd-cli manage save-image \ --from=icr.io/cpopen/cpd/olm-utils-v4:${VERSION}.ppc64le
  
  Este comando salva a imagem como um arquivo TAR compactado chamado icr.io_cpopen_cpd_olm-utils-v4_${VERSION}.ppc64le.tar.gz no cpd-cli-workspace/olm-utils-workspace/work/offline diretório.
  
  s390x agrupamentos
  
  cpd-cli manage save-image \ --from=icr.io/cpopen/cpd/olm-utils-v4:${VERSION}.s390x
  
  Este comando salva a imagem como um arquivo TAR compactado chamado icr.io_cpopen_cpd_olm-utils-v4_${VERSION}.s390x.tar.gz no cpd-cli-workspace/olm-utils-workspace/work/offline diretório.
  olm-utils-premium-v4
  Clusters x86-64
  
  cpd-cli manage save-image \ --from=cp.icr.io/cp/cpd/olm-utils-premium-v4:${VERSION}.amd64
  
  Este comando salva a imagem como um arquivo TAR compactado chamado cp.icr.io_cp_cpd_olm-utils-premium-v4_${VERSION}.amd64.tar.gz no cpd-cli-workspace/olm-utils-workspace/work/offline diretório.
  
  ppc64le agrupamentos
  
  cpd-cli manage save-image \ --from=cp.icr.io/cp/cpd/olm-utils-premium-v4:${VERSION}.ppc64le
  
  Este comando salva a imagem como um arquivo TAR compactado chamado cp.icr.io_cp_cpd_olm-utils-premium-v4_${VERSION}.ppc64le.tar.gz no cpd-cli-workspace/olm-utils-workspace/work/offline diretório.
  
  s390x agrupamentos
  
  cpd-cli manage save-image \ --from=cp.icr.io/cp/cpd/olm-utils-premium-v4:${VERSION}.s390x
  
  Este comando salva a imagem como um arquivo TAR compactado chamado cp.icr.io_cp_cpd_olm-utils-premium-v4_${VERSION}.s390x.tar.gz no cpd-cli-workspace/olm-utils-workspace/work/offline diretório.
Transfira o arquivo compactado para uma estação de trabalho do cliente que possa se conectar ao cluster.
Certifique-se de colocar o TAR arquivo no work/offline diretório:

olm-utils-v4

Clusters x86-64

icr.io_cpd_olm-utils-v4_${VERSION}.amd64.tar.gz

ppc64le agrupamentos

icr.io_cpopen_cpd_olm-utils-v4_${VERSION}.ppc64le.tar.gz

s390x agrupamentos

icr.io_cpopen_cpd_olm-utils-v4_${VERSION}.s390x.tar.gz

olm-utils-premium-v4

Clusters x86-64

cp.icr.io_cp_cpd_olm-utils-premium-v4_${VERSION}.amd64.tar.gz

ppc64le agrupamentos

cp.icr.io_cp_cpd_olm-utils-premium-v4_${VERSION}.ppc64le.tar.gz

s390x agrupamentos

cp.icr.io_cp_cpd_olm-utils-premium-v4_${VERSION}.s390x.tar.gz

A partir da estação de trabalho que pode se conectar ao cluster:

Certifique-se de que Docker ou Podman esteja em execução na estação de trabalho.

Execute o comando apropriado para carregar a olm-utils-v4 imagem olm-utils-premium-v4 na estação de trabalho do cliente:

olm-utils-v4

Clusters x86-64

cpd-cli manage load-image \
--source-image=icr.io/cpopen/cpd/olm-utils-v4:${VERSION}.amd64