IBM Cloud Docs
Actualización del software

Actualización del software

Para actualizar el software que está en su catálogo privado, puede añadir una nueva versión o actualizar y volver a publicar una versión existente.

Antes de empezar

Para completar esta tarea, debe tener asignado el rol de editor sobre el servicio de gestión de catálogos. Para obtener más información, consulte Asignación de acceso de usuarios.

Para actualizar el software utilizando Terraform, asegúrese de que ha completado lo siguiente:

  • Instale la CLI de Terraform y configure el plugin de proveedor de IBM Cloud para Terraform. Para obtener más información, consulte la guía de aprendizaje de Iniciación a Terraform en IBM Cloud®. El plug-in abstrae las API de IBM Cloud que se utilizan para completar esta tarea.
  • Cree un archivo de configuración de Terraform denominado main.tf. En este archivo, puede definir recursos utilizando HashiCorp Configuration Language. Para obtener más información, consulte la documentación de Terraform.

Actualizar una versión existente utilizando la consola

Los siguientes pasos muestran un ejemplo de cómo actualizar el archivo Léame de un producto para mostrar el proceso completo de actualización de una versión de software existente.

  1. En la consola de IBM Cloud®, vaya a Gestionar > Catálogos > Catálogos privados y seleccione el catálogo de la lista.
  2. Pulse el nombre del producto de software.
  3. Seleccione Productos privados para ir a la lista de productos que están en su catálogo privado.
  4. Pulse el icono Acciones Icono Acciones y seleccione Editar.
  5. Pulse el separador Editar archivo readme.
  6. Pulse el icono Editar Icono Editar, añada una nueva línea de texto a la sección Introducción y pulse Actualización.
  7. Pulse el icono Acciones Icono Acciones y seleccione Fusionar cambios para publicar la versión actualizada en su cuenta.

Actualización de una versión existente mediante la CLI

Siga los pasos siguientes para crear una versión de borrador, actualizarla y fusionar los cambios con la versión actual del software.

Necesita el localizador de versiones para su software. Para localizarlo, ejecute el mandato ibmcloud catalog offering list --catalog "your-private-catalog" y busque el número de versión existente.

  1. Cree una versión de borrador del software.
    ibmcloud catalog offering create-draft --version-locator <VERSION_LOCATOR>
    
  2. Establecer otra categoría.
    ibmcloud catalog offering add-category --catalog "your-private-catalog" --offering "your-software" --category "category-type"
    
  3. Fusione la actualización de borrador con el software. Esta acción fusiona la actualización con la versión del software que se ha publicado en su cuenta.
    ibmcloud catalog offering merge-draft --version-locator **<VERSION_LOCATOR_OF_DRAFT_VERSION>**
    
  4. Busque el software en el catálogo de IBM Cloud.
    ibmcloud catalog get --public | grep your-software
    

Actualizar una versión existente mediante la API

Puede actualizar mediante programación una versión llamando a la API de gestión de catálogos, tal como se muestra en la solicitud de ejemplo siguiente. Para obtener información detallada sobre la API, consulte API de gestión de catálogos.

String catalogID = "{catalogID}";
String offeringID = "{offeringID}";
String label = "{label}";
String shortDesc = "{shortDesc}";
ReplaceOfferingOptions replaceOptions = new ReplaceOfferingOptions.Builder().catalogIdentifier(catalogID).id(offeringID).offeringId(offeringID).label(label).shortDescription(shortDesc).rev(revision.rev()).build();
Response<Catalog> response = service.replaceOffering(replaceOptions).execute();
System.out.println(response.getResult());
vcatalogID = "{catalogID}";
offeringID = "{offeringID}";
revision = "{revision}";
label = "{label}";
shortDesc = "{shortDesc}";
response = await service.replaceOffering({'catalogIdentifier': catalogID, 'offeringId': offeringID, 'id': offeringID, 'rev': revision, 'label': label, 'shortDescription': shortDesc});
console.log(response);
catalogID = "{catalogID}"
offeringID = "{offeringID}"
revision = "{revision}"
shortDesc = "{shortDesc}"
response = self.service.replace_offering(catalog_identifier=catalogID, offering_id=offeringID, id=offeringID, rev=revision, label=label, short_description=shortDesc)
print(response)
catalogID := "{catalogID}"
offeringID := "{offeringID}"
label := "{label}"
shortDesc := "{shortDesc}"
revision := "{revision}"
updateOptions := service.NewReplaceOfferingOptions(catalogID, offeringID)
updateOptions.SetID(offeringID)
updateOptions.SetLabel(label)
updateOptions.SetShortDescription(shortDesc)
updateOptions.SetRev(revision)
_, response, _ := service.ReplaceOffering(updateOptions)
fmt.Println(response)

Actualizar una versión existente utilizando Terraform

Utilice los pasos siguientes para actualizar una versión existente del software utilizando Terraform.

  1. Cree un argumento en el archivo main.tf. El ejemplo siguiente accede a la versión de software utilizando el recurso cm_version, donde offering_id identifica el software.

    resource "cm_version" "cm_version" {
    catalog_identifier = "catalog_identifier"
    offering_id = "offering_id"
    zipurl = "zipurl"
    }
    

    Para obtener más información, consulte los detalles de referencia de argumentos en la página de gestión de catálogos de Terraform.

  2. Después de terminar de crear el archivo de configuración, inicialice la CLI de Terraform. Para obtener más información, consulte Inicialización de directorios de trabajo.

    terraform init
    
  3. Suministre los recursos desde el archivo main.tf. Para obtener más información, consulte Infraestructura de suministro con Terraform.

    1. Ejecute terraform plan para generar un plan de ejecución de Terraform para obtener una vista previa de las acciones propuestas.

      terraform plan
      
    2. Ejecute terraform apply para crear los recursos definidos en el plan.

      terraform apply