Spécification de versions

Indiquez et associez 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 introduisent tous des modifications ou ajoutent de nouvelles fonctionnalités de temps à autre. Au fur et à mesure que 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. Par exemple :

terraform {
    required_version = ">= 0.12.16"
}

Pour plus d'informations, reportez-vous à Spécification d'une version requise de Terraform.

Remarque

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. Par exemple :

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. Par exemple :

terraform {
    required_providers {
        oci = {
            source  = "hashicorp/oci"
            version = ">= 4.0.0"
        }
    }
    ...
}

Version de 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. Par exemple :

module "oke" {
    source  = "oracle-terraform-modules/oke/oci"
    version = "1.0.0"
    # insert required variables here
}

Pour plus d'informations, reportez-vous à Blocs de module.