Importation d'une version dans votre catalogue privé

Pour importer une version de votre logiciel dans votre catalogue privé, procédez comme suit. Votre catalogue privé a été automatiquement créé dans le cadre de la Configuration de la vente de logiciel.

1. Dans la console d' IBM Cloud, cliquez sur l'icône « Menu de navigation » ( ) > « Centre des partenaires » ( ) > « Mes produits » ( ).

2. Sélectionnez le produit que vous intégrez.

3. Dans l'onglet Logiciel, cliquez sur Importer une version.

4. Sélectionnez votre méthode de déploiement.

5. Sélectionnez si vous ajoutez votre produit depuis un référentiel privé ou public. Pour les opérateurs, sélectionnez votre référentiel source, puis choisissez un référentiel privé ou public.

6. Entrez votre URL source.

   Vous pouvez consulter la liste suivante des formats pris en charge par type de logiciel:

   • Helm: https://raw.githubusercontent.com/IBM/charts/master/repo/ibm-helm
   • Opérateur Node-RED : https://github.com/IBM-Cloud/operator-bundle-sample/archive/refs/tags/v0.0.3.tar.gz
   • Ensemble d'opérateurs issu d'un registre « Red Hat OpenShift on IBM Cloud » : à titre d'exemple, sélectionnez l' Akka Cluster Operator dans la liste des opérateurs disponibles du référentiel « Certified ».
   • Image OVA : https://github.com/gcatalog/OVA-sample/blob/main/ova-sample.yaml
   • Modèle Terraform: https://github.com/IBM-Cloud/terraform-sample/archive/refs/tags/v1.1.0.tar.gz
   • Image de serveur virtuel avec Terraform : https://github.com/IBM-Cloud/isv-vsi-product-deploy-sample/releases/download/v1.0/isv-vsi-product-deploy-sample.tar.gz
   • Image de serveur virtuel pour VPC: sélectionnez une image dans la liste des images disponibles qui ont été importées dans votre VPC ou importez une nouvelle image dans votre compte.

   Une image de serveur virtuel pour VPC ne peut être ajoutée qu'à un seul produit dans un catalogue privé à la fois. Si l'image de serveur virtuel que vous souhaitez importer est déjà importée dans un autre produit, vous devez supprimer l'image de ce produit ou supprimer le produit avant d'ajouter l'image de serveur virtuel à un nouveau produit.

   Si vous ajoutez votre produit depuis un référentiel privé, vous pouvez choisir de fournir un jeton d'accès personnel ou vous pouvez utiliser un secret. Au lieu de donner aux utilisateurs un jeton d'accès personnel, vous pouvez leur accorder l'accès à un secret, ajouter le jeton à ce secret, puis gérer de manière centralisée tous les jetons et les accès autorisés par le secret.

   Si votre logiciel se trouve dans, GitLab, vous devez utiliser un jeton d'accès personnel, car GitLab ne prend pas en charge le téléchargement de versions à l'aide de jetons d'accès au projet. Vous pouvez créer un jeton d'accès personnel avec l'autorisation " read_api requise en suivant les instructions ici.

   • Si vous utilisez un jeton d'accès personnel, sélectionnez Non pour indiquer que vous n'utilisez pas de secret et fournissez votre jeton d'accès personnel.
   • Si vous utilisez un secret, sélectionnez Oui et cliquez sur Sélectionner depuis Secrets Manager. Sélectionnez votre instance de service, le groupe de secrets et le secret. Si vous ne voyez pas votre secret, vérifiez que vous utilisez le groupe de secrets et l'instance de service corrects.

   Le message No service instance available peut s'afficher si vous n'avez pas créé de secret ou si vous n'avez pas l'accès correct pour utiliser des secrets, même si vous avez des instances de service qui sont créées.

7. S'il y a lieu, définissez votre cible de déploiement et ajoutez votre version de logiciel.

8. Cliquez sur Ajouter une version.

Configuration des détails de la version

1. Dans la liste des versions, cliquez sur la ligne contenant votre logiciel.
2. Examinez les détails de version et cliquez sur Suivant.
3. En fonction de votre type de logiciel, il peut y avoir des étapes supplémentaires, y compris la définition des valeurs de déploiement.
4. Cliquez sur Suivant.

Ajout de contrats de licence

Si les utilisateurs sont tenus d'accepter des contrats de licence au-delà de l'accord de services IBM Cloud lorsqu'ils installent le logiciel, fournissez l'URL de chaque contrat ou des licences d'importation à partir d'une version existante.

Consultation du fichier Readme

Lorsque les utilisateurs installent le logiciel, ils peuvent afficher les informations sur le produit en cliquant sur le lien Readme. Les informations contenues dans le lien « Readme » sont générées à partir du fichier README que vous avez mis en ligne dans votre dépôt de code source.

1. Dans l'onglet Édition du fichier readme, cliquez sur l'icône Édition .
2. Prévisualisez comment les informations du fichier Readme seront présentées aux utilisateurs lors de l'installation du logiciel.
3. Pour effectuer des mises à jour, cliquez sur l'icône Éditer en regard du titre de la section Readme.
4. Cliquez sur Sauvegarder.
5. Cliquez sur Suivant.

Si vous importez une image de serveur virtuel pour VPC, le fichier Readme n'est pas généré automatiquement. Copiez et collez le contenu du modèle de fichier Readme et effectuez les mises à jour nécessaires.

Validation du produit

Les étapes à suivre pour valider votre produit peuvent varier en fonction du type de logiciel que vous utilisez.

1. Dans l'onglet Valider le produit, configurez votre cible de validation et cliquez sur Suivant. Cette étape s'applique uniquement aux chartes et aux opérateurs Helm.
2. Configurez votre espace de travail et cliquez sur Suivant. Cette étape s'applique uniquement aux chartes Helm, aux opérateurs, aux modèles Terraform et aux images de serveur virtuel avec Terraform.
3. Cliquez sur Valider.

Pour suivre la progression du processus de validation, cliquez sur Afficher les journaux.

Validation de votre logiciel à l'aide de l'API

Vous pouvez valider votre logiciel en appelant l'API Catalog Management.

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)

Gestion des contrôles de sécurité et de conformité

Les contrôles sont des mesures de protection utilisées pour répondre aux exigences en matière de sécurité et de conformité. Seuls les contrôles pris en charge par Workload Protection apparaissent dans le catalogue. Pour plus d'informations, voir Mise en forme des contrôles dans votre fichier Readme.