Software aktualisieren
Zur Aktualisierung der Software im privaten Katalog können Sie eine neue Version hinzufügen oder eine vorhandene Version aktualisieren und erneut veröffentlichen.
Vorbereitende Schritte
Zum Ausführen dieser Task müssen Sie über die Bearbeiterrolle für den Katalogverwaltungsservice verfügen. Weitere Informationen finden Sie in Benutzern Zugriffsberechtigungen zuweisen.
Stellen Sie sicher, dass Sie Folgendes ausgeführt haben, um Ihre Software mithilfe von Terraform zu aktualisieren:
- Installieren Sie die Terraform-CLI und konfigurieren Sie das Provider-Plug-in IBM Cloud für Terraform. Weitere Informationen finden Sie im Lernprogramm zur Einführung in Terraform auf IBM Cloud®. Das Plug-in abstrahiert die IBM Cloud APIs, die zur Erfüllung dieses Tasks verwendet werden.
- Erstellen Sie eine Terraform-Konfigurationsdatei mit dem Namen
main.tf. In dieser Datei definieren Sie Ressourcen mithilfe der Konfigurationssprache HashiCorp. Weitere Informationen finden Sie in der Terraform-Dokumentation.
Vorhandene Version über die Konsole aktualisieren
Die folgenden Schritte zeigen anhand eines Beispiels, wie die Readme-Datei eines Produkts aktualisiert wird, um den vollständigen Prozess zur Aktualisierung einer vorhandenen Softwareversion zu veranschaulichen.
- Rufen Sie in der IBM Cloud®-Konsole Verwalten > Kataloge > Private Katalogeauf und wählen Sie in der Liste Ihren Katalog aus.
- Klicken Sie auf den Namen Ihres Softwareprodukts.
- Wählen Sie Private Produkte aus, um zur Liste der Produkte in Ihrem privaten Katalog zu navigieren.
- Klicken Sie auf das Symbol Aktionen
und wählen Sie Bearbeiten.
- Klicken Sie auf die Registerkarte 'Readme-Datei bearbeiten'.
- Klicken Sie auf das Bearbeiten-Symbol
, fügen Sie dem Einführungsabschnitt eine neue Textzeile hinzu und klicken Sie auf Aktualisieren.
- Klicken Sie auf das Symbol Aktionen
und wählen Sie Änderungen zusammenführen, um die aktualisierte Version in Ihrem Konto zu veröffentlichen.
Vorhandene Version mithilfe der Befehlszeilenschnittstelle aktualisieren
Erstellen Sie anhand der folgenden Schritte eine Entwurfsversion, aktualisieren Sie sie und führen Sie die Änderungen mit der aktuellen Version Ihrer Software zusammen.
Sie benötigen den Versionsverweis für Ihre Software. Diesen Verweis finden Sie, indem Sie den Befehl ibmcloud catalog offering list --catalog "your-private-catalog" ausführen und nach der Nummer der vorhandenen
Version suchen.
- Erstellen Sie eine Entwurfsversion Ihrer Software.
ibmcloud catalog offering create-draft --version-locator <VERSION_LOCATOR> - Legen Sie eine andere Kategorie fest.
ibmcloud catalog offering add-category --catalog "your-private-catalog" --offering "your-software" --category "category-type" - Führen Sie die Entwurfsaktualisierung mit Ihrer Software zusammen. Durch diese Aktion wird die Aktualisierung mit der in Ihrem Konto veröffentlichten Software zusammengeführt.
ibmcloud catalog offering merge-draft --version-locator **<VERSION_LOCATOR_OF_DRAFT_VERSION>** - Suchen Sie im IBM Cloud-Katalog nach der Software.
ibmcloud catalog get --public | grep your-software
Vorhandene Version über die Anwendungsprogrammierschnittstelle (API) aktualisieren
Sie können eine Version programmgesteuert aktualisieren, indem Sie die Katalogverwaltungs-API aufrufen, wie in der folgenden Beispielanforderung dargestellt. Detaillierte Informationen zur API finden Sie unter Katalogverwaltungs-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)
Vorhandene Version mittels Terraform aktualisieren
Verwenden Sie die folgenden Schritte, um eine vorhandene Version Ihrer Software mit Terraform zu aktualisieren.
-
Erstellen Sie ein Argument in Ihrer Datei
main.tf. Das folgende Beispiel verwendet für den Zugriff auf die Softwareversion die Ressourcecm_version, wobeioffering_iddie Software angibt.resource "cm_version" "cm_version" { catalog_identifier = "catalog_identifier" offering_id = "offering_id" zipurl = "zipurl" }Weitere Informationen finden Sie in den Argumentreferenzdetails auf der Seite "Terraform Catalog Management ".
-
Nachdem Sie Ihre Konfigurationsdatei erstellt haben, initialisieren Sie die Terraform-CLI. Weitere Informationen finden Sie unter Arbeitsverzeichnisse initialisieren.
terraform init -
Stellen Sie die Ressourcen aus der Datei
main.tfbereit. Weitere Informationen finden Sie unter Infrastruktur mit Terraform bereitstellen.-
Führen Sie
terraform planaus, um einen Terraform-Ausführungsplan für die Vorschau der vorgeschlagenen Aktionen zu generieren.terraform plan -
Führen Sie
terraform applyaus, um die Ressourcen zu erstellen, die im Plan definiert sind.terraform apply
-