Sur cette page
Automatiser avec le fournisseur Terraform Patrii
Le fournisseur Terraform Patrii décrit vos réseaux, instances, volumes, DNS, répartiteurs de charge et plus encore sous forme de code, pour réviser, reproduire et versionner votre infrastructure.
Déclarez le fournisseur, transmettez-lui un identifiant d'application par des variables d'environnement, puis lancez terraform plan et terraform apply comme d'habitude. Chaque guide de service de cette documentation présente les ressources correspondantes à côté des étapes dans la console et la CLI.
PATRII_APPLICATION_CREDENTIAL_ID et PATRII_APPLICATION_CREDENTIAL_SECRET. La CLI Patrii utilise des noms plus courts, PATRII_APP_CREDENTIAL_ID et PATRII_APP_CREDENTIAL_SECRET; définissez les deux paires si un même pipeline utilise les deux outils.Avant de commencer
- Terraform installé sur votre poste ou dans votre pipeline.
- Un identifiant d'application pour le projet visé, créé depuis Identifiants d'application dans votre compte ou le menu d'actions du projet.
Étape par étape
- Déclarez le fournisseur
Ajoutez le bloc
required_providerset un blocprovider "patrii"à votre configuration. - Fournissez l'identifiant
Exportez l'ID et le secret de l'identifiant d'application. Les variables facultatives
PATRII_PROJECT_ID,PATRII_PROJECT_NAME,PATRII_REGIONetPATRII_AUTH_URLcorrespondent aux attributs du fournisseur du même nom. - Planifiez et appliquez
Lancez
terraform init, révisezterraform plan, puis lancezterraform apply.
Exemples
terraform {
required_providers {
patrii = {
source = "PatriiCloud/patrii"
}
}
}
provider "patrii" {
auth_url = "https://api.patrii.cloud"
# region, project_id and the credential come from the environment
}export PATRII_APPLICATION_CREDENTIAL_ID=<credential-id> export PATRII_APPLICATION_CREDENTIAL_SECRET=<credential-secret> export PATRII_PROJECT_ID=<project-id> # facultatif : l'identifiant est propre au projet export PATRII_REGION=<region> # facultatif terraform init terraform plan
Limites et caractéristiques
Réglages du fournisseur :
| Attribut | Variable d'environnement |
|---|---|
auth_url | PATRII_AUTH_URL |
application_credential_id | PATRII_APPLICATION_CREDENTIAL_ID |
application_credential_secret | PATRII_APPLICATION_CREDENTIAL_SECRET |
project_id | PATRII_PROJECT_ID |
project_name | PATRII_PROJECT_NAME |
region | PATRII_REGION |
Bonnes pratiques
- Gardez le secret de l'identifiant hors de vos fichiers
.tfet des sorties de l'état; transmettez-le par l'environnement ou le magasin de secrets de votre pipeline. - Utilisez un identifiant d'application par pipeline pour pouvoir en révoquer un sans briser les autres.
Pour aller plus loin
Tout ce que vous faites ici dans la console est aussi disponible via l'API Patrii Cloud pour l'automatisation et les scripts.