Configurer votre environnement Google Cloud

Cette page décrit les étapes à suivre pour configurer votre environnement Google Cloud afin de pouvoir distribuer vos applications Kubernetes.

Créer votre espace de travail

Nous vous recommandons de créer un projet dans la console principalement pour vos produits Google Cloud Marketplace.

Pour gérer les produits que vous envoyez à Google Cloud Marketplace, nous vous recommandons de créer un projet dont l'ID se termine par -public. Pour créer un projet pour vos produits, consultez la page Créer et gérer des projets.

Si vous disposez déjà d'un projet que vous souhaitez utiliser sur Google Cloud Marketplace, vérifiez que les rôles sont correctement attribués pour Kubernetes, puis passez à la configuration d'un registre de conteneurs.

Après avoir créé votre projet, attribuez les rôles suivants :

  • Les rôles d'éditeur de projet, de lecteur de projet et d'administrateur de gestion des services cloud-commerce-marketplace-onboarding@twosync-src.google.com
  • Le rôle Client du service Service Management pour cloud-commerce-procurement@system.gserviceaccount.com
  • Le rôle Contrôleur du service de gestion des services pour cloud-commerce-procurement@system.gserviceaccount.com
  • Le rôle Administrateur Service Management à managed-services@cloud-marketplace.iam.gserviceaccount.com

Si vous avez besoin d'aide pour déboguer votre projet, par exemple pour résoudre les problèmes liés à votre dépôt Container Registry, accordez le rôle d'éditeur de projet à cloud-commerce-marketplace-onboarding@twosync-src.google.com.

Pour connaître les étapes permettant d'accorder l'accès au projet, consultez la section Accorder, modifier et révoquer les accès aux ressources.

Une fois le projet créé, remplissez le formulaire d'informations sur le projet fourni par l'équipe Google Cloud Marketplace.

Configurer un registre de conteneurs

Vous avez besoin d'un dépôt Container Registry pour héberger les images de conteneurs pour votre application. Container Analysis analyse en permanence les images de l'application pour détecter les vulnérabilités, afin que vous puissiez examiner et résoudre les problèmes avant d'envoyer votre produit à Google Cloud Marketplace.

Pour configurer Container Registry, Docker et le SDK Google Cloud, consultez le guide de démarrage rapide de Container Registry.

Après avoir configuré Container Registry, attribuez le rôle de lecteur de projet à cloud-commerce-marketplace-onboarding@twosync-src.google.com dans le projet contenant le registre.

Activer l'API Container Analysis

Vous devez activer l'API Container Analysis qui analyse les images de votre conteneur dans Container Registry pour détecter les failles de sécurité. Pour une présentation de l'analyse des failles dans Container Analysis, consultez la documentation de Container Registry.

Ajouter votre produit à Google Cloud Marketplace

Pour créer et publier votre produit dans Google Cloud Marketplace, vous devez utiliser Producer Portal. Votre ingénieur partenaire le permet pour vous une fois que vous avez rempli le formulaire d'informations concernant les projets Google Cloud Marketplace.

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.
  • Prix: choisissez et spécifiez votre modèle de tarification pour déterminer la manière dont les clients vous paient pour votre produit.
  • Images de conteneur: indiquez le dépôt Google Container Registry contenant vos images de conteneur.
  • Conformité avec l'Open Source: assurez-vous que votre produit respecte les règles de Google pour les logiciels Open Source.

Vous pouvez soumettre ces examens à tout moment et dans n'importe quel ordre. Certains examens peuvent nécessiter jusqu'à deux semaines pour être approuvés. Nous vous recommandons donc de passer en revue les exigences et de commencer le plus tôt possible.

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 Kubernetes.

  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.

Portail des partenaires

Le portail des partenaires vous permet d'ajouter des informations marketing sur votre application et de saisir votre modèle de tarification. Votre ingénieur partenaire active le portail des partenaires une fois que vous avez rempli le formulaire d'informations sur le projet.

À ce stade, il vous suffit de créer une entrée de solution pour votre produit dans le portail des partenaires. Vous ajoutez vos informations de marketing aux étapes ultérieures.

Le lien direct vers le portail des partenaires est le suivant :

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

Pour créer votre solution :

  1. En haut de la page, cliquez sur Ajouter une solution.

  2. Attribuez un nom à votre solution et vérifiez son ID. L'ID de la solution est utilisé dans l'URL de votre fiche Google Cloud Marketplace.

  3. Sous Type de solution, sélectionnez l'application Kubernetes.

  4. Dans la zone URL du dépôt de préproduction, entrez l'URL de votre dépôt Container Registry.

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

Vous ajoutez votre modèle de tarification et les informations marketing de votre solution au cours des étapes ultérieures.

Créer un cluster de développement dans Kubernetes Engine

Pour gérer et mettre à l'échelle les clusters Kubernetes, utilisez Google Kubernetes Engine. Pour créer un cluster de test et y déployer une application de base, consultez le guide de Démarrage rapide de Google Kubernetes Engine.

Installer l'outil de développement mpdev

L'outil mpdev est un conteneur qui regroupe des utilitaires de test et de publication des images de votre application. Bien qu'il ne soit pas nécessaire d'installer mpdev pour effectuer la release d'une application, vous pouvez exécuter mpdev pour vérifier votre environnement de développement et pour tester l'installation correcte de votre application sur votre cluster de développement.

Installez mpdev à partir du dépôt GitHub des outils Google Cloud Marketplace.

Pour en savoir plus sur l'utilisation de mpdev pour vérifier votre environnement et tester votre application, consultez la référence mpdev sur GitHub.

Organiser vos releases

En général, chaque version de votre application doit adopter Semantic Versioning 2.0, qui suit la convention de numérotation MAJOR.MINOR.PATCH. Chaque version doit posséder un numéro de version unique, tel que 1.0.1, 1.0.2, 1.3.1, etc. Si vous le souhaitez, vous pouvez ajouter un trait d'union après le numéro de version pour ajouter un modificateur de version préliminaire, tel que 1.3.1-alpha201910. Les modificateurs de version préliminaire peuvent être utilisés pour stocker et mettre en évidence toutes les informations supplémentaires que vous jugez utiles, telles que les dates de compilation indiquant la date de création des versions.

Nous vous recommandons de publier votre logiciel en canaux. Chaque canal est une série de versions présentant des mises à jour rétrocompatibles. Vos canaux de publication doivent être basés sur une version mineure, telle que 4.1.x. Une bonne pratique consiste à éviter d'utiliser des noms de version génériques tels que latest.

Par exemple, si vous publiez la version 2.0 de votre logiciel sur Google Cloud Marketplace et que les versions 2.0.1, 2.0.5, etc., sont rétrocompatibles avec 2.0, placez ces versions sur le canal de publication 2.0.

Lorsque vous publiez une version de votre application incompatible avec les précédentes, ou une version qui oblige les utilisateurs à suivre une procédure de migration manuelle, publiez-la sur un nouveau canal, afin que les utilisateurs puissent planifier leurs mises à jour.

Choisir des identifiants de produit

Vous devez sélectionner les identifiants suivants pour vos images d'entreprise, de produit et de conteneur, qui sont utilisés pour créer vos URL Google Cloud Marketplace et les URI de vos images de conteneur :

  • Nom de votre entreprise : Par exemple, si le nom de votre entreprise est Examplesoft Inc., vous pouvez utiliser l'identifiant examplesoft.

  • Nom de votre produit : Par exemple, si le nom de votre produit est Example Pro, utilisez l'identifiant example-pro.

  • Le canal de publication de votre produit, tel que 4.0.

    Voir les conditions requises pour organiser vos releases.

  • Images de conteneur : Sélectionnez un identifiant unique pour chaque image de conteneur dans votre application. Les identifiants suivants sont requis pour toutes les applications :

    • Image principale : cette image de conteneur est l'image principale de votre produit, elle utilise le même identifiant que celui-ci. Par exemple, si votre identifiant de produit est example-pro, l'image principale utilise le même identifiant.
    • deployer : image du conteneur de déploiement destinée au canal. Le conteneur de déploiement s'exécute lorsque les utilisateurs déploient votre application à partir de Google Cloud Console. Vous créez une image de déploiement lorsque vous créez votre package d'application.

Par exemple, pour son produit Example Pro, l'entreprise Examplesoft Inc. choisit les identifiants suivants :

Nom Identifiant
Société Examplesoft Inc examplesoft
Produit Example Pro example-pro
Image [1] (primaire) Serveur Example Pro N/A
Image [2] File d'attente Example example-queue
Image [deployer] Non disponible deployer
Canal de publication [1] Version 4.xx 4.0
Canal de publication [2] Version 5.xx 5,0

Pour ces identifiants, les informations suivantes sont générées automatiquement :

  • URL du produit dans Google Cloud Marketplace : https://console.cloud.google.com/marketplace/details/examplesoft/example-pro

  • URI de l'image du conteneur :

    • marketplace.gcr.io/examplesoft/example-pro:4.0
    • marketplace.gcr.io/examplesoft/example-pro/example-queue:4.0
    • marketplace.gcr.io/examplesoft/example-pro/deployer:4.0
    • marketplace.gcr.io/examplesoft/example-pro:5.0
    • marketplace.gcr.io/examplesoft/example-pro/example-queue:5.0
    • marketplace.gcr.io/examplesoft/example-pro/deployer:5.0