Créer votre package de déploiement

Cette section décrit les étapes à suivre pour créer des packages de déploiement pour votre solution. Les packages de déploiement sont importés via le portail des partenaires et sont requis pour envoyer votre solution de VM.

Un déploiement est un ensemble de ressources créées et gérées ensemble, telles que les ressources nécessaires à votre solution. Un package ou un modèle 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 cette solution particulière. Deployment Manager vous permet de créer des modèles et des packages de déploiement pour vos solutions de VM à l'aide de fichiers de configuration YAML, JSON ou ProtoText simples.

Si votre solution est un déploiement simple d'une seule instance de machine virtuelle avec des règles de pare-feu de base, vous pouvez configurer votre package de déploiement directement dans le portail Partner.

Dans la plupart des cas, nous vous recommandons de générer les packages Deployment Manager à l'aide de l'outil Open Source deploymentmanager-autogen de Deployment Manager. Avec Deployment Manager, votre package de déploiement inclut les fonctionnalités suivantes :

  • Les quotas vérifient les processeurs et les GPU, afin que les utilisateurs ne puissent pas déployer votre solution s'ils dépassent les exigences de quota.
  • Mises à jour de prix dynamiques dans la page Deployment Manager.
  • Compatibilité avec les VPC partagés.
  • Compatibilité avec les VM avec plusieurs cartes d'interface réseau.
  • Possibilité d'empêcher les utilisateurs de choisir des types de machines, des GPU ou des sous-réseaux qui ne sont pas disponibles dans la zone de leur choix.

Avant de commencer

 Caution: Your deployment must not use Terraform, or have any dependencies
 on Terraform.
  • Installez Docker, afin de pouvoir créer et exécuter Autogen à partir des images Docker publiées.

    Si vous préférez créer Autogen à partir de son code source, suivez les étapes du dépôt Autogen GitHub.

  • Configurez un alias de ligne de commande pour Autogen.

Pour ce faire, entrez les informations suivantes :

alias autogen='docker run \
  --rm \
  --workdir /mounted \
  --mount type=bind,source="$(pwd)",target=/mounted \
  --user $(id -u):$(id -g) \
  gcr.io/cloud-marketplace-tools/dm/autogen'

autogen --help

Créez votre fichier de configuration Autogen

Nous vous recommandons de créer votre fichier de configuration initial en modifiant l'exemple dans le dossier example-config du dépôt Autogen.

Les commentaires dans le fichier de configuration et les fichiers proto (autogen.proto, deployment_package_autogen_spec.proto et marketing_info.proto) contiennent des informations sur les champs, y compris ceux qui sont obligatoires ou facultatifs. Si vous générez un package de déploiement pour une seule solution, votre fichier de configuration doit respecter les spécifications du proto DeploymentPackageInput. Si vous générez un package de déploiement pour plusieurs solutions, votre fichier de configuration doit respecter les spécifications du proto BatchInput. Ces deux spécifications se trouvent dans autogen.proto.

Pour créer votre fichier de configuration, modifiez chacun des champs de l'exemple de fichier de configuration afin d'indiquer la configuration de votre solution, puis exécutez Autogen sur votre fichier de configuration modifié.

D'autres exemples de configuration sont également disponibles dans le dossier testdata.

Générer votre package de déploiement

Voici un exemple de commande qui lit la spécification dans example-config/solution.yaml et génère un package dans un dossier appelé solution-folder :

mkdir solution_folder

autogen \
  --input_type YAML \
  --single_input example-config/solution.yaml \
  --output_type PACKAGE \
  --output solution_folder

Pour exécuter Autogen à partir de la ligne de commande, vous devez inclure l'un des deux paramètres suivants :

  • --single_input, si vous générez un package pour une solution
  • --batch_input, si vous générez des packages pour plusieurs solutions

Vous pouvez également utiliser des paramètres facultatifs, tels que --input_type et --output_type, pour spécifier les formats d'écriture et de lecture d'Autogen. Pour en savoir plus sur toutes les options possibles, consultez la documentation sur Autogen.

Une fois votre package de déploiement créé, vous pouvez compresser le dossier solution_folder, puis télécharger ce fichier compressé sur le portail Partner.

Créer des packages Deployment Manager simples dans le portail Partner

Les solutions qui sont de simples déploiements d'instances de machine virtuelle unique avec des règles de pare-feu de base peuvent avoir leurs packages de déploiement configurés directement dans le portail Partner.

Pour configurer cela, ouvrez le portail Partner et sélectionnez votre solution dans la liste des solutions, puis procédez comme suit :

  1. À côté de Package de déploiement, cliquez sur Modifier.
  2. Sélectionnez Générer un package, puis cliquez sur Continuer.
  3. Sélectionnez votre image de VM à l'aide des listes déroulantes Projet et Image, puis cliquez sur Continuer.
  4. Sélectionnez les paramètres Type de machine minimal et Type de machine par défaut, puis cliquez sur Continuer.
  5. Ajoutez toutes les étapes post-déploiement suivantes que vos clients doivent effectuer, puis cliquez sur Continuer.
  6. Configurez vos règles de pare-feu et d'autres options de mise en réseau, le cas échéant, puis cliquez sur Continuer.
  7. Vous pouvez choisir de déclarer un site ou une URL d'administrateur. Si votre solution nécessite une connexion, vous pouvez configurer les informations de connexion lors de l'envoi de votre solution. Cliquez sur Continuer.
  8. Sous Contenu du package de liste, sélectionnez le Nom du système d'exploitation et la Version du système d'exploitation du système d'exploitation de votre image de VM. Vous pouvez ensuite ajouter un paramètre Nom et une Version pour chaque logiciel supplémentaire inclus dans votre solution. Une fois que vous avez répertorié tout le contenu de votre package, cliquez sur Continuer.
  9. Une fois que vous avez terminé les étapes précédentes, votre package de solution s'affiche sous Examen. Vous pouvez télécharger le package de solution, ou cliquer sur Modifier JSON pour le modifier manuellement. Cliquez sur Enregistrer pour enregistrer le package et revenir à votre solution.

Pour des déploiements plus complexes, vous pouvez créer un déploiement de bout en bout. Si vous ne savez pas quel type de solution convient le mieux à votre projet, contactez votre ingénieur partenaire Google.

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 solution, pour les solutions basées sur des modèles de solution 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 solution, 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 solution apparaîtra à vos clients une fois qu'ils l'ont déployée avec succès.

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.