Indiquer les versions
Indiquez et épinglez les versions de Terraform, du fournisseur OCI Terraform et des modules.
Terraform, le fournisseur Oracle Cloud Infrastructure (OCI) Terraform et les modules Terraform que vous appelez dans vos fichiers de configuration introduisez tous des modifications ou ajoutez de nouvelles fonctionnalités régulièrement. Au moment où ces modifications sont apportées, de nouvelles versions sont publiées.
Pour vous assurer que vos configurations sont appliquées de manière cohérente aux ressources OCI, vous pouvez définir explicitement la version de ces composants dans les fichiers de configuration Terraform.
Version de l'interface de ligne de commande Terraform
Si votre configuration Terraform exige que vous utilisiez une version particulière de l'interface de ligne de commande Terraform, vous pouvez l'indiquer dans le bloc terraform
à l'aide du paramètre required_version
. Exemples :
terraform {
required_version = ">= 0.12.16"
}
Pour plus d'informations, reportez-vous à Spécification d'une version requise de Terraform.
Resource Manager gère la version de Terraform en fonction de la version de la pile. Toute version de l'interface de ligne de commande spécifiée est ignorée par Resource Manager.
Version du fournisseur
Vous pouvez contrôler la version du fournisseur OCI Terraform utilisée par Terraform lors de ses interactions avec les ressources OCI. Cette capacité est particulièrement utile lorsque votre configuration repose sur des fonctionnalités introduites avec une version particulière du fournisseur ou qu'elle a été testée uniquement avec une version particulière du fournisseur.
Vous pouvez utiliser l'opérateur >=
ou =
pour spécifier la version, en fonction de votre cas d'emploi.
Pour plus d'informations, reportez-vous à Spécification des exigences de fournisseur.
Utilisation de Terraform v0.12 ou versions antérieures
Terraform v0.12 ou version antérieure permet d'indiquer version
dans le bloc provider
. Exemples :
provider "oci" {
version = ">= 3.27.0"
region = "${var.region}"
…
}
Utilisation de Terraform v0.13
Terraform v0.13 a abandonné version
dans les blocs provider
. A la place, les versions doivent être indiquées dans un bloc required_providers
. Exemples :
terraform {
required_providers {
oci = {
source = "hashicorp/oci"
version = ">= 4.0.0"
}
}
...
}
Version du module
En plus de la version de l'interface de ligne de commande Terraform et du fournisseur OCI Terraform, vous pouvez également spécifier la version des modules Terraform.
Si un module a été mis à niveau pour utiliser une version plus récente du noyau Terraform, mais que vous utilisez toujours une version antérieure de Terraform, vous pouvez spécifier une version compatible du module. Si vos configurations ont été testées uniquement avec une version spécifique du module, vous pouvez spécifier cette version pour assurer la compatibilité.
Les modules acceptent l'argument version
. Exemples :
module "oke" {
source = "oracle-terraform-modules/oke/oci"
version = "1.0.0"
# insert required variables here
}
Pour plus d'informations, reportez-vous à la section Module Blocks.