Configurer votre image de VM pour le déploiement de Deployment Manager

Si vous choisissez de gérer le déploiement à l'aide de Deployment Manager pour votre produit de VM, procédez comme suit.

Attention : La fonctionnalité Actions de Deployment Manager n'est pas compatible. Si vous en avez besoin pour votre produit, demandez de l'aide auprès du Partner Support Desk et incluez le mot "Marketplace" dans votre description. Pour en savoir plus sur Partner Support Desk, consultez la page Demander de l'aide concernant Cloud Marketplace.

Déterminer comment créer le 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 les produits de VM simples, tels que les déploiements sur une VM unique avec des règles de pare-feu de base, mais pas avec 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.

Nous vous déconseillons d'utiliser des modèles de déploiement personnalisés que vous avez créés sans la console Google Cloud ni l'outil Deployment Manager Autogen avec Cloud Marketplace. Nous vous recommandons de créer votre package de déploiement directement dans la console Google Cloud.

Basculer entre la configuration guidée et la configuration manuelle

Si vous utilisez l'option de configuration guidée de Producer Portal et souhaitez par la suite passer à la configuration manuelle de votre package de déploiement, cliquez sur Accéder à 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.

Remarque :Lorsque vous basculez entre la configuration guidée et la configuration manuelle de votre package de déploiement, vous annulez toutes les validations en cours d'exécution pour votre méthode de configuration précédente.

Terminer la configuration guidée

Pour terminer la configuration et l'envoi d'un package de déploiement simple à l'aide de la console Google Cloud, procédez comme suit:

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

2. Sous Configuration de Deployment Manager, en regard 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. Voici les conséquences de la création d'un bucket:

   • Sélectionnez un nom pour le bucket.
   • Spécifiez la ou les régions dans lesquelles le bucket stocke les données.
   • Indiquez la classe de stockage pour vos données.
   • Déterminez le niveau de précision à appliquer aux autorisations IAM (Identity and Access Management) 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.

3. Assurez-vous d'activer la gestion des versions des objets pour votre bucket Cloud Storage.

4. Pour enregistrer les paramètres de votre bucket et continuer à configurer votre package de déploiement, cliquez sur Configurer.

5. Sous Choisir 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.

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

7. Si vous le souhaitez, sous Configurer l'accès à la VM, vous pouvez spécifier des URL de site et d'administrateur, ainsi qu'un nom d'utilisateur et un mot de passe, que les utilisateurs pourront utiliser pour accéder à la VM après le déploiement.

8. Sous Configurer la mise en réseau, vous pouvez éventuellement spécifier les paramètres du transfert IP et configurer des règles de pare-feu.

9. Si vous le souhaitez, sous Définir les étapes suivantes, vous pouvez fournir des instructions pour aider les utilisateurs de votre produit à commencer à utiliser votre produit. Ils pourront voir ces instructions une fois qu'ils auront déployé votre produit.

10. Après avoir effectué les étapes précédentes, cliquez sur Generate (Générer) pour créer votre package de déploiement.

    Si vous devez apporter des modifications supplémentaires à votre package de déploiement par la suite, vous pouvez cliquer sur Edit (Modifier) pour apporter des modifications, puis sur Generate (Générer) pour regénérer votre package de déploiement une fois ces modifications appliquées.

    Si vous prévoyez 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 la configuration manuelle.

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

Terminer la configuration manuelle

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 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 package envoyé, il peut s'écouler jusqu'à deux semaines avant qu'il soit examiné et approuvé par Google.

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

Avant de commencer

Si vous utilisez 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 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 :

• Activez la gestion des versions des objets pour le bucket afin d'empêcher la suppression ou le remplacement de votre package de déploiement.
• Attribuez le rôle Lecteur des objets Storage (roles/storage.objectViewer) à [e-mail].

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:[e-mail]:objectViewer" $BUCKET_NAME
  

Où 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é (IDE) afin de modifier et de valider les fichiers configurations.yaml.

Remarque : Si votre déploiement contient plusieurs VM, vous pouvez créer et personnaliser votre spécification Autogen en fonction des exigences de votre dépôtmulti VM example.

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 cet 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
   

   Où 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 des 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 d'Autogen.

Générer un package de déploiement

Après avoir créé et personnalisé la spécification Autogen, utilisez-la pour générer les fichiers de modèle Deployment Manager pour votre package de déploiement. Pour stocker le package, importez-le 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 :

   Remarque :Vous pouvez exécuter la commande suivante si vous avez utilisé l'un des Autogen specification examples dans le dépôt marketplace-tools. Si vous avez créé votre spécification Autogen manuellement, vous devez modifier directement le fichier de spécification pour mettre à jour l'emplacement de sortie.

   mpdev cfg set zipPath gs://BUCKET_NAME/OBJECT
   

   Où 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 vous avez correctement configuré le modèle, créez 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

Une fois le package de déploiement créé et configuré, vous devez l'envoyer à Producer Portal pour que l'équipe Cloud Marketplace puisse l'examiner et l'approuver.

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

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

3. Cliquez sur Valider. Le processus de validation peut prendre jusqu'à deux heures. Vous pouvez quitter l'écran pendant l'opération.

4. Une fois que Producer Portal a lu votre package de déploiement, vous pouvez cliquer sur Aperçu du déploiement pour voir comment le client voit la configuration de votre VM.

5. Une fois la validation terminée, cliquez sur Envoyer pour envoyer le package de déploiement pour examen. Une fois le package envoyé, il peut s'écouler jusqu'à deux semaines avant que Google l'examine et l'approuve.