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 > 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 operador de un registro de Red Hat OpenShift on IBM Cloud: Por ejemplo, seleccione el Akka Cluster Operator de la lista de operadores disponibles en el repositorio certificado.
   • 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 mediante tokens de acceso a proyectos. 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 Sí 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.

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.

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 Léame se genera a partir del archivo Léame que cargó en su repositorio de origen.

1. En el separador Editar archivo léame, pulse el 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 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)

Gestionar la seguridad y los controles de conformidad

Los controles son medidas de protección que se utilizan para respetar los requisitos de seguridad y conformidad. En el catálogo solo aparecen los controles admitidos por Security and Compliance Center, formateados correctamente y validados por Code Risk Analysis y Security and Compliance Center. Para obtener más información, consulte Formateo de controles en el archivo léame.

1. Pulse Añadir controles.
2. Elija un perfil.
3. Seleccione los controles que desea añadir a la versión.
4. Pulse Añadir.
5. En la sección de exploración de Code Risk Analyzer, pulse Ejecutar exploración.
6. Espere a que finalice la exploración.
7. En la sección de exploración de Security and Compliance Center, seleccione el perfil que ha explorado.
8. Seleccione la exploración de Security and Compliance Center.
9. Pulse Añadir exploración.
10. Pulse Siguiente.