Versionen angeben
Geben Sie Versionen von Terraform, des OCI-Terraform-Providers und von Modulen an, und pinnen Sie sie.
Terraform, der Oracle Cloud Infrastructure-(OCI-)Terraform-Provider und Terraform-Module, die Sie in Konfigurationsdateien aufrufen, führen allesamt von Zeit zu Zeit Änderungen ein oder fügen neue Funktionen hinzu. Bei diesen Änderungen werden neue Versionen veröffentlicht.
Um sicherzustellen, dass Ihre Konfigurationen konsistent auf OCI-Ressourcen angewendet werden, können Sie die Version dieser Komponenten explizit in Terraform-Konfigurationsdateien festlegen.
Terraform-CLI-Version
Wenn für Ihre Terraform-Konfiguration eine bestimmte Version der Terraform-CLI erforderlich ist, können Sie diese innerhalb des Blocks terraform
mit der Einstellung required_version
angeben. Beispiel:
terraform {
required_version = ">= 0.12.16"
}
Weitere Informationen finden Sie unter Erforderliche Terraform-Version angeben.
Resource Manager verwaltet die Terraform-Version basierend auf der Stackversion. Jede angegebene CLI-Version wird von Resource Manager ignoriert.
Providerversion
Sie können die Version des OCI-Terraform-Providers steuern, die Terraform bei der Interaktion mit OCI-Ressourcen verwendet. Diese Fähigkeit ist besonders hilfreich, wenn Ihre Konfiguration auf Features gestützt ist, die mit einer bestimmten Version des Providers eingeführt wurden, oder die Konfiguration nur mit einer bestimmten Version des Providers getestet wurde.
Je nach Anwendungsfall können Sie den Operator >=
oder =
verwenden, um die Version anzugeben.
Weitere Informationen finden Sie unter Provideranforderungen angeben.
Terraform v0.12 oder früher verwenden
Mit Terraform v0.12 oder früheren Versionen konnten Sie version
im provider
-Block angeben. Beispiel:
provider "oci" {
version = ">= 3.27.0"
region = "${var.region}"
…
}
Terraform v0.13 verwenden
In Terraform v0.13 ist version
in provider
-Blöcken veraltet. Stattdessen müssen Versionen in einem required_providers
-Block angegeben werden. Beispiel:
terraform {
required_providers {
oci = {
source = "hashicorp/oci"
version = ">= 4.0.0"
}
}
...
}
Modulversion
Sie können nicht nur die Version der Terraform-CLI und des OCI-Terraform-Providers, sondern auch die Version von Terraform-Modulen angeben.
Wenn ein Modul für eine neuere Version von Terraform Core upgegradet wurde, Sie aber noch eine frühere Terraform-Version verwenden, können Sie eine kompatible Version des Moduls angeben. Wenn Ihre Konfigurationen nur mit einer bestimmten Version des Moduls getestet wurden, können Sie diese Version angeben, um die Kompatibilität zu gewährleisten.
Module akzeptieren das Argument version
. Beispiel:
module "oke" {
source = "oracle-terraform-modules/oke/oci"
version = "1.0.0"
# insert required variables here
}
Weitere Informationen finden Sie unter Modulblöcke.