Aggiornamento del software

Per aggiornare il software che si trova nel tuo catalogo privato, puoi aggiungere una nuova versione o aggiornare e ripubblicare una versione esistente.

Prima di iniziare

Per completare questa attivit ..., Š necessario assegnare il ruolo di editor al servizio di gestione catalogo. Per ulteriori informazioni, vedi Assegnazione dell'accesso agli utenti.

Per aggiornare il tuo software utilizzando Terraform, assicurati di aver completato quanto segue:

  • Installa la CLI Terraform e configurare il plug-in del provider IBM Cloud per Terraform. Per ulteriori informazioni, vedi l'esercitazione per Introduzione a Terraform su IBM Cloud®. Il plug-in astrae le API IBM Cloud utilizzate per completare questa attività.
  • Creare un file di configurazione di Terraform chiamato main.tf. In questo file, si definiscono le risorse utilizzando il linguaggio di configurazione HashiCorp. Per ulteriori informazioni, vedi la documentazione Terraform.

Aggiorna una versione esistente utilizzando la console

La seguente procedura illustra un esempio di aggiornamento di un file readme di un prodotto per mostrare il processo completo di aggiornamento di una versione software esistente.

  1. Nella console IBM Cloud®, vai a Manage > Catalogs > Private catalogs e seleziona il tuo catalogo dall'elenco.
  2. Fare clic sul nome del prodotto software.
  3. Seleziona Prodotti privati per passare all'elenco di prodotti presenti nel tuo catalogo privato.
  4. Fare clic sull'icona Azioni icona Azioni e selezionare Modifica.
  5. Fare clic sulla scheda Modifica readme.
  6. Fare clic sull'icona Modifica icona Modifica, aggiungere una nuova riga di testo alla sezione Introduzione e fare clic su Aggiorna.
  7. Fai clic sull'icona Azioni icona Azioni e seleziona Unisci modifiche per pubblicare la versione aggiornata nel tuo account.

Aggiorna una versione esistente utilizzando la CLI

Completare la seguente procedura per creare una versione bozza, aggiornarla e unire le modifiche alla versione corrente del software.

Hai bisogno del localizzatore di versione per il tuo software. Per trovarlo, eseguire il comando ibmcloud catalog offering list --catalog "your-private-catalog" e cercare il numero di versione esistente.

  1. Creare una versione di bozza del software.
    ibmcloud catalog offering create-draft --version-locator <VERSION_LOCATOR>
  2. Impostare un'altra categoria.
    ibmcloud catalog offering add-category --catalog "your-private-catalog" --offering "your-software" --category "category-type"
  3. Unire l'aggiornamento della bozza al software. Questa azione unisce l'aggiornamento alla versione del software pubblicato nel proprio account.
    ibmcloud catalog offering merge-draft --version-locator **<VERSION_LOCATOR_OF_DRAFT_VERSION>**
  4. Cerca il software nel catalogo IBM Cloud.
    ibmcloud catalog get --public | grep your-software

Aggiorna una versione esistente utilizzando l'API

È possibile aggiornare programmaticamente una versione chiamando l'API di gestione del catalogo, come mostrato nella seguente richiesta di esempio. Per informazioni dettagliate sull'API, vedi Catalog Management API.

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)

Aggiorna una versione esistente utilizzando Terraform

Utilizza la seguente procedura per aggiornare una versione esistente del tuo software utilizzando Terraform.

  1. Creare un argomento nel file main.tf. Il seguente esempio accede alla versione del software utilizzando la risorsa cm_version, dove offering_id identifica il software.

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

    Per ulteriori informazioni, vedi i dettagli di riferimento dell'argomento nella pagina Terraform Catalog Management.

  2. Dopo aver terminato la creazione del file di configurazione, inizializza la CLI Terraform. Per ulteriori informazioni, consultare la sezione Inizializzazione delle directory di lavoro.

    terraform init

  3. Eseguire il provisioning delle risorse dal file main.tf. Per ulteriori informazioni, vedi Provisioning dell'infrastruttura con Terraform.

    1. Eseguire terraform plan per generare un piano di esecuzione Terraform per visualizzare in anteprima le azioni proposte.

      terraform plan

    2. Eseguire terraform apply per creare le risorse definite nel piano.

      terraform apply