Object Storage - Gérer un bucket Object Storage avec Terraform

Objectif

Ce tutoriel vous montre comment utiliser l'API compatible Object Storage - S3¹ avec Terraform. Terraform est un outil open source permettant d'orchestrer la provision et la mise à disposition des ressources.

Prérequis

• Installation de la CLI Terraform
• Accès à l'API OVHcloud (créez vos identifiants en consultant ce guide)
• Un projet Public Cloud dans votre compte OVHcloud.
• OVHcloud fournit un Terraform provider qui est disponible dans le registre officiel de Terraform. Vous devez avoir installé une version >= 2.0. Vous pouvez suivre le guide Comment utiliser Terraform sur le Public Cloud OVHcloud.

Obtenir des informations sur vos jetons API

Le « provider OVH » doit être configuré avec un ensemble d'informations d'identification :

• une application_key
• une application_secret
• une consumer_key

Pourquoi ?

Parce que, dans les coulisses, le « OVH Terraform provider » fait des requêtes aux API d'OVHcloud.

Afin de récupérer ces informations nécessaires, veuillez suivre le tutoriel Premiers pas avec les API OVHcloud.

Lorsque vous avez généré avec succès vos tokens OVHcloud, conservez-les. Vous devrez les utiliser dans les minutes à venir.

La dernière information nécessaire est le service_name : c'est l'ID de votre projet Public Cloud.

Comment l'obtenir ?

Dans la section Public Cloud, vous pouvez récupérer l'ID de votre nom de service grâce au bouton Copier dans le presse-papier.

Vous utiliserez également ces informations dans les fichiers de définition des ressources Terraform.

En pratique

Si vous souhaitez accéder à la documentation du provider sur Object Storage, cliquez-ici

Configuration

Tout d'abord, créez un fichier provider.tf avec la version minimale, le point de terminaison européen (ovh-eu) et les clés que vous avez obtenues dans ce guide.

Terraform :

terraform {
  required_providers {
    ovh = {
      source  = "ovh/ovh"
      version = "~> 2.1" # greater than or equal to 2.1
    }
  }
}

provider "ovh" {
  endpoint           = "ovh-eu"
  application_key    = "<application_key>"
  application_secret = "<application_secret>"
  consumer_key       = "<consumer_key>"
}

Ici, nous avons défini le point de terminaison ovh-eu parce que nous voulons appeler l'API OVHcloud Europe, mais d'autres points de terminaison existent, en fonction de vos besoins :

• ovh-eu pour l'API OVHcloud Europe
• ovh-us pour l'API OVHcloud US
• ovh-ca pour l'API OVHcloud Amérique du Nord

Créer un bucket

Vous pouvez créer un fichier nommé object_storage_simple.tf et écrire ce qui suit :

# Créer un bucket Object Storage
resource "ovh_cloud_project_storage" "my_bucket" {
  service_name = "<service_name>" # Remplacer par votre OVHcloud project ID
  region_name  = "GRA" # Remplacer par la région voulue en majuscule.
  name         = "object-storage-simple"
  versioning = {
    status = "enabled"
  }
  encryption = {
    sse_algorithm = "AES256"
  }
}

Vous pouvez créer votre ressource en entrant la commande suivante :

terraform apply

Supprimer un bucket

Vous pouvez supprimer votre bucket ainsi que tout les objets qu'il contient en entrant la commande suivante :

terraform destroy

Aller plus loin

Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur ce lien pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services.

Échangez avec notre communauté d'utilisateurs.

¹ : S3 est une marque déposée appartenant à Amazon Technologies, Inc. Les services de OVHcloud ne sont pas sponsorisés, approuvés, ou affiliés de quelque manière que ce soit.