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 est votre ingénieur partenaire, contactez-nous à l'adresse cloud-partner-onboarding@google.com.
Configurer Container Registry et IAM
Avant de pouvoir créer votre produit dans Producer Portal, vous devez créer un dépôt Container Registry de préproduction et y transférer les images que vous souhaitez distribuer dans votre produit. Dans votre projet, vous devez attribuer le rôle d'éditeur de projet à cloud-commerce-marketplace-onboarding@twosync-src.google.com
.
Premiers pas avec Container Registry
Pour transférer des images de conteneurs taguées vers Container Registry, suivez les étapes de la section Avant de commencer dans la documentation de Container Registry. Suivez ensuite la procédure ci-dessous pour activer l'API Container Analysis.
Après avoir installé gcloud
et Docker, vous devez activer les API suivantes à partir de la page Bibliothèque d'API :
- API Container Registry
- API Container Analysis
L'API Container Registry permet de transférer les images vers le registre de conteneurs et l'API Container Analysis permet d'analyser la 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
Choisissez le chemin d'accès à votre dépôt Container Registry de préparation. Nous vous recommandons de respecter la structure
gcr.io/YOUR-PARTNER-ID/YOUR-SOLUTION-ID
de votre dépôt.- Le dépôt de préproduction doit se trouver dans
gcr.io
(les autres régions, telles queeu.gcr.io
, ne sont pas encore prises 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.
- Le dépôt de préproduction doit se trouver dans
Créez l'image que vous souhaitez insérer dans votre dépôt Container Registry de préproduction.
Ajoutez le tag
latest
à l'image via Docker.docker tag image_name staging_repo_path:tag
Par exemple,
docker tag test-image gcr.io/testpartner/testsolution:latest
.Notez que l'image avec le tag
latest
est extraite si un utilisateur ne spécifie pas de tag.Transférez votre image à l'aide de
gcloud
:gcloud docker push staging_repo_path:tag
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. En d'autres termes, si une image se trouve dans
gcr.io/testpartner/testsolution/1.0
, elle ne se trouve PAS dans le dépôtgcr.io/testpartner/testsolution
.gcr.io/testpartner/testsolution/1.0
est un dépôt séparé.
Créer votre produit dans Producer Portal
Cette section explique comment créer et publier votre produit d'images de conteneurs dans Producer Portal.
Pour publier votre produit dans Producer Portal, vous devez créer une entrée pour celui-ci, puis envoyer les informations suivantes pour examen:
- Informations détaillées sur le produit: ajoutez des informations concernant votre produit à des fiches et des informations marketing.
- Images de conteneur : indiquez le dépôt Google Container Registry contenant vos images de conteneur.
Vous pouvez soumettre ces examens à tout moment et dans n'importe quel ordre.
Pour créer l'entrée Cloud Marketplace de votre produit:
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 du projet public que vous avez créé pour Cloud Marketplace, par exemple
my-organization-public
.En haut de la page, cliquez sur Ajouter un produit.
Sélectionnez Image du conteneur.
Sous Nom du produit, attribuez un nom à votre produit et vérifiez l'ID produit. L'ID produit est utilisé dans l'URL de votre fiche Cloud Marketplace.
Cliquez sur 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 votre fiche produit sur Cloud Marketplace, des informations marketing et des liens vers la documentation.
Pour ajouter des informations détaillées sur vos produits:
Dans la liste des produits, cliquez sur l'ID produit.
Sur la page Présentation de votre produit, accédez à Informations détaillées sur le produit, puis cliquez sur Modifier.
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 sous des catégories ou des filtres spécifiques lorsqu'ils effectuent des recherches dans Cloud Marketplace.
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. Votre documentation doit répondre aux exigences des guides de l'utilisateur.
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.
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 tag Container Registry latest
(sensible à la casse). Il s'agit de la version par défaut sur la page du produit.
Pour ajouter vos images de conteneurs:
Dans la liste des produits, cliquez sur l'ID produit.
Sur la page Présentation de votre produit, accédez à Images de conteneurs, puis cliquez sur Modifier.
Dans la section Images de conteneurs, saisissez l'URL de votre dépôt Container Registry de préproduction.
Cliquez sur Spécifier une version. La lecture du dépôt et le chargement des tags peuvent prendre quelques secondes.
Sélectionnez le tag display pour la version que vous souhaitez inclure à votre produit. Vous devez inclure la version
latest
dans votre produit, mais vous pouvez en ajouter d'autres. Nous vous recommandons de limiter le nombre de versions disponibles pour votre produit pour le confort de vos utilisateurs.Vous pouvez éventuellement ajouter un titre de version et une brève description de la release. Elles aident vos utilisateurs à déployer la version qu'ils souhaitent.
Indiquez le système d'exploitation compatible avec cette version. Vous pouvez spécifier la version du système d'exploitation, si nécessaire.
Après avoir ajouté toutes les informations concernant la version, cliquez sur OK.
Pour ajouter une autre version, cliquez sur Ajouter une version, puis saisissez les informations la concernant.
Lorsque vous avez terminé d'ajouter les versions compatibles à votre produit, cliquez sur Enregistrer et valider. Les images sont copiées dans un dépôt public, puis nous exécutons une série de tests sur les images.
Cliquez sur Envoyer pour envoyer les images de conteneur pour examen.
Prévisualiser votre produit d'images de conteneurs
Pour prévisualiser votre fiche Cloud Marketplace avant qu'elle ne soit visible par les utilisateurs:
Dans la liste des produits, cliquez sur l'ID produit.
Sur la page Vue d'ensemble de votre produit, cliquez sur Aperçu complet.
Si vous avez modifié des tags dans votre dépôt de préproduction depuis que vous avez validé vos images de conteneurs dans Producer Portal, les images référencées dans l'aperçu peuvent être inexactes.
Publier votre image de conteneur (produit)
Pour publier votre produit sur Cloud Marketplace, vous devez:
Examinez les sections Informations sur le produit et Images du conteneur.
Ê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 :
Dans la liste des produits, cliquez sur l'ID produit.
Sur la page Vue d'ensemble de votre produit, cliquez sur Publier.