Utiliser des variables d'environnement consacrées au déploiement

Pour chacun de vos déploiements, Deployment Manager crée des variables d'environnement prédéfinies qui contiennent des informations déterminées d'après votre déploiement. Utilisez ces variables d'environnement dans vos modèles Python ou Jinja2 pour obtenir des informations sur votre projet ou déploiement.

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.
• Assurez-vous d'avoir bien compris comment créer un modèle de base.
• Assurez-vous d'avoir bien compris comment créer une configuration.

Variables d'environnement disponibles

Les variables d'environnement suivantes sont automatiquement définies par Deployment Manager. Elles sont remplacées par des valeurs appropriées partout où vous les utilisez dans vos modèles. Par exemple, utilisez la variable project_number pour ajouter le numéro de projet au nom d'un compte de service.

Variable d'environnement	Valeur
deployment	Le nom du déploiement.
name	Le nom (name) déclaré dans la configuration qui utilise le modèle. Cela peut être utile si vous souhaitez que le nom que vous déclarez dans la configuration corresponde au nom de la ressource définie dans les modèles sous-jacents.
project	L'ID du projet concerné par le déploiement.
project_number	Le numéro de projet associé au déploiement.
current_time	L'horodatage UTC : cette valeur indique le moment où le déploiement a débuté.
type	Le type de ressource déclaré dans la configuration de premier niveau.
username	L'utilisateur actuel de Deployment Manager.

Utiliser une variable d'environnement

Utilisez la syntaxe suivante pour ajouter des variables d'environnement à vos modèles :

{{ env["deployment"] }} # Jinja

context.env["deployment"] # Python

Dans votre modèle, utilisez les variables comme dans ces exemples :

Jinja

- type: compute.v1.instance
  name: vm-{{ env["deployment"] }}
  properties:
    machineType: zones/us-central1-a/machineTypes/f1-micro
    serviceAccounts:
    - email: {{ env['project_number'] }}[e-mail]
      scopes:
      - ...

Python

def GenerateConfig(context):
  resources = []
  resources.append ({
    'name': 'vm-' + context.env["deployment"],
    'type': 'compute.v1.instance',
    'properties': {
       'serviceAccounts': [{
         'email': context.env['project_number'] + '[e-mail]',
         'scopes': [...]
       }]
    }
    ...}]
  return {'resources': resources}

Étapes suivantes

• Ajoutez un modèle qui sera associé de façon permanente à votre projet en tant que type composite.
• Héberger des modèles en externe pour les partager avec d'autres utilisateurs
• Ajouter des schémas pour vous assurer que les utilisateurs interagissent correctement avec vos modèles