Présentation des déploiements, des versions et des aperçus

Cette page décrit les déploiements et les révisions, y compris les éléments suivants :

  • Liste des métadonnées stockées pour chaque déploiement.
  • Format du nom du déploiement et du nom de la révision.

Déploiements

Infra Manager provisionne les ressources sur Google Cloud en tant que déploiement.

Un déploiement peut provisionner Google Cloud des ressources vers plusieurs emplacements et plusieurs projets. Remarques :

  • Les ressources spécifiques doivent être disponibles dans les emplacements. Par exemple, consultez la page Emplacements Cloud Run pour obtenir la liste des emplacements où Cloud Run est disponible.
  • Le compte de service doit disposer des autorisations requises pour effectuer le déploiement dans les projets spécifiés. Pour en savoir plus, consultez Configurer le compte de service.

Métadonnées de déploiement

Infra Manager crée un bucket de stockage dans le projet et l'emplacement où il est exécuté. Une fois le déploiement créé, les artefacts Infrastructure Manager se trouvent dans ce bucket de stockage, qui porte le nom suivant : gs://PROJECT_NUMBER-LOCATION-blueprint-config.

Infra Manager utilise le terme plan pour désigner une configuration Terraform.

Où vous devez remplacer les éléments suivants :

  • PROJECT_ID : ID du projet dans lequel Infra Manager est exécuté.
  • LOCATION : emplacement où Infra Manager est exécuté.

Les artefacts de déploiement dans le bucket de stockage incluent les éléments suivants :

  • Journaux Cloud Build
  • Journaux Terraform.
  • Une copie de la configuration Terraform.

Infra Manager stocke également une copie du fichier d'état Terraform. Pour en savoir plus sur le fichier d'état, y compris sur la façon d'y accéder, consultez Gérer le fichier d'état Terraform.

Les révisions sont des versions d'un déploiement. Infra Manager stocke donc ces métadonnées de déploiement pour chaque révision.

ID de déploiement

L'ID de déploiement est l'identifiant spécifié par l'utilisateur pour une ressource de déploiement. Utilisez l'ID de déploiement pour faire référence à un déploiement au format suivant :

projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID

Remplacez les éléments suivants :

  • PROJECT_ID est l'ID du projet dans lequel Infra Manager s'exécute.
  • LOCATION correspond à l'emplacement où Infra Manager s'exécute. Consultez la liste des emplacements valides dans Emplacements Infrastructure Manager.
  • DEPLOYMENT_ID est l'ID de déploiement, qui est un nom spécifié par l'utilisateur. Cet ID doit :
    • Le nom ne doit contenir que des lettres minuscules, des chiffres ou des traits d'union.
    • Commencer par une lettre
    • se terminer par un chiffre ou une lettre minuscule ;
    • Ne peut pas être la chaîne archived-deployments ni archived-previews
    • Doit être unique dans le projet et l'emplacement où Infra Manager est exécuté.

Exemple :

projects/my-project/locations/us-central1/deployments/my-deployment

Révisions

Les révisions sont des versions d'un déploiement. Lorsque vous créez un déploiement pour la première fois, il s'agit également d'une révision dont l'ID est r-0.

Nom de la révision

Lorsque vous créez un déploiement Infra Manager, l'identifiant de révision r-0 lui est automatiquement attribué. Si vous mettez à jour le déploiement, Infrastructure Manager crée une révision avec l'identifiant r-1. À chaque nouvelle révision, l'identifiant augmente d'une unité. L'identifiant de révision ne peut être défini que par Infrastructure Manager.

Par exemple, un nom de révision peut être :

projects/my-project/locations/us-central1/deployments/my-deployment/revisions/r-1

Aperçus

Un aperçu décrit les actions à effectuer pour activer une configuration Terraform spécifique. Avant de créer ou de mettre à jour un déploiement, vous pouvez le prévisualiser pour vérifier les ressources qui doivent être provisionnées.

Prévisualiser les métadonnées

Infra Manager crée un bucket de stockage dans le projet et l'emplacement où il est exécuté. Une fois l'aperçu créé, les artefacts Infra Manager se trouvent dans ce bucket de stockage, qui porte le nom suivant : gs://PROJECT_NUMBER-LOCATION-blueprint-config.

Pour prévisualiser un nouveau déploiement, les métadonnées sont organisées avec un préfixe new-previews, par exemple : gs://PROJECT_NUMBER-LOCATION-blueprint-config/new-previews/preview-name

Vous pouvez également prévisualiser une mise à jour d'un déploiement existant. Pour ces aperçus ciblant un déploiement existant, les artefacts sont stockés dans le même bucket de stockage que les artefacts de déploiement. Le bucket de stockage nommé gs://PROJECT_ID-LOCATION-blueprint-config/deployment-ID/previews/preview-ID.

Infrastructure Manager utilise le terme blueprint pour désigner une configuration Terraform.

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet dans lequel Infra Manager est exécuté.
  • LOCATION : emplacement où Infra Manager est exécuté.

Les artefacts d'aperçu du bucket de stockage incluent les éléments suivants :

  • Journaux Cloud Build
  • Journaux Terraform.
  • Une copie de la configuration Terraform.

Nom de l'aperçu

Le format du nom de l'aperçu est le suivant :

projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID

Où :

  • PROJECT_ID est l'ID du projet dans lequel Infra Manager s'exécute.
  • LOCATION correspond à l'emplacement où Infra Manager s'exécute. Consultez la liste des emplacements valides dans Emplacements Infrastructure Manager.
  • PREVIEW_ID est l'identifiant de l'aperçu. Il s'agit d'un nom spécifié par l'utilisateur. Ce nom doit :
    • Le nom ne doit contenir que des lettres minuscules, des chiffres ou des traits d'union.
    • Commencer par une lettre
    • se terminer par un chiffre ou une lettre minuscule ;
    • Ne peut pas être la chaîne archived-deployments ni archived-previews
    • Doit être unique dans le projet et l'emplacement où Infra Manager est exécuté.

Exemple :

projects/my-project/locations/us-central1/previews/my-preview

Étapes suivantes