Terraform

Ce guide connecte Terraform — l’outil d’infrastructure en tant que code de HashiCorp — à RustFS via le backend S3 : le fichier d’état, et le fichier de verrou qui empêche les exécutions concurrentes, sont stockés comme objets dans RustFS. Vous allez initialiser le backend, appliquer une petite configuration, puis vérifier l’objet d’état dans RustFS. Le flux a été validé avec terraform 1.12.2 et rustfs/rustfs-x86-musl:v2.3.1.

Vous avez besoin d’un déploiement RustFS joignable depuis votre poste de travail (voir les guides sous Installation) et de Terraform 1.10 ou ultérieur, qui prend en charge le verrouillage natif S3 via use_lockfile.

Schéma d’architectureCopy Anchor Link

Le backend S3 stocke le fichier d’état sous le préfixe key dans le compartiment (bucket). Avec use_lockfile = true, Terraform écrit un objet <key>.tflock tant qu’une exécution détient le verrou, ce qui remplace, pour cette configuration, l’ancien verrouillage fondé sur DynamoDB.

mkdir rustfs-terraform
cd rustfs-terraform

terraform {
  backend "s3" {
    bucket                      = "my-bucket"
    key                         = "rustfs-demo/terraform.tfstate"
    region                      = "us-east-1"
    endpoint                    = "http://localhost:9000"
    access_key                  = "<your-access-key>"
    secret_key                  = "<your-secret-key>"
    skip_credentials_validation = true
    skip_region_validation      = true
    skip_metadata_api_check     = true
    skip_requesting_account_id  = true
    force_path_style            = true
    insecure                    = true
    use_lockfile                = true
  }
}

provider "local" {}

resource "local_file" "demo" {
  content  = "provisioned with terraform, state stored in RustFS"
  filename = "${path.module}/demo.txt"
}

terraform init -input=false

Successfully configured the backend "s3"! Terraform will automatically
use this backend unless the backend configuration changes.

terraform apply -auto-approve -input=false

Apply complete! Resources: 1 added, 0 changed, 0 destroyed.

docker run --rm --network <rustfs-network> -v "$PWD:/m" \
  --entrypoint /bin/sh rustfs/rc:latest \
  -c 'rc alias set rustfs http://rustfs:9000 <your-access-key> <your-secret-key> >/dev/null && rc ls rustfs/my-bucket/rustfs-demo --recursive'

[2026-09-21 03:05:03]   1.62 KiB rustfs-demo/terraform.tfstate

terraform plan -input=false

No changes. Your infrastructure matches the configuration.

terraform destroy -auto-approve -input=false

DépannageCopy Anchor Link

« dial tcp: lookup rustfs ... server misbehaving » ou échecs de connexionCopy Anchor Link

endpoint doit être joignable depuis la machine où s’exécute Terraform. À l’intérieur d’un réseau Compose, utilisez http://rustfs:9000 ; depuis l’hôte, http://localhost:9000.

« Bucket cannot have ACLs set » ou erreurs de signatureCopy Anchor Link

skip_credentials_validation, skip_region_validation, skip_metadata_api_check, skip_requesting_account_id, force_path_style et insecure sont tous requis pour un point de terminaison non AWS ; s’il en manque un, le backend s’adresse aux valeurs par défaut d’AWS au lieu de RustFS.

L’état n’apparaît pas dans le compartimentCopy Anchor Link

Vérifiez que le compartiment existe et que les identifiants correspondent aux identifiants RustFS. L’objet d’état apparaît sous le chemin key (rustfs-demo/terraform.tfstate dans ce guide) après le premier init ou apply.

Étapes suivantesCopy Anchor Link

• Consultez les notes de compatibilité S3 avant d’adopter d’autres opérations S3.
• Créez des identifiants de production dédiés avec la gestion des clés d’accès.
• Suivez la documentation du backend S3 de Terraform pour des options telles que les préfixes d’espace de travail et l’emprunt d’un rôle (assume role).