Ce document explique comment utiliser des modèles externes hébergés sur Internet plutôt que sur votre machine locale dans votre déploiement.
Vous pouvez stocker des modèles sur un hôte externe n'importe où sur Internet et les appeler depuis votre configuration. L'hébergement de modèles en externe présente certains avantages par rapport au stockage local :
- Vous pouvez partager facilement des modèles avec d'autres utilisateurs.
- Vous êtes sûr que les configurations utilisent toujours le modèle le plus récent.
- Vous pouvez gérer automatiquement les importations et les schémas pertinents.
Deployment Manager récupère toujours la dernière version des modèles externes chaque fois que vous redéployez votre configuration. Si vous assurez la maintenance de vos modèles, vos déploiements seront toujours à jour eux aussi. Deployment Manager gère également pour vous l'importation d'autres modèles dépendants si ceux-ci sont référencés dans le modèle externe.
Exemple
Cette configuration importe un modèle externe :
resources:
- name: my-frontend
type: gs://my-frontend-templates/webserver-frontend.jinja
Avant de commencer
- Si vous voulez vous servir des exemples de ligne de commande de ce guide, installez l'outil de ligne de commande gcloud.
- Si vous voulez utiliser les exemples d'API de ce guide, configurez l'accès aux API.
- Consultez la documentation propre à la création d'une configuration.
- Consultez la documentation sur les modèles.
Héberger des modèles externes
Vous pouvez héberger des modèles externes dans Google Cloud Storage ou à un emplacement accessible publiquement, tel que GitHub. Tant qu'il existe une URL renvoyant vers le fichier et que vous avez accès aux modèles, Deployment Manager peut le télécharger. Si le fichier importe d'autres modèles à l'aide d'un schéma, vous devez également héberger ces modèles dans la même URL de base.
Dans Google Cloud Storage
Pour héberger des modèles dans Google Cloud Storage :
- Créez un bucket pour les modèles ou utilisez un bucket existant.
- Importez vos modèles et fichiers de modèles associés (tels que des schémas) dans le bucket.
- Si vous prévoyez d'utiliser les modèles d'un projet Google Cloud Platform différent de celui auquel appartiennent les modèles, définissez des autorisations d'accès.
Héberger des modèles dans Google Cloud Storage vous permet de contrôler les utilisateurs pouvant y accéder. Vous pouvez en effet définir des options de contrôle des accès sur le bucket Cloud Storage respectif ou sur le modèle spécifique.
En revanche, vous devez rendre vos modèles largement disponibles pour pouvoir les héberger sur d'autres URL accessibles publiquement.
Sur une URL accessible publiquement
Vous pouvez également héberger des modèles externes en dehors de Google Cloud Storage, à condition qu'ils soient accessibles publiquement. Vous pouvez par exemple héberger des modèles sur GitHub et les référencer à l'aide de l'URL GitHub.
Dans le cas de GitHub, vous devez fournir l'URL GitHub brute pour que Deployment Manager récupère le modèle au lieu de la page HTML GitHub. Une URL brute ressemble à ceci :
https://raw.githubusercontent.com/GoogleCloudPlatform/deploymentmanager-samples/master/examples/v2/single_vm/jinja/vm_template.jinja
Appeler un modèle externe
Appelez un modèle externe comme vous appelleriez un modèle local, mais fournissez l'URL complète du fichier modèle en tant que type. Exemple :
resources:
- name: my-salt-cluster
type: gs://v2/saltstack/salt_cluster.jinja
Pour une URL GitHub :
resources:
- name: my-salt-cluster
type: https://raw.githubusercontent.com/GoogleCloudPlatform/deploymentmanager-samples/master/examples/v2/single_vm/vm_template.jinja
Si un modèle externe importe d'autres modèles ou si un schéma l'accompagne, vous pouvez conserver les fichiers associés dans le même répertoire ou sous-répertoire relatif et inclure ces autres modèles avec une URL relative. Deployment Manager recherchera ces modèles à l'aide du chemin relatif dérivé de l'URL de base.
Par exemple, si votre configuration ressemble à ceci :
resources:
- name: my-salt-cluster
type: gs://v2/saltstack/salt_cluster.jinja
Et qu'un fichier de schéma nommé salt_cluster.jinja.schema a importé ces fichiers :
imports:
- path: minion.py
- path: master.py
- path: examples/source/example.py
Alors Deployment Manager télécharge et importe automatiquement tous les fichiers nécessaires au modèle.