scaleway-terraform-modules · benoit-garcia · May 2, 2023 · May 2, 2023
diff --git a/README.md b/README.md
@@ -3,6 +3,7 @@
 ## Purpose
 
 This repository is used to manage a domain on scaleway using terraform.
+Beware this module *can not* be used to register a new domain. Existing domains must first be imported manually after initializing the terraform project. Refer to examples for more informations.
 
 ## Usage
 

diff --git a/examples/single-domain/README.md → examples/existing-domain/README.md b/examples/single-domain/README.md → examples/existing-domain/README.md
@@ -1,13 +1,14 @@
-# Simple domain
+# Existing domain
 
-This example shows how to manage a single domain named `example.net`.
+This example shows how to import an existing domain named `example.net` in order to manage it.
 
 ## Usage
 
 To run this example you need to execute:
 
 ```bash
 $ terraform init
+$ terraform import domain.scaleway_domain_zone.this example.net
 $ terraform plan
 $ terraform apply
 ```

diff --git a/examples/single-domain/main.tf → examples/existing-domain/main.tf b/examples/single-domain/main.tf → examples/existing-domain/main.tf
diff --git a/examples/single-domain/outputs.tf → examples/existing-domain/outputs.tf b/examples/single-domain/outputs.tf → examples/existing-domain/outputs.tf
diff --git a/examples/single-domain/variables.tf → examples/existing-domain/variables.tf b/examples/single-domain/variables.tf → examples/existing-domain/variables.tf
diff --git a/examples/single-domain/versions.tf → examples/existing-domain/versions.tf b/examples/single-domain/versions.tf → examples/existing-domain/versions.tf
diff --git a/examples/with-subdomain/README.md b/examples/with-subdomain/README.md
@@ -1,6 +1,6 @@
 # Manage a subdomain
 
-This example shows how to manage the domain `exemple.net` along with a subdomain named `contact`.
+This example shows how to manage the domain `contact.example.net`.
 
 ## Usage
 
@@ -32,7 +32,6 @@ Note that this example won't work as the domain name has been reserved by IANA f
 
 | Name | Source | Version |
 |------|--------|---------|
-| <a name="module_root"></a> [root](#module_root) | ../../ | n/a |
 | <a name="module_subdomain"></a> [subdomain](#module_subdomain) | ../../ | n/a |
 
 ## Resources

diff --git a/examples/with-subdomain/main.tf b/examples/with-subdomain/main.tf
@@ -10,13 +10,6 @@ locals {
   subdomain   = "contact"
 }
 
-module "root" {
-  source = "../../"
-
-  domain     = local.domain_name
-  project_id = data.scaleway_account_project.default.id
-}
-
 module "subdomain" {
   source = "../../"
 

diff --git a/examples/with-tem-and-mx/README.md b/examples/with-tem-and-mx/README.md
@@ -1,6 +1,6 @@
 # Complete domain
 
-This example shows how to manage the domain `exemple.net` along with a subdomain named `contact`, setting up transaction email and external MX records on this latest.
+This example shows how to manage the sub-domain `contact.example.net`, setting up transaction email and external MX records.
 
 ## Usage
 
@@ -32,7 +32,6 @@ Note that this example won't work as the domain name has been reserved by IANA f
 
 | Name | Source | Version |
 |------|--------|---------|
-| <a name="module_root"></a> [root](#module_root) | ../../ | n/a |
 | <a name="module_subdomain"></a> [subdomain](#module_subdomain) | ../../ | n/a |
 
 ## Resources

diff --git a/examples/with-tem-and-mx/main.tf b/examples/with-tem-and-mx/main.tf
@@ -10,13 +10,6 @@ locals {
   subdomain   = "contact"
 }
 
-module "root" {
-  source = "../../"
-
-  domain     = local.domain_name
-  project_id = data.scaleway_account_project.default.id
-}
-
 module "subdomain" {
   source = "../../"