Difference between revisions of "Terraform S3 backend"
Jump to navigation
Jump to search
↑ https://www.terraform.io/docs/language/settings/backends/s3.html#key
↑ https://www.terraform.io/docs/language/settings/backends/s3.html#key
| (20 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | [[Terraform]] [[S3]] backend. | + | [[Terraform]] [[S3]] [[backend]]. |
* https://www.terraform.io/docs/language/settings/backends/s3.html | * https://www.terraform.io/docs/language/settings/backends/s3.html | ||
| − | == Basic S3 example == | + | == Basic S3 examples in [[backend.tf]] == |
| + | terraform { | ||
| + | backend "s3" { | ||
| + | [[bucket]] = "[[aws s3 ls|your-terraform-states]]" | ||
| + | [[Terraform S3 backend|key]]<ref>https://www.terraform.io/docs/language/settings/backends/s3.html#key</ref> = "[[terraform.tfstate]]" | ||
| + | [[Terraform S3 backend: profile|profile]] = "your-profile" | ||
| + | } | ||
| + | } | ||
| + | |||
| + | https://www.terraform.io/docs/language/settings/backends/s3.html#example-configuration | ||
| + | terraform { | ||
| + | backend "s3" { | ||
| + | [[bucket]] = "mybucket" | ||
| + | [[key]] = "path/to/my/key" | ||
| + | [[region]] = "us-east-1" | ||
| + | } | ||
| + | } | ||
| + | |||
| + | |||
| + | #This simple example will prompt you for bucket name once you executed [[terraform init]] | ||
terraform { | terraform { | ||
backend "s3" { | backend "s3" { | ||
| − | |||
| − | |||
| − | |||
} | } | ||
} | } | ||
| − | == Example including DynamoDB table == | + | == Example including [[DynamoDB]] table == |
terraform { | terraform { | ||
backend "s3" { | backend "s3" { | ||
| Line 24: | Line 40: | ||
* <code>[[profile]]</code>: https://www.terraform.io/docs/language/settings/backends/s3.html#profile | * <code>[[profile]]</code>: https://www.terraform.io/docs/language/settings/backends/s3.html#profile | ||
| − | * <code>key</code>: path to the [[state file]] inside the [[S3 Bucket]]. https://www.terraform.io/docs/language/settings/backends/s3.html#key | + | * <code>[[key]]</code>: path to the [[state file]] inside the [[S3 Bucket]]. https://www.terraform.io/docs/language/settings/backends/s3.html#key |
Successfully configured the backend "s3"! Terraform will automatically | Successfully configured the backend "s3"! Terraform will automatically | ||
| Line 31: | Line 47: | ||
== S3 backend errors == | == S3 backend errors == | ||
| − | * [[Error: Backend configuration changed]] | + | * <code>[[Error: Backend configuration changed]]</code> |
| − | * [[Error: Failed to get existing workspaces: S3 bucket does not exist.]]: <code>[[aws s3 mb]]</code> | + | * <code>[[Error: Failed to get existing workspaces: S3 bucket does not exist.]]</code>: <code>[[aws s3 mb]]</code> |
| + | * <code>[[Error: no valid credential sources for S3 Backend found]]</code> | ||
| + | |||
| + | == Changelog == | ||
| + | * [[Terraform versions|1.6.0]] (Oct 2023) https://github.com/hashicorp/terraform/blob/v1.6/CHANGELOG.md#160-october-4-2023 | ||
== Related terms == | == Related terms == | ||
| Line 40: | Line 60: | ||
* <code>[[terraform_remote_state]]</code> [[data source]] | * <code>[[terraform_remote_state]]</code> [[data source]] | ||
* <code>[[aws s3api create-bucket]]</code> and <code>[[aws s3 mb]]</code> | * <code>[[aws s3api create-bucket]]</code> and <code>[[aws s3 mb]]</code> | ||
| + | * <code>[[aws s3 ls]]</code> | ||
| + | * <code>[[provider.tf]]</code> | ||
| + | * [[Terraform backend: gcs]] | ||
== See also == | == See also == | ||
Latest revision as of 14:02, 3 July 2024
Contents
Basic S3 examples in backend.tf[edit]
terraform {
backend "s3" {
bucket = "your-terraform-states"
key[1] = "terraform.tfstate"
profile = "your-profile"
}
}
https://www.terraform.io/docs/language/settings/backends/s3.html#example-configuration
terraform {
backend "s3" {
bucket = "mybucket"
key = "path/to/my/key"
region = "us-east-1"
}
}
#This simple example will prompt you for bucket name once you executed terraform init terraform { backend "s3" { } }
Example including DynamoDB table[edit]
terraform {
backend "s3" {
bucket = "your-terraform-states"
key[2] = "terraform.tfstate"
region = "us-west-2"
dynamodb_table = "your-terraform-states"
profile = "your-profile"
workspace_key_prefix = "your-workspace"
}
}
profile: https://www.terraform.io/docs/language/settings/backends/s3.html#profilekey: path to the state file inside the S3 Bucket. https://www.terraform.io/docs/language/settings/backends/s3.html#key
Successfully configured the backend "s3"! Terraform will automatically use this backend unless the backend configuration changes. Error refreshing state: AccessDenied: Access Denied status code: 403, request id: JDK297FD1E5GY3TT, host id: JJJ1ThvIKmNSYOO3h2IZFECn9l8DnsofwXWk4F6a9/nzrqgNNbOzyw9d2PcAXSb4DDYwkr/VNWZ0
S3 backend errors[edit]
Error: Backend configuration changedError: Failed to get existing workspaces: S3 bucket does not exist.:aws s3 mbError: no valid credential sources for S3 Backend found
Changelog[edit]
Related terms[edit]
terraform init- Bucket versioning
- Remote state backends to manage Terraform state
terraform_remote_statedata sourceaws s3api create-bucketandaws s3 mbaws s3 lsprovider.tf- Terraform backend: gcs
See also[edit]
- Terraform configuration files, Terraform state files:
.tf,.tfvars,main.tf, outputs.tf,variables.tf,.terraform.d/,terraform init,providers.tf,.terraform/,terraform.tfstate,.terraform.lock.hcl,terraform.tfstate.d, override.tf, versions.tf - Terraform backends:
S3,Terraform S3 backend: dynamodb table,GCS
Advertising:
