feat: 📀 Add S3 creation example (#90)

* feat: 📀 Add S3 creation example

* doc: 📝 Add link to the official object container storage docs

* review: clean with only the necessary providers and config

* fix: mispelling

---------

Co-authored-by: Aurelie Vache <[email protected]>

Author: philippart-s

README.md

@@ -43,6 +43,7 @@ Here is the several topics:
 ├── databases-analytics             ## Here you find demo about databases, data streaming, data integration, ...
 ├── iam                             ## Here you find demo about IAM (roles, identity, ...)
 ├── network                         ## Here you find demo about network (private network, load balancer, gateway, VPS ...)
+├── storage                         ## Here you find demo about storage (object storage, block storage, ...)
 └── use-cases                       ## Here you find use cases (examples using several services: kubernetes, databases...)
 ```
 

storage/README.md

@@ -0,0 +1,9 @@
+# Storage demos
+
+Here you will find some demos on how to use and manage OVHcloud storage products.
+
+## Object storage
+
+> S3 is a registered trademark of Amazon Technologies, Inc. OVHcloud services are not sponsored, approved, or affiliated in any way.
+
+  - How to [create a S-3 compatible objects with Terraform](./s3-with-tf)

storage/s3-with-tf/README.md

@@ -0,0 +1,18 @@
+# Create a simple Object container storage
+
+To run this TF code you need to set some environment variables (mandatory for AWS provider):
+
+```
+export AWS_ACCESS_KEY_ID="<your_access_key>"
+export AWS_SECRET_ACCESS_KEY="<your_secret_access_key>"
+```
+
+
+Run the TF command `terraform apply`:
+```bash
+$ terraform apply
+```
+
+To destroy the bucket with all the objects inside, run the command `terraform destroy`.
+
+For more information about object container storage you can read the [OVHcloud documentation](https://help.ovhcloud.com/csm/en-ie-documentation-storage-object-storage?id=kb_browse_cat&kb_id=38e74da5a884a950f07829d7d5c75217&kb_category=b29021c8e5a5edd0f078850a25104df8&spa=1).

storage/s3-with-tf/create-s3-buckets.tf

@@ -0,0 +1,5 @@
+# Create the bucket, the force_destroy argument will destroy the bucket even if it contains objects
+resource "aws_s3_bucket" "my-bucket-s3" {
+  force_destroy = true
+  bucket = "bucket-name" # the name must be unique within OVHcloud
+}

storage/s3-with-tf/output.tf

@@ -0,0 +1,5 @@
+# Output the Object Storage name after its creation
+
+output "my-bucket-s3" {
+  value = "${aws_s3_bucket.my-bucket-s3.id}"
+}

storage/s3-with-tf/provider.tf

@@ -0,0 +1,21 @@
+terraform {
+  required_providers {
+    aws = {
+      source  = "hashicorp/aws"
+    }
+  }
+}
+
+# Configure the AWS Provider
+provider "aws" {
+  region     = "gra"
+
+  # OVH implementation has no STS service
+  skip_credentials_validation = true
+  skip_requesting_account_id  = true
+  # the gra region is unknown to AWS hence skipping is needed.
+  skip_region_validation = true
+  endpoints {
+    s3 = "https://s3.gra.io.cloud.ovh.net"
+  }
+}