Si vous choisir de prendre en charge le déploiement avec Deployment Manager pour votre produit de VM, vous devez suivre la procédure 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 la console Google Cloud.
La configuration guidée est compatible avec les produits de VM simples,
avec des règles de pare-feu de base, mais il n'est pas compatible avec certaines
telles que les déploiements avec plusieurs VM et les configurations
. 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 créés sans à l'aide de la console Google Cloud ou de 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 passez à 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 méthode console Google Cloud, procédez comme suit:
Dans Producer Portal, accédez à la section Deployment package (Package de déploiement).
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 libellée Créez 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 à la 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.
Assurez-vous d'avoir activé la gestion des versions d'objets pour votre bucket Cloud Storage.
Pour enregistrer les paramètres de votre bucket et continuer à configurer votre déploiement cliquez sur Configure (Configurer).
Sous Choisissez le type de machine, vous devez spécifier une zone par défaut. Minimum machine type (Type de machine minimal) et Default machine type (Type de machine par défaut) de votre VM ainsi que la taille et le type de son disque de démarrage.
Sous Spécifier le système d'exploitation, vous devez indiquer le nom et la version. de l'OS utilisé par votre image de VM, ainsi que le numéro de version de la VM l'image.
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.
Sous Configurer la mise en réseau, vous pouvez éventuellement spécifier des paramètres pour Transfert IP et configuration des règles de pare-feu.
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. Ils pourront voir ces instructions une fois qu'ils auront déployé votre produit.
Une fois les étapes précédentes effectuées, 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, vous pouvez cliquer sur Modifier pour apporter des modifications, puis sur Générer pour Générez à nouveau votre package de déploiement en y appliquant 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 que vous avez créé dans la configuration guidée, pour l'utiliser pour votre configuration manuelle.
Envoyez le package de déploiement pour examen dans Producer Portal. Une fois votre colis envoyé, il peut s'écouler jusqu'à deux semaines pour que Google examine et approuve le package.
Finaliser la configuration manuelle
Cette section explique comment utiliser l'outil mpdev
pour créer un package de déploiement
et envoyez le package pour examen.
L'outil mpdev
utilise Deployment Manager
Autogen
pour générer les modèles Deployment Manager pour votre déploiement
d'un package. L'outil génère le package de déploiement sur la base d'une
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 :
- Créer et configurer un bucket Cloud Storage pour stocker et gérer l'accès au package de déploiement.
- 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.
- Générer le package de déploiement basé sur vos spécifications Autogen, puis les importer dans le bucket Cloud Storage.
- 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, effectuez la
en suivant les étapes ci-dessous:
Installez l'outil
mpdev
en suivant les instructions du dépôtmarketplace-tools
.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 pour empêcher la suppression de votre package de déploiement remplacé.
- Accordez le rôle Lecteur des objets Storage.
(
roles/storage.objectViewer
) surcloud-commerce-marketplace-onboarding@twosync-src.google.com
Pour créer et configurer un bucket Cloud Storage, exécutez la commande suivante :
Commandes gcloud storage
:
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
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 certaines
environnements de développement (IDE)
pour 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 :
Consultez la spécification Autogen préconfigurée de l'exemple répertoire:
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 pour le répertoire local. Exemple :my-deployment-package
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 des champs d'image de VM et de projet Google Cloud dans
configurations.yaml
, reportez-vous à laREADME.md
desingle VM example
.Si votre produit est obligatoire, personnalisez les champs supplémentaires, tels que
passwords
,deployInput
etpostDeploy
. Ces champs sont situés sous l'DeploymentSpec
dans le fichierconfigurations.yaml
. Pour en savoir plus sur les champs pouvant être personnalisés, consultez les documentation de référence Autogen).
Générer un package de déploiement
Après avoir créé et personnalisé la spécification Autogen, utilisez la propriété pour générer les fichiers de modèle Deployment Manager pour votre package de déploiement. Pour stocker le package, importez-le dans la section bucket Cloud Storage.
Pour générer et importer votre package de déploiement, procédez comme suit :
Définissez l'emplacement de sortie du package de déploiement dans votre bucket Cloud Storage :
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.
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 envoyer le à Producer Portal afin que l'équipe Cloud Marketplace puisse examiner et approuver le package.
Dans Producer Portal, accédez à la section Deployment package (Package de déploiement).
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é.
Cliquez sur Valider. Le processus de validation peut prendre jusqu'à deux heures est terminée, et vous pouvez quitter l'écran pendant qu'elle est terminée.
Une fois que Producer Portal a bien lu votre package de déploiement, cliquez sur Aperçu du déploiement pour Découvrez comment le client voit la configuration de vos VM.
Une fois la validation terminée, envoyez le déploiement. pour examen, cliquez sur Envoyer. Une fois le colis envoyé, l'examen et l'approbation du package par Google peuvent prendre jusqu'à deux semaines.