Incorporación de software a su catálogo privado

El proceso para incorporar el software incluye la importación de una versión al catálogo privado, la configuración de los detalles de despliegue, la configuración de los requisitos de licencia y la validación de que la versión se puede instalar correctamente en la infraestructura de destino que necesita.

Antes de empezar

  1. Sube tu código fuente a una versión de tu repositorio de GitHub,, GitLab, o Azure. Para más información, ver Configurando su repositorio de código fuente.

  2. Verifique que está utilizando una cuenta de Pago según uso o Suscripción. Consulte Visualización del tipo de cuenta si necesita más información.

  3. Asegúrese de que tiene asignado el rol de editor sobre el servicio de gestión de catálogos. Consulte Asignación de acceso a los servicios de gestión de cuentas.

  4. Configure el entorno de prueba que se ha creado anteriormente para usted:

Importación de una versión a su catálogo privado

Efectúe los pasos siguientes para importar una versión del software en su catálogo privado. El catálogo privado se ha creado para usted como parte de la Configuración para vender software.

  1. En la consola de IBM Cloud, pulse el icono Menú de navegación icono Menú de navegación > Partner Center > Mis productos.

  2. Seleccione el producto que va a incorporar.

  3. En el separador Software, pulse Importar una versión.

  4. Seleccione el método de despliegue.

  5. Seleccione si va a añadir el producto desde un repositorio privado o público. Para los operadores, seleccione el repositorio de origen y, a continuación, seleccione un repositorio privado o público.

  6. Especifique el URL de origen.

    Puede revisar la siguiente lista de formatos soportados por tipo de software:

    • Diagrama de Helm: https://raw.githubusercontent.com/IBM/charts/master/repo/ibm-helm
    • Operador Node-RED: https://github.com/IBM-Cloud/operator-bundle-sample/archive/refs/tags/v0.0.3.tar.gz
    • Paquete de operadores de un registro de « Red Hat OpenShift on IBM Cloud »: Por ejemplo, selecciona el paquete « Akka Cluster Operator » de la lista de operadores disponibles en el repositorio «Certified».
    • Imagen OVA: https://github.com/gcatalog/OVA-sample/blob/main/ova-sample.yaml
    • Plantilla de Terraform: https://github.com/IBM-Cloud/terraform-sample/archive/refs/tags/v1.1.0.tar.gz
    • Imagen de servidor virtual con Terraform: https://github.com/IBM-Cloud/isv-vsi-product-deploy-sample/releases/download/v1.0/isv-vsi-product-deploy-sample.tar.gz
    • Imagen de servidor virtual para VPC: seleccione una imagen de la lista de imágenes disponibles que se han importado en la VPC, o importe una imagen nueva a la cuenta.

    Una imagen de servidor virtual para VPC solo se puede añadir a un producto dentro de un catálogo privado a la vez. Si la imagen de servidor virtual que desea importar ya está importada en otro producto, debe eliminar la imagen de ese producto o suprimir el producto antes de añadir la imagen de servidor virtual a un nuevo producto.

    Si va a añadir el producto desde un repositorio privado, puede proporcionar una señal de acceso personal o puede utilizar un secreto. En lugar de dar a los usuarios una señal de acceso personal, puede darles acceso a un secreto, añadir la señal a un secreto y gestionar de forma centralizada todas las señales y el acceso que permite el secreto.

    Si su software se encuentra en GitLab,, debe utilizar un token de acceso personal, ya que GitLab no admite la descarga de versiones utilizando tokens de acceso al proyecto. Puede crear un token de acceso personal con el permiso " read_api " necesario siguiendo las instrucciones aquí.

    • Si utiliza una señal de acceso personal, seleccione No para indicar que no utiliza un secreto y proporcione su señal de acceso personal.
    • Si utiliza un secreto, seleccione y pulse Seleccionar desde Secrets Manager. Seleccione su instancia de servicio, grupo de secretos y secreto. Si no ve el secreto, compruebe que esté utilizando el grupo de secretos y la instancia de servicio correctos.

    Puede que aparezca el mensaje No service instance available si no ha creado ningún secreto o si no tiene el acceso correcto para utilizar secretos, aunque tenga instancias de servicio creadas.

  7. Si procede, establezca el destino de despliegue y añada la versión de software.

  8. Pulse Añadir versión.

Configuración de los detalles de la versión

  1. En la lsta de versiones, pulse la fila que contiene el software.
  2. Revise los detalles de la versión y pulse Siguiente.
  3. En función del tipo de software, es posible que deba seguir pasos adicionales, incluyendo el establecimiento de valores de despliegue.
  4. Pulse Siguiente.

Establecer valores de despliegue

Si es aplicable a su tipo de software, puede establecer valores de despliegue que los usuarios deben especificar cuando instalan el software. Puede añadir nuevos valores de despliegue o importar valores de despliegue de una versión existente.

Añadir nuevos valores de despliegue

  1. Pulse Configurar versión > Siguiente.
  2. Pulse Añadir valores de despliegue.
  3. En la tabla, seleccione Parámetro > Añadir para seleccionar y añadir todas las opciones.
  4. Si es necesario, puede personalizar los parámetros seleccionándolos en la tabla y pulsando Editar.

Importar valores existentes

Sigue estos pasos si ya has configurado valores de implementación para una versión existente y deseas importar dichos valores a tu versión actual.

Los valores importados no sustituyen ningún valor de despliegue que ya haya añadido a la versión actual.

  1. Pulse Configurar versión > Siguiente.
  2. Pulse Añadir valores de despliegue.
  3. Haz clic en « Importar valores de una versión anterior »
  4. Seleccione la versión que contiene los valores que desea importar.
  5. Haga clic en Importar.
  6. Si es necesario, puede personalizar los parámetros seleccionándolos en la tabla y pulsando Editar.

Editar descripciones de valores de salida

Puede mejorar las descripciones de los valores de salida de la plantilla de Terraform para ayudar a los usuarios a comprender mejor la finalidad de los parámetros. La descripción de cualquier valor de salida que incluya en la plantilla se puede actualizar.

Para añadir valores de salida, debe incluirlos en una nueva versión importada de la plantilla de Terraform.

Realice los pasos siguientes para editar las descripciones de valores de salida del producto:

  1. Pulse Configurar versión > Siguiente.
  2. En la sección Descripciones de valores de salida, proporcione una nueva descripción para el parámetro que desea actualizar.
  3. Pulse Siguiente.

Definir acceso de IAM

Si es aplicable a su tipo de software, puede añadir el acceso al servicio y los roles de acceso a la plataforma necesarios para instalar el producto desde el catálogo IBM Cloud. Puede definir el nuevo acceso de IAM o importar el acceso de IAM que ha establecido en una versión anterior.

Definición de un nuevo acceso de IAM

Utilice los pasos siguientes para definir el acceso del producto:

  1. Haz clic en « Configurar versión » > « Siguiente » > « Siguiente ».
  2. Pulse Añadir.
  3. Seleccione el servicio y el servicio necesario y el acceso a la plataforma.
    • El rol de acceso al servicio permite acceder al servicio y realizar llamadas a la API del mismo.
    • El rol de acceso a la plataforma permite realizar acciones sobre los recursos de la plataforma, como crear una instancia, conectar instancias a aplicaciones y asignar acceso a los usuarios.
  4. Pulse Guardar.

Importación de acceso de IAM existente

Realice los pasos siguientes si ha definido previamente el acceso de IAM para una versión existente y desea importar los valores a la versión actual.

El acceso de IAM importado no sustituye ningún acceso de IAM que ya haya añadido a la versión actual.

  1. Haz clic en « Configurar versión » > « Siguiente » > « Siguiente ».
  2. Pulse Añadir.
  3. Haz clic en « Importar acceso a IAM desde una versión anterior ».
  4. Selecciona la versión que contenga el acceso de IAM que deseas importar.
  5. Pulse Añadir.

Adición de acuerdos de licencia

Si se requiere que los usuarios acepten algún acuerdo de licencia además del Acuerdo de servicios de IBM Cloud cuando instalen el software, proporcione el URL a cada acuerdo o importe licencias de una versión existente.

Añadir nuevos acuerdos de licencia

  1. Haz clic en « Añadir acuerdos de licencia » > « Añadir licencia ».
  2. Especifique el nombre y el URL y pulse Añadir licencia.
  3. Después de especificar todos los acuerdos de licencia adicionales, pulse Siguiente.

Importar acuerdos de licencia

Realice estos pasos si ha añadido previamente acuerdos de licencia para una versión existente y desea importar las licencias a la versión actual.

Las licencias importadas no sustituyen a los acuerdos de licencia que ya haya añadido a la versión actual.

  1. Haz clic en « Añadir acuerdos de licencia » > « Añadir licencia ».
  2. Pulse Importar licencias de una versión anterior.
  3. Seleccione la versión que contiene las licencias que desea importar.
  4. Haga clic en Importar.

Revisión del archivo readme

Cuando los usuarios instalan el software, pueden ver la información del producto pulsando el enlace Léame. La información del enlace «Readme» se genera a partir del archivo «readme» que has subido a tu repositorio de código fuente.

  1. En el separador Editar archivo léame, pulse el icono Editar Icono Editar.
  2. Obtenga una vista previa de cómo se mostrará la información del archivo readme a los usuarios cuando estén instalando el software.
  3. Para realizar actualizaciones, pulse el icono Editar Icono Editar situado junto al título de la sección Readme.
  4. Pulse Guardar.
  5. Pulse Siguiente.

Si está importando una imagen de servidor virtual para VPC, el archivo léame no se genera automáticamente. Copie y pegue el contenido de la plantilla de archivo léame y realice las actualizaciones necesarias.

Validación del producto

Los pasos para validar el producto pueden variar en función del tipo de software que esté incorporando.

  1. En el separador Validar producto, configure el destino de validación y pulse Siguiente. Este paso solo se aplica a los diagramas de Helm y los operadores.
  2. Configure el espacio de trabajo y pulse Siguiente. Este paso solo se aplica a los gráficos Helm, los operadores, las plantillas Terraform y las imágenes de servidor virtual con Terraform.
  3. Pulse Validar.

Para supervisar el progreso del proceso de validación, pulse Ver registros.

Validación del software utilizando la API

Puede validar el software llamando a la API de gestión de catálogos.

String authRefreshToken = "{authRefreshToken}";
String versionLocator = "{versionLocator}";
ValidationInstallOptions installOptions = new ValidationInstallOptions.Builder().xAuthRefreshToken(authRefreshToken).versionLocId(versionLocator).build();
Response<Void> response = service.validationInstall(installOptions).execute();
System.out.println(response.getResult());
versionLocator = "{versionLocator}";
authRefreshToken = "{authRefreshToken}";
response = await service.validationInstall({ 'versionLocatorId': versionLocator, 'xAuthRefreshToken': authRefreshToken });
console.log(response);
authRefreshToken="{authRefreshToken}"
versionLocator = "{versionLocator}"
response = self.service.validation_install(version_locator_id=versionLocator, x_auth_refresh_token=authRefreshToken)
print(response)
versionLocator := "{versionLocator}"
authRefreshToken := "{authRefreshToken}"
installOptions := service.NewValidationInstallOptions(versionLocator, authRefreshToken)
response, _ := service.ValidationInstall(installOptions)
fmt.Println(response)

Gestión de los controles de seguridad y cumplimiento normativo

Los controles son medidas de protección que se utilizan para respetar los requisitos de seguridad y conformidad. Solo aparecen en el catálogo los controles Workload Protection compatibles con. Para obtener más información, consulte Formateo de controles en el archivo léame.

Añadir controles

Para añadir controles, sigue estos pasos:

  1. En la página Administrar cumplimiento, seleccione Agregar controles.

  2. Seleccione una Workload Protection instancia y, a continuación, una política.

    Si aún no ha aprovisionado una Workload Protection instancia, debe configurar una desde el IBM Cloud catálogo y habilitar Cloud Security Posture Management(CSPM) para su IBM Cloud cuenta. A continuación, complete los pasos para integrarse con una instancia Workload Protection existente o una nueva.

  3. Seleccione si desea añadir toda la política o solo un subconjunto de controles.

  4. Si selecciona añadir una política completa, continúe con el siguiente paso. Si elige añadir un subconjunto de controles, seleccione los controles que desea añadir.

  5. Pulse Añadir.

Añadir resultados de inventario de Workload Protection

Puede añadir los resultados del inventario de Workload Protection para que los usuarios puedan ver el cumplimiento declarado cuando evalúen su producto en el catálogo.

En Workload Protection, tu inventario se actualiza una vez al día. Debe desplegar sus recursos y esperar a que se actualice el inventario antes de añadirlo a su catálogo. Para obtener más información, vaya a Inventario.

Para añadir los resultados del inventario, sigue estos pasos:

  1. En la página «Gestionar el cumplimiento», haz clic en « Añadir resultados ».
  2. Seleccione la Workload Protection instancia que ha aprovisionado anteriormente.
  3. Haga clic en Aplicar para aplicar los últimos resultados del inventario.