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

Si vous choisissez de prendre en charge le déploiement avec Deployment Manager pour votre produit de VM, vous devez suivre les étapes ci-dessous.

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 Google Cloud Console.

La configuration guidée est compatible avec les produits de VM simples, tels que les déploiements à une seule VM avec des règles de pare-feu de base, mais elle n'est pas compatible 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 que la configuration guidée n'est pas compatible, vous pouvez utiliser l'outil mpdev Open Source pour créer votre package de déploiement ou pour personnaliser un package existant en y ajoutant des fonctionnalités supplémentaires.

Nous vous déconseillons d'utiliser des modèles de déploiement personnalisés que vous avez créés sans utiliser la console Google Cloud ou l'outil de génération automatique de Deployment Manager 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 ensuite 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.

Finaliser la configuration guidée

Pour terminer la configuration et envoyer 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, à 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, vous:

    • 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'avoir activé la gestion des versions d'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é 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 les URL de site et d'administrateur, ainsi qu'un nom d'utilisateur et un mot de passe que les utilisateurs peuvent utiliser pour accéder à la VM après le déploiement.

  8. Si vous le souhaitez, sous Configurer la mise en réseau, vous pouvez spécifier des paramètres pour le transfert IP et des règles de pare-feu.

  9. Sous Définir les prochaines étapes, vous pouvez éventuellement fournir des instructions aux utilisateurs de votre produit pour les guider dans leur première utilisation. Ces instructions seront visibles une fois qu'il aura déployé votre produit.

  10. Une fois les étapes précédentes effectuées, cliquez sur Générer pour créer votre package de déploiement.

    Si vous devez apporter des modifications supplémentaires à votre package de déploiement ultérieurement, vous pouvez cliquer sur Modifier pour apporter des modifications, puis sur Générer pour régénérer votre package de déploiement une fois les 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 pour le package de déploiement que vous avez créé dans la configuration guidée, afin de l'utiliser comme base pour votre configuration manuelle.

  11. Soumettre le package de déploiement pour examen dans Producer Portal Une fois le package envoyé, Google peut mettre jusqu'à deux semaines à l'examiner et à l'approuver.

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 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é, Google peut mettre jusqu'à deux semaines à l'examiner et à l'approuver.

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 :

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

  BUCKET_NAME=YOUR_BUCKET_NAME
  gcloud storage buckets create gs://$BUCKET_NAME
  gcloud storage buckets update gs://$BUCKET_NAME --versioning
  gcloud storage buckets add-iam-policy-binding gs://$BUCKET_NAME --member=group:cloud-commerce-marketplace-onboarding@twosync-src.google.com --role=roles/storage.objectViewer
  

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 des cas d'utilisation plus complexes, vous pouvez configurer la saisie semi-automatique dans certains environnements de développement intégrés (IDE) pour vous aider à modifier et à valider les 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. 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 disponibles pour la personnalisation, consultez la documentation de référence sur 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 de 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 :

    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 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 que vous avez créé et configuré votre package de déploiement, vous devez l'envoyer à Producer Portal afin que l'équipe Cloud Marketplace puisse l'examiner et 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 précédemment importé.

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

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

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