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 Google 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 le portail des partenaires ou 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 dotées de tags vers Container Registry, suivez la procédure décrite dans 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 depuis 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

  1. 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 que eu.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 la création du produit dans le portail des partenaires ou dans Producer Portal.
  2. Créez l'image que vous souhaitez insérer dans votre dépôt Container Registry de préproduction.

  3. 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 taguée latest est extraite si l'utilisateur ne spécifie pas de balise.

  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. 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ôt gcr.io/testpartner/testsolution. gcr.io/testpartner/testsolution/1.0 est un dépôt séparé.

Créer votre produit sur le portail

Cette section explique comment créer et publier votre produit d'images de conteneurs dans Producer Portal ou le portail des partenaires.

Producer Portal

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

  • Informations sur le produit : ajoutez des informations sur votre produit et vos fiches.
  • 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 Google Cloud Marketplace de votre produit :

  1. Ouvrez Producer Portal dans Google Cloud Console:

    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 Google Cloud Marketplace, par exemple my-organization-public.

  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. L'ID produit est utilisé dans l'URL de votre fiche Google Cloud Marketplace.

  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 votre fiche produit sur Google Cloud Marketplace, des informations marketing et des liens vers la documentation.

Pour ajouter des informations détaillées sur un produit:

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

  2. Sur la page Vue d'ensemble de votre produit, accédez à Informations 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. Ces identifiants permettent aux clients de trouver votre produit selon des catégories ou des filtres spécifiques lorsqu'ils effectuent une recherche dans Google 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. Votre documentation doit répondre aux exigences des 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 des images de conteneur

Vous devez créer une version correspondant à la balise Container Registry latest (sensible à la casse). Il s'agit de la version par défaut dans la page du produit.

Pour ajouter vos images de conteneur:

  1. Dans la liste des produits, cliquez sur l'ID 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 dépôt Container Registry de préproduction.

  4. Cliquez sur Indiquer une version. La lecture du dépôt et le chargement des tags peut prendre quelques secondes.

  5. Sélectionnez le tag à afficher pour la release que vous souhaitez inclure à votre produit. Vous devez inclure la version latest dans votre produit, mais vous pouvez ajouter des versions supplémentaires. Nous vous recommandons de limiter le nombre de versions disponibles pour votre produit pour plus de commodité.

  6. Vous pouvez éventuellement ajouter un titre de version et une brève description de la release. Ils aident ainsi les utilisateurs à déployer la version qu'ils souhaitent.

  7. Saisissez le système d'exploitation compatible avec cette version. Si nécessaire, vous pouvez spécifier la version du système d'exploitation.

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

  9. Pour ajouter une autre version, cliquez sur Ajouter une release, puis saisissez les informations requises.

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

  11. Cliquez sur Envoyer pour envoyer les images de conteneur.

Publier votre image de conteneur

Une fois tous les avis approuvés, vous pouvez publier et lancer le produit en quelques minutes.

Vous pouvez prévisualiser votre fiche Google Cloud Marketplace avant qu'elle soit visible par les utilisateurs en cliquant sur le bouton Aperçu complet. Les images référencées dans l'aperçu peuvent être inexactes si vous avez modifié les balises de votre dépôt de préproduction depuis sa validation dans le portail.

Pour publier votre produit d'images de conteneurs, procédez comme suit:

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

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

Portail des partenaires

Le lien direct du portail des partenaires est le suivant :

https://console.cloud.google.com/partner/solutions?project=YOUR_PROJECT_ID

Accédez ensuite à la section Solutions.

Si vous ne trouvez pas le lien ou que vous ne pouvez pas accéder à l'URL, vérifiez que vous avez sélectionné le bon projet. Si vous ne le trouvez toujours pas, envoyez un message à l'adresse cloud-partners@google.com pour demander des informations à ce sujet.

Étape 2 : Créez votre produit en tant que nouvelle solution

  1. Cliquez sur AJOUTER UNE SOLUTION en haut de la page.
  2. Attribuez un nom à votre solution et vérifiez son ID.
  3. Sélectionnez le type de solution Conteneur.
  4. Saisissez l'URL de votre dépôt de préparation.

    • Il s'agit du chemin de dépôt de préproduction que vous avez utilisé pour ajouter des tags à votre image et la transférer.
    • L'invite valide le chemin du dépôt de préproduction (assurez-vous qu'il existe et qu'il est accessible par le portail Partners). Le bouton CRÉER reste désactivé tant qu'un dépôt valide n'est pas spécifié.

Étape 3 : Modifiez les informations marketing de votre produit

  1. Cliquez sur l'ID de la solution pour modifier ses informations.
  2. Renseignez les sections Métadonnées de la solution, Détails de la solution et Documentation et assistance.

Étape 4: Créez une version latest (et toute autre version)

Vous devez créer une version correspondant à la balise Container Registry latest (sensible à la casse). Cette version sera proposée par défaut dans la liste déroulante et sera extraite du dépôt Container Registry officiel si aucun tag n'est fourni. Vous pouvez éventuellement créer d'autres versions, mais nous vous recommandons de n'en proposer que quelques-unes afin de ne pas "submerger" ou induire en erreur les utilisateurs finaux.

  1. Cliquez sur le bouton de modification situé à côté de Versions dans le menu de l'éditeur de solution.
  2. Cliquez sur Créer une version.
  3. Remplissez les informations relatives à la version :

    • Notez que toutes les modifications effectuées s'affichent dans l'aperçu en direct situé à gauche du panneau de modification. N'oubliez pas que vous pouvez cliquer sur la liste déroulante Version à côté du titre de votre solution et dans la section des métadonnées (la liste déroulante est désactivée si vous n'avez qu'une seule version) :

    • Sélectionnez le tag Container Registry auquel la version doit correspondre. Ce tag sert à identifier la version et ne peut pas être modifié après la création de la version.

    • Indiquez un titre (il sera affiché dans la liste déroulante).

    • Indiquez une description (facultative) qui s'affichera dans la liste déroulante et dans la section des métadonnées.

    • Indiquez le système d'exploitation et les autres packages logiciels (au moins un) pour votre solution. Ceux-ci ne peuvent pas être modifiés après l'envoi de la solution.

    • Cliquez sur Enregistrer.

  4. Répétez ces étapes pour toutes les versions ultérieures que vous souhaitez ajouter.

  5. Placez vos versions dans l'ordre souhaité en cliquant sur la poignée et en la faisant glisser.

    • Vos modifications s'affichent dans l'aperçu en direct.

N'oubliez pas que vous pouvez quitter le portail des partenaires et revenir plus tard pour continuer à travailler sur ou à terminer et envoyer votre brouillon. Votre progression sera enregistrée.

Étape 5 : Effectuez les révisions de version souhaitées

Pour effectuer les révisions de version nécessaires, cliquez sur le tag (Container Registry) de la version que vous souhaitez modifier dans le tableau situé sur la page de présentation des versions.

  • Vous pouvez modifier le titre, la description, l'image actuelle, le système d'exploitation ou le package logiciel d'une version avant de l'envoyer.

    • Notez que les systèmes d'exploitation et les packages logiciels sont associés à des condensés particuliers. Vous ne pourrez pas modifier le système d'exploitation ou le package logiciel après l'envoi d'un brouillon. Toutefois, si vous mettez à jour le condensé de votre version, il vous sera demandé de confirmer ou de modifier le système d'exploitation et le package logiciel pour ce condensé particulier.

    • Si l'image actuellement associée au tag dans votre dépôt de préproduction ne correspond pas à celle de votre brouillon, le bouton Update to current digest (Mettre à jour vers le condensé actuel) sera activé. Cliquez dessus, puis confirmez ou modifiez le système d'exploitation et le package logiciel pour la nouvelle image.

    • Vous pouvez également supprimer une version qui n'a pas encore été envoyée (sauf dans le brouillon), à l'exception de la version latest, qui est obligatoire.

Étape 6 : Envoyez la version

Une fois que vous avez confirmé que le produit présente l'apparence et le comportement attendus, cliquez sur le bouton Submit for review (Envoyer pour examen) dans le menu principal de l'éditeur de solution.