Reflejar imágenes directamente en el registro de contenedores privado (Actualización de la versión 5.1 a la versión 5.3 )

Si la estación de trabajo de su cliente puede conectarse a Internet y al registro de contenedores privado, puede duplicar las imágenes directamente en su registro de contenedores privado.

Si la estación de trabajo de su cliente no puede conectarse a Internet ni al registro de contenedores privado, consulte Duplicar imágenes mediante un registro de contenedores intermediario.

Fase de actualización

Actualización de la estación de trabajo del cliente
Recopilación de la información necesaria
Preparación para ejecutar una actualización en una red restringida
Preparación para ejecutar una actualización desde un registro de contenedores privado
Actualización del software necesario
Actualización de componentes compartidos del clúster
Preparación para actualizar una instancia
Actualización de una instancia

¿Quién debe completar esta tarea?

Administrador del registro Un administrador del registro o un usuario con permisos para enviar imágenes al registro de contenedores privado debe completar esta tarea.

¿Cuándo necesitas completar esta tarea?

Si extrae imágenes de un registro de contenedores privado, debe completar esta tarea antes de actualizar IBM® Software Hub.

Si tiene varias instancias de IBM Software Hub en su clúster, puede:

Configuración única Minimice el número de veces que duplica las imágenes de software mediante:
1. Identificar todas las instancias de IBM Software Hub en el clúster.
2. Identificar todos los componentes que están instalados en cada instancia.
3. Especificar todos los componentes para todas las instancias al duplicar las imágenes.
Repita según sea necesario Refleje las imágenes para una instancia a la vez.

Antes de empezar

Práctica recomendada: puede ejecutar los comandos de esta tarea tal y como están escritos utilizando las variables de entorno de instalación. Asegúrate de haber añadido las nuevas variables de entorno desde Actualizar tu script de variables de entorno.

Además, asegúrese de obtener las variables de entorno antes de ejecutar los comandos de esta tarea.

Antes de reflejar las imágenes en el registro de contenedores privado:

Asegúrate de tener suficiente espacio para las imágenes que planeas duplicar. Para obtener información sobre los tamaños aproximados de las imágenes, consulte Requisitos de hardware.
Si planea instalar un servicio con una dependencia del componente Inference foundation models (ibm-watsonx-ai-ifm):
1. Asegúrese de que Skopeo está instalado en la estación de trabajo del cliente:
```
yum install skopeo
```
2. Asegúrate de tener tu Red Hat® nombre de usuario y contraseña. (Las credenciales que utiliza para autenticarse en https://access.redhat.com)
3. Establezca la REDHAT_ACCESS_USERNAME variable de entorno con su Red Hat nombre de usuario:
```
export REDHAT_ACCESS_USERNAME=<username>
```
4. Establezca la REDHAT_ACCESS_PASSWORD variable de entorno con la contraseña asociada a su Red Hat nombre de usuario:
```
export REDHAT_ACCESS_PASSWORD=<password>
```

Acerca de esta tarea

Utilice los cpd-cli manage comandos para duplicar las imágenes del registro IBM Entitled Registry de contenedores privado.

Los siguientes pasos asumen que las siguientes afirmaciones son ciertas:

Reflejará todos los componentes en un solo paso.
Los componentes que se reflejan se determinan mediante la ${COMPONENTS} variable, desde el script de variables de entorno de instalación.

Si desea duplicar un componente específico en lugar de varios componentes, puede exportarlo COMPONENTS con el ID de componente adecuado.
Identificaste los modelos o imágenes opcionales que necesitas duplicar
Los modelos y las imágenes opcionales que se reflejan se determinan mediante la ${IMAGE_GROUPS} variable, desde el script de variables de entorno de instalación.

Si no necesita duplicar ningún modelo o imagen opcional, ejecute los comandos que no incluyen la ${IMAGE_GROUPS} variable.

Procedimiento

Inicie sesión en el IBM Entitled Registry registro:

cpd-cli manage login-entitled-registry \
${IBM_ENTITLEMENT_KEY}

Inicie sesión en el registro privado de contenedores.
El siguiente comando asume que está utilizando un registro de contenedores privado protegido con credenciales:
```
cpd-cli manage login-private-registry \
${PRIVATE_REGISTRY_LOCATION} \
${PRIVATE_REGISTRY_PUSH_USER} \
${PRIVATE_REGISTRY_PUSH_PASSWORD}
```
Si su registro privado no es seguro, omita los siguientes argumentos:
- ${PRIVATE_REGISTRY_PUSH_USER}
- ${PRIVATE_REGISTRY_PUSH_PASSWORD}
Confirma que tienes acceso a las imágenes que deseas duplicar desde IBM Entitled Registry:
1. Inspeccione el IBM Entitled Registry.
  Consejo: Si desea comprobar que tiene acceso a las imágenes de un componente específico, puede ejecutar el siguiente comando antes de ejecutar el list-images comando:
```
export COMPONENTS=<component-ID>
```
  Ejecute el comando adecuado para su entorno:
  Ya tienes los paquetes CASE en la estación de trabajo del cliente
  
  cpd-cli manage list-images \ --components=${COMPONENTS} \ --release=${VERSION} \ --inspect_source_registry=true
  Descargue los paquetes « CASE » (Complemento de control de eventos) desde GitHub ( github.com/IBM )
  
  cpd-cli manage list-images \ --components=${COMPONENTS} \ --release=${VERSION} \ --inspect_source_registry=true
  Descargue los paquetes « CASE » del repositorio « IBM Cloud Pak » de Open Container Initiative
  
  cpd-cli manage list-images \ --components=${COMPONENTS} \ --release=${VERSION} \ --inspect_source_registry=true \ --from_oci=true
  El resultado se guarda en el list_images.csv archivo del work/offline/${VERSION} directorio.
2. Comprueba si hay errores en la salida:
```
grep "level=fatal" list_images.csv
```
  El comando devuelve imágenes que han fallado debido a errores de autorización o errores de red.
EDB Postgres Standard Solo para usuarios. Si ha adquirido EDB Postgres Standard, ejecute el siguiente comando para eliminar las EDB Postgres Enterprise imágenes de la lista de imágenes que se replicarán en el registro de contenedores privado:
Estaciones de trabajo que utilizan el directorio cpd-cli-workspace/olm-utils-workspace/work predeterminado
```
sed -i -e '/edb-postgres-advanced/d' ./cpd-cli-workspace/olm-utils-workspace/work/offline/${VERSION}/.ibm-pak/data/cases/ibm-cpd-edb/*/ibm-cpd-edb-*-images.csv
```
Estaciones de trabajo que utilizan la variable CPD_CLI_MANAGE_WORKSPACE de entorno
```
sed -i -e '/edb-postgres-advanced/d' ${CPD_CLI_MANAGE_WORKSPACE}/work/offline/${VERSION}/.ibm-pak/data/cases/ibm-cpd-edb/*/ibm-cpd-edb-*-images.csv
```
Watson Studio Solo para usuarios. Si está duplicando las imágenes para Watson Studio, puede eliminar las siguientes imágenes si no las necesita:
Imágenes de GPU

Las imágenes de la GPU se reflejan de forma predeterminada. Si no necesita imágenes GPU, ejecute el siguiente comando para eliminarlas:
Estaciones de trabajo que utilizan el directorio cpd-cli-workspace/olm-utils-workspace/work predeterminado
sed -i -e '/gpu/d' ./cpd-cli-workspace/olm-utils-workspace/work/offline/${VERSION}/.ibm-pak/data/cases/ibm-wsl-runtimes/*/ibm-wsl-runtimes-*-images.csv
Estaciones de trabajo que utilizan la variable CPD_CLI_MANAGE_WORKSPACE de entorno
sed -i -e '/gpu/d' ${CPD_CLI_MANAGE_WORKSPACE}/work/offline/${VERSION}/.ibm-pak/data/cases/ibm-wsl-runtimes/*/ibm-wsl-runtimes-*-images.csv
Modelos de PLN preentrenados

Las imágenes NLP preentrenadas se reflejan de forma predeterminada. Si no necesita modelos de procesamiento del lenguaje natural (NLP) preentrenados, ejecute el siguiente comando para eliminarlos:
Estaciones de trabajo que utilizan el directorio cpd-cli-workspace/olm-utils-workspace/work predeterminado
sed -i -e '/nlp/d' ./cpd-cli-workspace/olm-utils-workspace/work/offline/${VERSION}/.ibm-pak/data/cases/ibm-wsl-runtimes/*/ibm-wsl-runtimes-*-images.csv
Estaciones de trabajo que utilizan la variable CPD_CLI_MANAGE_WORKSPACE de entorno
sed -i -e '/nlp/d' ${CPD_CLI_MANAGE_WORKSPACE}/work/offline/${VERSION}/.ibm-pak/data/cases/ibm-wsl-runtimes/*/ibm-wsl-runtimes-*-images.csv
Refleje las imágenes en el registro de contenedores privado.
Consejo: Determina si necesitas modificar el comportamiento de este comando:
- De forma predeterminada, este comando solo refleja las imágenes que son necesarias para la arquitectura de su clúster. Si desea duplicar las imágenes para todas las arquitecturas compatibles, elimine la --arch=${IMAGE_ARCH} opción.
- Este comando duplica las imágenes de todos los componentes especificados en la variable ${COMPONENTS} de entorno. Si desea duplicar imágenes para un componente específico, puede ejecutar export COMPONENTS=<component-ID> antes de ejecutar el comando.
Es necesario reflejar modelos o imágenes opcionales
```
cpd-cli manage mirror-images \
--components=${COMPONENTS} \
--groups=${IMAGE_GROUPS} \
--release=${VERSION} \
--target_registry=${PRIVATE_REGISTRY_LOCATION} \
--arch=${IMAGE_ARCH} \
--case_download=false
```
No es necesario duplicar modelos o imágenes opcionales
```
cpd-cli manage mirror-images \
--components=${COMPONENTS} \
--release=${VERSION} \
--target_registry=${PRIVATE_REGISTRY_LOCATION} \
--arch=${IMAGE_ARCH} \
--case_download=false
```
Para cada componente, el comando genera un archivo de registro en el work directorio.
Consejo: Ejecute el siguiente comando para imprimir cualquier error en los archivos de registro:
```
grep "error" mirror_*.log
```
Confirme que las imágenes se hayan reflejado en el registro de contenedores privado:
1. Inspeccione el contenido del registro de contenedores privado:
```
cpd-cli manage list-images \
--components=${COMPONENTS} \
--release=${VERSION} \
--target_registry=${PRIVATE_REGISTRY_LOCATION} \
--case_download=false
```
  El resultado se guarda en el list_images.csv archivo del work/offline/${VERSION} directorio.
2. Comprueba si hay errores en la salida:
```
grep "level=fatal" list_images.csv
```
  El comando devuelve imágenes que faltan o que no se pueden inspeccionar.

Si planea instalar un servicio con una dependencia del componente Inference foundation models (ibm-watsonx-ai-ifm), copie las imágenes vLLM necesarias al registro de contenedores privado.

Las imágenes que refleje dependerán de los modelos que tenga previsto instalar.

Modelos de Mistral AI

Si planea instalar cualquiera de los siguientes Mistral AI modelos, debe duplicar la imagen requerida vLLM desde el IBM Entitled Registry:

codestral-22b
codestral-2501
ministral-8b-instruct
mistral-large
mistral-large-instruct-2411
mistral-small-instruct
pixtral-large-instruct-2411

skopeo copy --all \
--src-username cp \
--src-password ${IBM_ENTITLEMENT_KEY} \
--src-tls-verify=false \
--dest-username ${PRIVATE_REGISTRY_PUSH_USER} \
--dest-password ${PRIVATE_REGISTRY_PUSH_PASSWORD} \
--dest-tls-verify=false \
docker://cp.icr.io/cp/cpd/vllm@sha256:cc95bc7619549a5fb9342f8c41c613df5cd65b4e1f90b408db062559a2fdcff9 \
docker://${PRIVATE_REGISTRY_LOCATION}/cp/cpd/vllm@sha256:cc95bc7619549a5fb9342f8c41c613df5cd65b4e1f90b408db062559a2fdcff9

Todos los demás modelos

Para todos los demás modelos, debe duplicar la imagen CUDA RHOAI vLLM desde registry.redhat.io:

Iniciar sesión en registry.redhat.io:

skopeo login registry.redhat.io \
--username ${REDHAT_ACCESS_USERNAME} \
--password ${REDHAT_ACCESS_PASSWORD}

Copie la imagen a su registro de contenedores privado:

skopeo copy --all \
--dest-username ${PRIVATE_REGISTRY_PUSH_USER} \
--dest-password ${PRIVATE_REGISTRY_PUSH_PASSWORD} \
docker://registry.redhat.io/rhoai/odh-vllm-cuda-rhel9@sha256:fb84fbf103bf450ef5b060fc5f21a9cf16b166dba207a3c50aa91bccd919d604 \
docker://${PRIVATE_REGISTRY_LOCATION}/rhoai/odh-vllm-cuda-rhel9@sha256:fb84fbf103bf450ef5b060fc5f21a9cf16b166dba207a3c50aa91bccd919d604

Resultados

Las imágenes para su arquitectura se reflejan en el registro de contenedores privado.

Nota: Algunos componentes, como el cpfs componente, solo proporcionan imágenes multiarch. En el caso de los componentes con imágenes multiarquitectura, todas las imágenes se replican en el registro de contenedores privado.

Qué hacer a continuación

Ahora que ha duplicado las imágenes en su registro de contenedores privado, está listo para completar la extracción de la imagen olm-utils-v4 del registro de contenedores privado (actualización de la versión 5.1 a la versión 5.3 ).