Version in privaten Katalog importieren

Mit den folgenden Schritten können Sie eine Version Ihrer Software in Ihren privaten Katalog importieren. Ihr privater Katalog wurde für Sie im Rahmen der Vorbereitung zum Verkaufen von Services erstellt.

1. Klicken Sie in der IBM Cloud-Konsole auf das Symbol Navigationsmenü > Partner Center > Meine Produkte.

2. Wählen Sie das Produkt aus, dessen Onboarding Sie durchführen.

3. Klicken Sie auf der Registerkarte 'Software' auf Version importieren.

4. Wählen Sie Ihre Implementierungsmethode aus.

5. Wählen Sie aus, ob Sie Ihr Produkt aus einem privaten oder einem öffentlichen Repository hinzufügen. Wählen Sie für Operatoren Ihr Quellenrepository aus und wählen Sie dann das nicht öffentliche oder das öffentlich zugängliche Repository aus.

6. Geben Sie Ihre Quellen-URL ein.

   Sie können die folgende Liste der unterstützten Formate nach Softwaretyp überprüfen:

   • Helm-Diagramm: https://raw.githubusercontent.com/IBM/charts/master/repo/ibm-helm
   • Node-RED Operator: https://github.com/IBM-Cloud/operator-bundle-sample/archive/refs/tags/v0.0.3.tar.gz
   • Operator-Bundle aus einer „ Red Hat OpenShift on IBM Cloud “-Registrierung: Wählen Sie als Beispiel das „ Akka Cluster Operator “ aus der Liste der verfügbaren Operatoren im „Certified“-Repository aus.
   • OVA-Image: https://github.com/gcatalog/OVA-sample/blob/main/ova-sample.yaml
   • Terraform-Vorlage: https://github.com/IBM-Cloud/terraform-sample/archive/refs/tags/v1.1.0.tar.gz
   • Image des virtuellen Servers mit Terraform: https://github.com/IBM-Cloud/isv-vsi-product-deploy-sample/releases/download/v1.0/isv-vsi-product-deploy-sample.tar.gz
   • Virtuelles Server-Image für VPC: Wählen Sie ein Image aus der Liste der verfügbaren Images aus, die in Ihre VPC importiert wurden, oder importieren Sie ein neues Image in Ihr Konto.

   Ein virtuelles Server-Image für VPC kann jeweils nur einem Produkt in einem privaten Katalog hinzugefügt werden. Wenn das zu importierende Image des virtuellen Servers bereits in ein anderes Produkt importiert wurde, müssen Sie das Image aus diesem Produkt entfernen oder das Produkt löschen, bevor Sie das Image des virtuellen Servers zu einem neuen Produkt hinzufügen.

   Wenn Sie Ihr Produkt aus einem privaten Repository hinzufügen, können Sie ein persönliches Zugriffstoken bereitstellen oder einen geheimen Schlüssel verwenden. Statt Benutzern ein persönliches Zugriffstoken zu erteilen, können Sie den entsprechenden Benutzern Zugriff auf einen geheimen Schlüssel ermöglichen, das Token zu einem geheimen Schlüssel hinzufügen und alle Tokens sowie den vom geheimen Schlüssel ermöglichten Zugriff zentral verwalten.

   Wenn sich Ihre Software in befindet GitLab,, müssen Sie ein persönliches Zugriffstoken verwenden, da das Herunterladen von Releases GitLab mit Projektzugriffstoken nicht unterstützt. Sie können ein persönliches Zugangstoken mit der erforderlichen Berechtigung " read_api erstellen, indem Sie den Anweisungen hier folgen.

   • Wählen Sie bei Verwendung eines persönlichen Zugriffstokens Nein aus, um anzugeben, dass Sie keinen geheimen Schlüssel verwenden und das persönliche Zugriffstoken zur Verfügung stellen.
   • Wählen Sie bei Verwendung eines geheimen Schlüssels Ja aus und klicken Sie auf In Secrets Manager auswählen. Wählen Sie Ihre Serviceinstanz, die Gruppe geheimer Schlüssel und den geheimen Schlüssel aus. Falls Ihr geheimer Schlüssel nicht angezeigt wird, vergewissern Sie sich, dass Sie die richtige Gruppe geheimer Schlüssel und Serviceinstanz verwenden.

   Möglicherweise wird die Nachricht No service instance available angezeigt, wenn Sie keinen geheimen Schlüssel erstellt haben oder nicht die richtige Zugriffsberechtigung für die Verwendung von geheimen Schlüssel besitzen (selbst dann, wenn Sie erstellte Serviceinstanzen verwenden).

7. Falls zutreffend, legen Sie Ihr Implementierungsziel fest und fügen Sie Ihre Softwareversion hinzu.

8. Klicken Sie auf Version hinzufügen.

Versionsdetails konfigurieren

1. Klicken Sie in der Versionsliste auf die Zeile, die Ihre Software enthält.
2. Prüfen Sie die Details der Version, und klicken Sie auf Weiter.
3. Je nach Softwaretyp können zusätzliche Schritte erforderlich sein, z. B. das Festlegen von Implementierungswerten.
4. Klicken Sie auf Weiter.

Lizenzvereinbarungen hinzufügen

Wenn Benutzer Lizenzvereinbarungen akzeptieren müssen, die über die IBM Cloud -Servicevereinbarung hinausgehen, wenn sie die Software installieren, geben Sie die URL zu jeder Vereinbarung an oder importieren Sie Lizenzen aus einer vorhandenen Version.

Readme-Datei prüfen

Wenn Benutzer die Software installieren, können sie Produktinformationen anzeigen, indem sie auf den Readme-Link klicken. Die Informationen unter dem Link „Readme“ werden aus der Readme-Datei generiert, die Sie in Ihr Quell-Repository hochgeladen haben.

1. Klicken Sie auf der Registerkarte "Readme bearbeiten" auf das Symbol Bearbeiten .
2. Zeigen Sie in einer Vorschau an, wie die Informationen in der Readme-Datei den Benutzern bei der Installation der Software angezeigt werden.
3. Um Aktualisierungen vorzunehmen, klicken Sie auf das Symbol Bearbeiten neben dem Titel des Readme-Abschnitts.
4. Klicken Sie auf Speichern.
5. Klicken Sie auf Weiter.

Wenn Sie ein Image eines virtuellen Servers für VPC importieren, wird die Readme-Datei nicht automatisch generiert. Kopieren und fügen Sie den Inhalt der Readme-Dateivorlage ein und nehmen Sie die erforderlichen Aktualisierungen vor.

Produkt prüfen

Die Schritte zur Prüfung Ihres Produkts können abhängig von der Art der Software, für die Sie ein Onboarding durchführen, variieren.

1. Konfigurieren Sie auf der Registerkarte "Produkt validieren" Ihr Validierungsziel und klicken Sie auf Weiter. Dieser Schritt gilt nur für Helm-Diagramme und Operatoren.
2. Konfigurieren Sie Ihren Arbeitsbereich und klicken Sie auf Weiter. Dieser Schritt gilt nur für Helm-Diagramme, Operatoren, Terraform-Vorlagen und Images virtueller Server mit Terraform.
3. Klicken Sie auf Validieren.

Klicken Sie auf Protokolle anzeigen, um den Fortschritt des Validierungsprozesses zu überwachen.

Software mit der API überprüfen

Sie können Ihre Software validieren, indem Sie die Katalogverwaltungs-APIaufrufen.

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)

Verwaltung von Sicherheits- und Compliance-Kontrollen

Kontrollmechanismen dienen zum Erfüllen von Sicherheits- und Complianceanforderungen. Nur Steuerelemente, die von unterstützt Workload Protection werden, werden im Katalog angezeigt. Weitere Informationen finden Sie unter Steuerelemente in Ihrer Readme-Datei formatieren.