Extracción de gráficos de otro registro o repositorio de Helm

Puedes descargar un gráfico desde cualquier fuente de registroServicio de almacenamiento y distribución que contiene imágenes públicas o privadas que se utilizan para crear contenedores. privada o pública, o desde un repositorio de Helm, a tu ordenador y, a continuación, etiquetarlo para utilizarlo más adelante en IBM Cloud Container Registry.

Antes de empezar, complete las siguientes tareas.

• Instale la interfaz de comando(CLI)Container Registry para trabajar con su espacio de nombres.
• Configure su propio espacio de nombres en IBM Cloud Container Registry.
• Instala la última versión de la CLI de Helm para trabajar con gráficos.

1. Descargue el gráfico de Helm en el sistema local.

   • Descargue el gráfico Helm del registro OCI:

       helm pull oci://REGISTRY/MY_NAMESPACE/CHART_NAME --version CHART_VERSION
       ```
   
       Ejemplo, donde `REGISTRY` es `localhost:5000`, `MY_NAMESPACE` es `helm-charts`, `CHART_NAME` es `mychart` y `CHART_VERSION` es `0.1.0`:
   
       ```sh {: pre}
       helm pull oci://localhost:5000/helm-charts/mychart --version 0.1.0
       ```
   - Descargue el gráfico Helm de un repositorio Helm:
   
   ```sh
       helm pull [CHART_URL | REPO/CHART_NAME] --version CHART_VERSION
       ```
   
       Ejemplo, donde `REPO/CHART_NAME` es `ibm-charts/ibm-istio` y `CHART_VERSION` es `1.2.2`.
   
       Puede añadir el alias del repositorio utilizando el comando [`helm repo add`](https://helm.sh/docs/helm/helm_repo_add/){: external} comando
       {: tip}
   
       ```sh {: pre}
       helm pull ibm-charts/ibm-istio  --version 1.2.2
       ```
   Si obtiene un mensaje `unauthorized: authentication required` o `denied: requested access to the resource is denied`, ejecute el mandato [`ibmcloud cr login`](/docs/Registry?topic=Registry-containerregcli#bx_cr_login).
   {: tip}
   
   

Después de extraer un gráfico para el espacio de nombres, puede cargar (enviar) el gráfico desde el sistema local al espacio de nombres.

Enviar gráficos de Helm al espacio de nombres

Puede enviar (cargar) un gráfico desde su ordenador a su espacio de nombres en IBM Cloud Container Registry para almacenar su gráfico y compartirlo con otros usuarios.

Antes de empezar, complete las siguientes tareas.

• Instale la CLI para trabajar con el espacio de nombres.
• Configure su propio espacio de nombres en IBM Cloud Container Registry.
• Instala la última versión de la CLI de Helm para trabajar con gráficos.
• Extrae o crea un gráfico en tu ordenador local. Si crea un gráfico, debe guardarlo como archivo mediante el comando helm package comando.

Para cargar (enviar) un gráfico, realice los pasos siguientes:

1. Inicie sesión en la CLI ejecutando el siguiente comando, donde DOMAIN es el nombre de dominio y el nombre de usuario (-u) se establece en iamapikey. Para saber más sobre los nombres de dominio, consulte Regiones.

   helm registry login DOMAIN -u iamapikey
   

   A continuación, el comando le pedirá que introduzca la contraseña, que es la clave de API de IAM.

   Debe iniciar sesión si extrae un gráfico de su IBM Cloud Container Registry privado.

2. Para ver todos los espacios de nombres que están disponibles en la cuenta, ejecute el mandato ibmcloud cr namespace-list.

3. Cargue el gráfico al espacio de nombres.

   helm push MY_CHART_PACKAGE oci://REGION.icr.io/MY_NAMESPACE
   

   Ejemplo, donde MY_CHART_PACKAGE es mychart-0.1.0.tgz, REGION es uk y MY_NAMESPACE es helm-charts:

   helm push mychart-0.1.0.tgz oci://uk.icr.io/helm-charts
   

   Si obtiene el mensaje unauthorized: authentication required o el mensaje denied: requested access to the resource is denied, ejecute el mandato ibmcloud cr login.

Después de enviar el gráfico a IBM Cloud Container Registry, puede instalar el gráfico de Helm en el clúster en IBM Cloud Kubernetes Service.

Copiar gráficos entre registros

Puedes copiar gráficos entre registros extrayendo un gráfico de un registro de una región y enviándolo a un registro de otra región, de modo que puedas compartir el gráfico con usuarios de ambas regiones.

Antes de empezar, complete las siguientes tareas.

• Instale la CLI para trabajar con el espacio de nombres.
• Configure su propio espacio de nombres en IBM Cloud Container Registry.
• Instala la última versión de la CLI de Helm para trabajar con gráficos.

Para copiar un gráfico entre dos registros, realice los pasos siguientes:

1. Extraer un gráfico de un registro.
2. Enviar el gráfico a otro registro. Asegúrate de utilizar el nombre de dominio correcto para la nueva región a la que te diriges.

Después de copiar el gráfico, puede instalar el gráfico de Helm en el clúster en IBM Cloud Kubernetes Service.

Instalación de un gráfico de Helm en el clúster

Puede instalar un gráfico de Helm en el clúster en IBM Cloud Kubernetes Service directamente desde el registro. Siga las instrucciones del gráfico de Helm README y utilice la referencia de registro completa al gráfico y a la versión de gráfico para la instalación.

helm install RELEASE_NAME oci://REGION.icr.io/MY_NAMESPACE/CHART_NAME --version CHART_VERSION

Ejemplo, donde RELEASE_NAME es myrelease, REGION es uk, MY_NAMESPACE es helm-charts, CHART_NAME es mychart y CHART_VERSION es 0.1.0:

helm install myrelease oci://uk.icr.io/helm-charts/mychart --version 0.1.0

Supresión de gráficos del repositorio privado en la CLI

Puede suprimir gráficos no deseados y todas sus etiquetas del repositorio privado de IBM Cloud utilizando la CLI.

La supresión de un gráfico que está siendo utilizado por un despliegue existente puede hacer que una actualización, retrotracción o supresión de Helm falle.

Si desea restaurar un gráfico suprimido, puede listar el contenido de la papelera ejecutando el mandato ibmcloud cr trash-list y restaurar un gráfico seleccionado ejecutando el mandato ibmcloud cr image-restore.

Para suprimir un gráfico utilizando la CLI, realice los pasos siguientes:

1. Inicie sesión en IBM Cloud con el mandato ibmcloud login.

2. Para suprimir un gráfico, ejecute el mandato siguiente, donde CHART es el nombre del gráfico que desea eliminar, en el formato repository@digest o repository:tag. A diferencia de las imágenes, debe especificarse una etiqueta porque la etiqueta latest no existe porque una etiqueta siempre debe coincidir con la versión semántica del gráfico. Puede suprimir varios gráficos especificando cada vía de acceso de registro de IBM Cloud privada en el mandato con un espacio entre cada vía de acceso.

   ibmcloud cr image-rm CHART
   

   Para encontrar los nombres de los gráficos, ejecute ibmcloud cr image-list. El registro almacena distintos tipos de artefacto que incluyen gráficos de Helm e imágenes de contenedor. Combine el contenido de la columna Repositorio (repository) y la columna Etiqueta (tag) separados por dos puntos (:) para crear el nombre de imagen en el formato repository:tag. Para identificar el gráfico por resumen, ejecute el mandato ibmcloud cr image-digests. Combine el contenido de la columna Repositorio (repository) y la columna Resumen (digest) separados por un símbolo en (@) para crear el nombre de imagen en el formato repository@digest.

3. Verifique que el gráfico se haya suprimido ejecutando el mandato siguiente y compruebe que el diagrama no se muestre en la lista.

   ibmcloud cr image-list
   

Cómo eliminar gráficos de tu repositorio privado en la consola de IBM Cloud

Puede suprimir gráficos no deseados y todas sus etiquetas del repositorio de IBM Cloud privado utilizando la consola de IBM Cloud.

La supresión de un gráfico que está siendo utilizado por un despliegue existente puede hacer que una actualización, retrotracción o supresión de Helm falle.

Si desea restaurar un gráfico suprimido, puede listar el contenido de la papelera ejecutando el mandato ibmcloud cr trash-list y restaurar un gráfico seleccionado ejecutando el mandato ibmcloud cr image-restore.

Para suprimir un gráfico utilizando la consola de IBM Cloud, realice los pasos siguientes.

1. Inicia sesión en la consola de IBM Cloud https://cloud.ibm.com/login con tu IBMid.
2. Si tiene varias cuentas de IBM Cloud, seleccione la cuenta y la región que desea utilizar en el menú de cuenta.
3. Pulse el icono Menú de navegación y, a continuación, pulse Container Registry.
4. Pulse Imágenes. Se muestra una lista de los gráficos (y las imágenes, si existen). El registro almacena distintos tipos de artefacto que incluyen gráficos de Helm e imágenes de contenedor.
5. En la fila que contiene el gráfico que desea suprimir, seleccione el recuadro de selección.
6. Pulse Suprimir imagen.

Restauración de gráficos por resumen

Cuando se restaura un gráfico por resumen, el resumen se mueve de la papelera al repositorio activo y se restauran todas las etiquetas para ese resumen en el repositorio.

Para restaurar un gráfico mediante un resumen de la papelera, realice los pasos siguientes:

1. Inicie sesión en IBM Cloud con el mandato ibmcloud login.

2. Liste los gráficos de la papelera ejecutando el mandato siguiente.

   ibmcloud cr trash-list
   

   Se visualiza una tabla que muestra los elementos de la papelera. La tabla muestra el resumen, los días hasta la caducidad y las etiquetas de ese resumen.

3. Anote el resumen del gráfico que desea restaurar.

4. Ejecute el mandato siguiente para restaurar el gráfico en el repositorio. Donde DNS es el nombre de dominio, NAMESPACE es el espacio de nombres, REPO es el repositorio y DIGEST es el resumen del gráfico que desea restaurar.

   ibmcloud cr image-restore DNS/NAMESPACE/REPO@DIGEST
   

   Si algunas etiquetas no se restauran, consulta ¿Por qué no se restauran todas las etiquetas cuando realizo una restauración por resumen? para obtener ayuda.

   En el repositorio activo, puede extraer el gráfico por resumen. Si ejecuta el mandato ibmcloud cr image-digests, el gráfico se muestra en la salida.

Restauración de gráficos por etiqueta

Cuando se restaura un gráfico por etiqueta, sólo se mueve la etiqueta específica de la papelera al repositorio activo.

Para restaurar un gráfico por etiqueta desde la papelera, realice los pasos siguientes.

1. Inicie sesión en IBM Cloud con el mandato ibmcloud login.

2. Liste los gráficos de la papelera ejecutando el mandato siguiente.

   ibmcloud cr trash-list
   

   Se visualiza una tabla que muestra los elementos de la papelera. La tabla muestra el resumen, los días hasta la caducidad y las etiquetas de ese resumen.

3. Para el gráfico que desea restaurar, anote el resumen hasta, pero sin incluir, el signo de arroba (@). Esta parte del resumen es DNS/NAMESPACE/REPO, donde DNS es el nombre de dominio, NAMESPACE es el espacio de nombres y REPO es el repositorio.

4. Para el gráfico que quieras restaurar, toma nota de la etiqueta TAG.

5. Ejecute el mandato siguiente para restaurar el gráfico en el repositorio, donde DNS/NAMESPACE/REPO es el nombre del gráfico que desea restaurar y TAG es el código.

   ibmcloud cr image-restore DNS/NAMESPACE/REPO:TAG
   

   En el repositorio activo, puede extraer el gráfico por etiqueta.

   Si ejecuta el mandato ibmcloud cr trash-list, el resumen y otras etiquetas aparecerán en la salida, pero la etiqueta ya no se visualizará.