Configurer les composants techniques

Cette page explique comment créer les composants techniques clés nécessaires pour la distribution de votre produit d'images de conteneurs avec Google Cloud Marketplace.

Si vous avez des questions au cours du processus d'intégration, contactez votre Ingénieur partenaire Cloud Marketplace. Si vous ne savez pas à qui vous avez attribué Ingénieur partenaire : utilisez la Partner Support Desk pour demander de l'aide et inclure le mot « Marketplace » dans votre description. Pour en savoir plus, à propos du Partner Support Desk, consultez la page Demandez de l'aide concernant Cloud Marketplace.

Configurer Artifact Registry et IAM

Avant de pouvoir créer votre produit dans Producer Portal, vous devez créer un dépôt Artifact Registry de préproduction et transférer les images que vous souhaitez distribuer dans votre produit dans ce référentiel. Dans votre projet, vous devez attribuer le rôle "Éditeur de projet" [e-mail]

Premiers pas avec Container Registry

Pour transférer des images de conteneurs taguées vers Container Registry, suivez les instructions les étapes de la section Avant de commencer Documentation Artifact Registry Suivez ensuite la procédure ci-dessous pour activer l'API Artifact Analysis.

Pour les partenaires de VM existants: votre environnement de préproduction Le dépôt Artifact Registry peut se trouver dans votre projet de développement votre projet public.

Après avoir installé gcloud et Docker, vous devez activer les API suivantes à partir de Page "Bibliothèque d'API":

• API Artifact Registry
• API Artifact Analysis

L'API Artifact Registry vous permet de transférer Artifact Registry et l'API Artifact Analysis permettent les analyses de sécurité.

Si vous rencontrez des difficultés pour accéder à l'une de ces API, contactez votre ingénieur partenaire.

Ajouter des tags aux images et transférer ces images

1. Choisissez le chemin d'accès à votre dépôt de préproduction Artifact Registry. Nous vous recommandons de respecter la structure us-docker.pkg.dev/YOUR-PARTNER-ID/YOUR-SOLUTION-ID de votre dépôt.

   • Le dépôt de préproduction doit se trouver dans us-docker.pkg.dev ou gcr.io (d'autres régions, comme europe-docker.pkg.dev ou eu.gcr.io ne sont pas déjà pris en charge).
   • Enregistrez ou copiez le chemin d'accès à votre dépôt de préproduction pour créer des produits dans Producer Portal.

2. Créez l'image que vous souhaitez transférer vers votre environnement de préproduction Artifact Registry un dépôt de clés.

3. Ajouter le tag latest à l'image via Docker.

   docker tag image_name staging_repo_path:tag

   Par exemple, docker tag test-image us-docker.pkg.dev/testpartner/testsolution:latest.

   Notez que l'image avec le tag latest est extraite si l'utilisateur ne spécifie pas de paramètre .

4. Transférez votre image à l'aide de gcloud:

   gcloud docker push staging_repo_path:tag

5. Répétez l'opération pour tous les tags ou images supplémentaires que vous souhaitez ajouter à votre dépôt de préproduction. Une même image peut être associée à plusieurs tags.

   • N'oubliez pas que le fait de transférer une image vers votre dépôt de préproduction ne la rendra pas automatiquement visible pour les utilisateurs ; cela n'arrive qu'aux images des tags que vous sélectionnez, après leur publication.
   • Le champ d'application d'un dépôt est le seul niveau du dossier spécifié par son chemin. Les images situées dans un autre dossier du dépôt ne se trouvent pas réellement dans le dépôt lui-même. Autrement dit, si une image se trouve dans us-docker.pkg.dev/testpartner/testsolution/1.0, elle est NE SE TROUVE PAS dans le us-docker.pkg.dev/testpartner/testsolution un dépôt de clés. us-docker.pkg.dev/testpartner/testsolution/1.0 est un dépôt distinct.

Créer votre produit dans Producer Portal

Cette section explique comment créer et publier votre produit d'image de conteneur dans Producer Portal.

Pour publier votre produit dans Producer Portal, vous devez créer une entrée pour votre puis envoyez les informations suivantes pour examen:

• Informations détaillées sur le produit: ajoutez des informations marketing et une fiche produit sur votre produit.
• Images de conteneurs: fournissez le dépôt Google Container Registry qui inclut vos images de conteneurs.

Vous pouvez soumettre ces examens à tout moment et dans n'importe quel ordre.

Pour créer l'entrée Cloud Marketplace de votre produit:

1. Ouvrez Producer Portal dans la console Google Cloud:

   https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID
   

   Remplacez YOUR_PUBLIC_PROJECT_ID par l'ID public que vous avez créé pour Cloud Marketplace (par exemple, my-organization-public

   Remarque : Si le lien ne s'affiche pas ou si vous ne pouvez pas accéder à l'URL, vérifiez si vous avez sélectionné le bon projet et que vous disposez du rôle Éditeur (roles/editor) pour le projet. Si vous ne parvenez toujours pas à accéder à l'URL, utilisez le Partner Support Desk pour en faire la demande en ajoutant le mot "Place de marché" dans votre description. Pour plus plus d'informations sur le Partner Support Desk, consultez la page Demandez de l'aide concernant Cloud Marketplace.

2. En haut de la page, cliquez sur Ajouter un produit.

3. Sélectionnez Image du conteneur.

4. Sous Nom du produit, attribuez un nom à votre produit et vérifiez l'ID produit. La L'ID produit est utilisé dans l'URL de votre fiche Cloud Marketplace.

   Attention :L'identifiant produit et le type de produit ne peuvent plus être modifiés après la produit est créé. Vous pouvez modifier le nom de votre produit avant de l'envoyer.

5. Cliquez sur Create (Créer). La création de votre produit peut prendre quelques secondes.

Ajout d'informations détaillées sur le produit

Les informations détaillées sur le produit incluent la fiche de votre produit sur Cloud Marketplace, des informations marketing et des liens vers la documentation.

Pour ajouter des informations détaillées sur vos produits:

1. Dans la liste des produits, cliquez sur l'ID du produit.

2. Sur la page Aperçu de votre produit, accédez à Informations détaillées sur le produit. puis cliquez sur Modifier.

3. Renseignez l'onglet INFOS SUR LE PRODUIT de la section Informations détaillées sur le produit. Lorsque vous indiquez des INFOS SUR LE PRODUIT, vous pouvez ajouter des ID de catégorie. Les ID de catégorie permettent aux clients de trouver votre produit dans des catégories ou des filtres sélectionnés effectuer une recherche sur Cloud Marketplace.

4. Pour ajouter des tutoriels, de la documentation et, éventuellement, des contrats de licence supplémentaires, renseignez l'onglet DOCUMENTATION de la section Informations détaillées sur le produit. Vos documents doivent respecter les exigences concernant les guides de l'utilisateur.

5. Pour ajouter des métadonnées de recherche ou des mots clés, ou pour personnaliser l'URL de la page d'informations détaillées sur votre produit, complétez l'onglet MÉTADONNÉES DU PRODUIT de la section Informations détaillées sur le produit.

6. Lorsque vous êtes prêt à envoyer les informations détaillées sur le produit pour qu'elles soient traitées, cliquez sur Envoyer.

Il faut compter environ deux à cinq jours pour que l'équipe d'ingénieurs partenaires examine et approuve les informations détaillées sur votre produit. Vous pouvez modifier ces informations détaillées dès maintenant et envoyer l'examen ultérieurement.

Ajouter vos images de conteneurs

Vous devez créer une version correspondant au conteneur Balise de registre latest (sensible à la casse). Il s'agit de la version par défaut dans page produit.

Pour ajouter vos images de conteneurs:

1. Dans la liste des produits, cliquez sur l'ID du produit.

2. Sur la page Présentation de votre produit, accédez à Images de conteneurs. puis cliquez sur Modifier.

3. Dans la section Images de conteneurs, saisissez l'URL de votre préproduction. dépôt Artifact Registry.

4. Cliquez sur Indiquer la version. La lecture du fichier et charger vos tags.

5. Sélectionnez le tag d'affichage pour la version que vous souhaitez inclure dans votre produit. Vous devez inclure la version latest dans votre produit, mais vous pouvez ajouter d'autres versions. Nous vous recommandons de limiter le nombre versions disponibles de votre produit pour les utilisateurs pratique.

6. Vous pouvez éventuellement ajouter un titre de la version et une brève description de la version. Ils aident vos utilisateurs à déployer la version de leur choix.

7. Indiquez le système d'exploitation compatible avec cette version. Vous pouvez spécifier la version du système d'exploitation, si nécessaire.

8. Une fois que vous avez ajouté toutes les informations sur la version, cliquez sur OK.

9. Pour ajouter une autre version, cliquez sur Ajouter une version, puis saisissez les informations pour cette version.

10. Lorsque vous avez terminé d'ajouter des versions compatibles à votre produit, cliquez sur Enregistrez et validez. Les images sont copiées dans un dépôt public, puis nous exécutons une série de tests sur les images.

11. Cliquez sur Envoyer pour envoyer les images de conteneurs pour examen.

Prévisualiser le produit de votre image de conteneur

Pour prévisualiser votre fiche Cloud Marketplace avant qu'elle ne soit présentée aux utilisateurs:

1. Dans la liste des produits, cliquez sur l'ID du produit.

2. Sur la page Aperçu de votre produit, cliquez sur Aperçu complet.

Si vous avez modifié des tags dans votre dépôt de préproduction depuis la validation des images de conteneurs dans Producer Portal, les images référencées dans l'aperçu peuvent être inexactes.

Publier votre produit d'image de conteneur

Pour publier votre produit sur Cloud Marketplace, vous devez:

• Effectuez les examens Informations sur le produit et Images de conteneurs.

• Être approuvé en tant que Partenaire Google Cloud Build.

Une fois tous les éléments approuvés, vous pouvez publier et lancer le produit en quelques minutes. Pour publier votre produit :

1. Dans la liste des produits, cliquez sur l'ID du produit.

2. Sur la page Vue d'ensemble de votre produit, cliquez sur Publier.