Créer votre package de déploiement

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Cette page décrit les étapes à suivre pour créer un package de déploiement pour votre produit de machine virtuelle (VM). Vous devez créer et envoyer le package de déploiement pour publier votre produit sur Google Cloud Marketplace.

Un déploiement est un ensemble de ressources créées et gérées ensemble, telles que les ressources nécessaires à votre produit. Un package de déploiement est une spécification pour un ensemble de ressources qui sont généralement déployées ensemble, ce qui simplifie le processus de déploiement de ce produit particulier.

Dans ce guide, vous créez votre package de déploiement à l'aide de Deployment Manager. Deployment Manager vous permet de créer des packages de déploiement pour vos produits de VM à l'aide de fichiers de configuration YAML, JSON ou ProtoText simples.

Déterminer comment créer votre package de déploiement

Nous vous recommandons d'utiliser l'option de configuration guidée de Producer Portal pour créer votre package de déploiement directement dans la console Google Cloud.

La configuration guidée est compatible avec des produits de VM simples, tels que les déploiements de VM uniques avec des règles de pare-feu de base, mais elle n'accepte pas certaines fonctionnalités complexes, telles que les déploiements avec plusieurs VM et les champs de configuration personnalisés. Si vous avez besoin de fonctionnalités non compatibles avec la configuration guidée, vous pouvez utiliser l'outil Open Source mpdev pour créer votre package de déploiement ou pour personnaliser un package existant en y ajoutant des fonctionnalités supplémentaires.

Basculer entre la configuration guidée et la configuration manuelle

Si vous utilisez l'option de configuration guidée de Producer Portal et souhaitez ensuite passer à la configuration manuelle de votre package de déploiement, vous pouvez cliquer sur ACCÉDER À LA CONFIGURATION MANUELLE pour passer à la configuration manuelle.

Lorsque vous basculez, vous pouvez télécharger la spécification Autogen pour le package de déploiement que vous avez créé dans la configuration guidée. Elle vous servira de base pour votre configuration manuelle.

Avant de commencer

  1. Assurez-vous que votre déploiement n'utilise pas Terraform ou ne comporte aucune dépendance sur Terraform.

  2. Si vous utilisez l'outil mpdev pour créer votre package de déploiement, procédez comme suit :

    1. Installez l'outil mpdev en suivant les instructions du dépôt marketplace-tools.
    2. Téléchargez le SDK Google Cloud.

Créer et envoyer votre package de déploiement

La section suivante explique comment créer votre package de déploiement et l'envoyer à Google pour examen.

Créez le package de déploiement en utilisant l'une des méthodes suivantes:

Créer un package de déploiement à l'aide de la console Google Cloud

Pour créer et envoyer un package de déploiement simple à l'aide de la console Google Cloud:

  1. Dans Producer Portal, accédez à la section Package de déploiement.

  2. Sélectionnez Configuration guidée pour les solutions simples, puis cliquez sur CONTINUER.

  3. Dans la section Configurer la spécification Autogen, à côté du champ de saisie intitulé Bucket Cloud Storage, cliquez sur PARCOURIR.

    Si vous avez déjà créé un bucket Cloud Storage, sélectionnez-le ici.

    Si vous n'avez pas de bucket Cloud Storage, cliquez sur l'icône Créer un bucket. Lorsque vous créez un bucket:

    • Sélectionnez un nom pour le bucket.
    • Spécifiez la ou les régions dans lesquelles le bucket stockera les données.
    • Indiquez la classe de stockage pour vos données.
    • Déterminez le niveau de granularité à appliquer aux autorisations Identity and Access Management (IAM) pour les données du bucket.
    • Configurez des paramètres avancés facultatifs, tels que le chiffrement ou les règles de conservation des données.
  4. Assurez-vous que la gestion des versions d'objets est activée pour votre bucket Cloud Storage.

  5. Pour enregistrer les paramètres de votre bucket et commencer à configurer le package de déploiement, cliquez sur CONFIGURER.

  6. Sous Choisir l'image de votre produit, sélectionnez votre image de VM.

    L'image de VM que vous sélectionnez doit être :

    • associée à votre projet Google Cloud actuel ;

    • Il doit être associé à la bonne licence pour votre produit. Vous devez créer et associer cette licence lorsque vous créez votre image de VM.

  7. Sous Sélectionner le type de machine, vous devez spécifier une zone par défaut, un type de machine minimal et un type de machine par défaut pour votre produit de VM, ainsi que la taille et le type de son disque de démarrage.

  8. Sous Spécifier le système d'exploitation, vous devez spécifier le nom et la version de l'OS de votre image de VM, ainsi que le numéro de version de l'image de VM.

  9. Sous Configurer l'accès à la VM, vous pouvez éventuellement spécifier des URL de site et d'administrateur, ainsi qu'un nom d'utilisateur et un mot de passe permettant aux utilisateurs d'accéder à la VM après le déploiement.

  10. Sous Configurer la mise en réseau, vous pouvez également spécifier des paramètres de Transfert IP et configurer des règles de pare-feu.

  11. Sous Définir les étapes suivantes, vous pouvez éventuellement fournir des instructions aux utilisateurs de votre produit pour les guider dans leurs premiers pas. Ces instructions leur seront présentées une fois le produit déployé.

  12. Une fois les étapes précédentes effectuées, cliquez sur GÉNÉRER pour créer le package de déploiement.

    Si vous devez apporter des modifications supplémentaires à votre package de déploiement ultérieurement, vous pouvez cliquer sur EDIT (MODIFIER), puis sur GENERATE (Générer) pour regénérer le package de déploiement avec ces modifications.

    Si vous envisagez de passer à la configuration manuelle, vous pouvez cliquer sur TÉLÉCHARGER pour télécharger la spécification Autogen du package de déploiement que vous avez créé dans la configuration guidée et l'utiliser comme base pour votre configuration manuelle.

  13. Envoyez le package de déploiement pour examen dans Producer Portal. Une fois le colis envoyé, il peut s'écouler jusqu'à deux semaines avant que Google ne l'examine et ne l'approuve.

Créer un package de déploiement à l'aide de mpdev

Cette section explique comment utiliser l'outil mpdev pour créer un package de déploiement et l'envoyer pour examen.

L'outil mpdev utilise l'outil Autogen de Deployment Manager pour générer les modèles Deployment Manager de votre package de déploiement. L'outil génère le package de déploiement en fonction d'une spécification Autogen qui contient les entrées de configuration de votre produit de VM.

En règle générale, pour générer et envoyer votre package de déploiement, vous devez effectuer les opérations suivantes :

  1. Créer et configurer un bucket Cloud Storage pour stocker et gérer l'accès au package de déploiement.
  2. Créer une spécification Autogen qui inclut les détails de l'image et les exigences de déploiement pour votre produit de VM.
  3. Générer le package de déploiement basé sur vos spécifications Autogen, puis les importer dans le bucket Cloud Storage.
  4. Envoyez le package de déploiement pour examen dans Producer Portal. Une fois le colis envoyé, Google peut mettre jusqu'à deux semaines pour l'examiner et l'approuver.

Les sections suivantes expliquent comment générer et envoyer votre package de déploiement.

Créer un bucket Cloud Storage

Vous devez créer le bucket Cloud Storage dans le même projet Google Cloud public que celui utilisé pour Producer Portal et le configurer comme suit :

Pour créer et configurer un bucket Cloud Storage, exécutez les commandes gsutil suivantes :

  BUCKET_NAME=YOUR_BUCKET_NAME
  gsutil mb $BUCKET_NAME
  gsutil versioning set on gs://$BUCKET_NAME
  gsutil iam ch "group:cloud-commerce-marketplace-onboarding@twosync-src.google.com:objectViewer" $BUCKET_NAME
  

YOUR_BUCKET_NAME correspond au nom que vous indiquez pour le nouveau bucket, ce nom étant soumis à des consignes de dénomination.

Créer une spécification Autogen

Pour créer votre spécification Autogen, nous vous recommandons d'utiliser single VM example dans le dépôt marketplace-tools comme spécification Autogen initiale, puis de la personnaliser à l'aide des détails de configurationvotre de votre VM.

Pour les cas d'utilisation plus complexes, vous pouvez configurer la saisie semi-automatique dans certains environnements de développement intégrés (IDE) afin de faciliter la modification et la validation des fichiers configurations.yaml.

Pour créer votre spécification Autogen à partir de single VM example, procédez comme suit :

  1. Consultez la spécification Autogen préconfigurée de l'exemple dans un répertoire local :

    PACKAGE=YOUR_PACKAGE_NAME
    mpdev pkg get https://github.com/GoogleCloudPlatform/marketplace-tools.git/examples/deployment-manager/autogen/singlevm $PACKAGE
    

    YOUR_PACKAGE_NAME est le nom que vous fournissez pour le répertoire local. Par exemple, my-deployment-package.

  2. Mettez à jour la spécification avec les détails de configuration de votre VM en modifiant le fichier configurations.yaml avec les informations suivantes :

    • Nom de votre image de VM
    • Le ID du projet Google Cloud public qui héberge votre image de VM, qui est le même que celui que vous utilisez pour Producer Portal

    Pour connaître les étapes de mise à jour de l'image de la VM et des champs du projet Google Cloud dans le fichier configurations.yaml, reportez-vous au fichier README.md de single VM example.

  3. Si nécessaire pour votre produit, personnalisez les champs supplémentaires, tels que passwords, deployInput et postDeploy. Ces champs se trouvent sous DeploymentSpec dans le fichier configurations.yaml. Pour en savoir plus sur les champs pouvant être personnalisés, consultez la documentation de référence Autogen.

Générer un package de déploiement

Après avoir créé et personnalisé la spécification Autogen, vous allez l'utiliser pour générer les fichiers de modèle Deployment Manager de votre package de déploiement. Pour stocker le package, vous devez l'importer dans le bucket Cloud Storage.

Pour générer et importer votre package de déploiement, procédez comme suit :

  1. Définissez l'emplacement de sortie du package de déploiement dans votre bucket Cloud Storage :

    mpdev cfg set zipPath gs://BUCKET_NAME/OBJECT
    

    BUCKET_NAME est le nom du bucket que vous avez créé pour le package ;OBJECT est le nom que vous fournissez pour l'objet Cloud Storage, ce nom étant soumis à des consignes concernant l'attribution des noms.

  2. Générez le package de déploiement :

    mpdev apply -f $PACKAGE/configurations.yaml
    

Le package de déploiement généré est compressé et importé dans votre bucket.

Pour vérifier que le modèle est correctement configuré, vous pouvez créer un déploiement en exécutant la commande suivante :

  TMPDIR=$(mktemp -d)
  unzip $PACKAGE/template.zip -d $TMPDIR
  gcloud deployment-manager deployments create $PACKAGE --config $TMPDIR/test_config.yaml
  

Envoyer votre package de déploiement pour examen dans Producer Portal

Si vous utilisez Producer Portal pour créer votre fiche produit Cloud Marketplace, vous devez envoyer le package à Producer Portal une fois le package de déploiement créé afin que l'équipe Cloud Marketplace puisse l'examiner et l'approuver.

Pour envoyer votre package de déploiement pour examen :

Configuration guidée

  1. Dans Producer Portal, accédez à la section Package de déploiement.

  2. Pour envoyer le package de déploiement pour examen dans Producer Portal, cliquez sur Envoyer. Une fois le colis envoyé, Google peut mettre jusqu'à deux semaines pour l'examiner et l'approuver.

Configuration manuelle

  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 du projet public que vous avez créé pour Cloud Marketplace, par exemple my-organization-public.

  2. Dans la liste des produits, cliquez sur le nom de votre produit.

  3. Sur la page Présentation de votre produit, accédez à la section Package de déploiement, puis cliquez sur MODIFIER.

  4. Sous Spécifier l'emplacement de votre objet Cloud Storage, sélectionnez l'objet du package de déploiement que vous avez précédemment importé.

  5. Cliquez sur Valider. Le processus de validation peut prendre jusqu'à deux heures, et vous pouvez quitter l'écran une fois lorsque l'opération est en cours.

  6. Une fois que Producer Portal a lu correctement votre package de déploiement, vous pouvez cliquer sur DÉPLOYER L'APERÇU pour afficher la configuration de votre VM comme le client la verra.

  7. Une fois la validation terminée, cliquez sur ENVOYER pour envoyer le package de déploiement. Une fois le colis envoyé, Google peut l'examiner et l'approuver jusqu'à deux semaines.

Vue client des packages de déploiement

Les sections suivantes présentent les dispositions d'écran que vos clients voient lorsqu'ils déploient votre produit, pour les solutions basées sur des packages de produit standards générés automatiquement.

Vue client du déploiement d'un package

Les éléments client d'entrée standards sont affichés sur le côté gauche de la capture d'écran suivante et comprennent la zone, le type de machine, les options de disque et les options de mise en réseau.

Si le déploiement d'un client nécessite plusieurs cartes d'interface réseau, le client peut ajouter des interfaces réseau supplémentaires en cliquant sur Ajouter une interface réseau.

Pour déployer votre produit, vos clients doivent remplir les champs de saisie, puis cliquer sur Déployer.

Vue client d'un package déployé

L'image suivante vous montre comment votre produit apparaît à vos clients après leur déploiement.

Les éléments de sortie standards sont affichés sur le côté droit de la capture d'écran suivante et comprennent l'adresse du site, le mot de passe administrateur temporaire et les informations sur les instances.