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 des ressources sur Google Cloud en tant que déploiement.

Un déploiement peut provisionner des ressources Google Cloud dans plusieurs emplacements et pour 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 le déploiement dans les projets spécifiés. Pour en savoir plus, consultez la section 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ù Infra Manager est exécuté. Une fois le déploiement créé, les artefacts Infrastructure Manager se trouvent dans ce bucket de stockage nommé gs://PROJECT_NUMBER-LOCATION-blueprint-config.

Infra Manager utilise le terme blueprint (modèle) pour désigner une configuration Terraform.

Remplacez les éléments suivants:

  • PROJECT_ID: ID du projet sur lequel Infra Manager s'exécute.
  • 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 comment y accéder, consultez la section 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.

Nom du déploiement

Le format du nom de déploiement est le suivant:

projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID

Où :

  • PROJECT_ID correspond à l'ID du projet dans lequel Infra Manager s'exécute.
  • LOCATION correspond à l'emplacement où Infra Manager s'exécute. Pour connaître la liste des emplacements valides, consultez la section Emplacements Infrastructure Manager.
  • DEPLOYMENT_ID est l'identifiant de déploiement, qui est un nom spécifié par l'utilisateur. Ce nom doit :
    • Ne 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 ou 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 et son ID de révision 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 nouvelle 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 déclencher 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 planifiées à provisionner.

Prévisualiser les métadonnées

Infra Manager crée un bucket de stockage dans le projet et l'emplacement où Infra Manager est exécuté. Une fois l'aperçu créé, les artefacts Infra Manager se trouvent dans ce bucket de stockage nommé 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.

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet sur lequel Infra Manager s'exécute.
  • 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 correspond à l'ID du projet dans lequel Infra Manager s'exécute.
  • LOCATION correspond à l'emplacement où Infra Manager s'exécute. Pour connaître la liste des emplacements valides, consultez la section Emplacements Infrastructure Manager.
  • PREVIEW_ID est l'identifiant de déploiement, qui est un nom spécifié par l'utilisateur. Ce nom doit :
    • Ne 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 ou 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

Étape suivante