basic setup

Author: lechnerc77

sample-setup/basic-setup/directory-setup/.terraform.lock.hcl

@@ -1,3 +1,22 @@
 # Sample Setup for a Basic Directory Structure
 
+## Assumptions
 
+- We assume that we use the directories as structuring element for the subaccounts i.e., un an unmanaged fashion.
+- We assume that we do the directory setup in one run for all involved departments.
+
+## Design Decsion
+
+We decouple the directory creation i.e., the setup of the basic structure from the creation of the operational units namely the subaccounts inside of the directory. The changes on directory level are probably a rare sceanrio compared to the subaccounts (depending on their stage) and we therefore want to avoid side effects as well as lengthy state refreshes.
+
+## Directory Setup
+
+We will create directories for the following departments:
+
+- HR
+- Sales
+- Finance
+
+In addition we create a directory for shared services.
+
+All directories are located in EMEA.

sample-setup/basic-setup/directory-setup/README.md

@@ -0,0 +1,8 @@
+module "directory" {
+  source             = "../../modules/base-directory-setup"
+  for_each           = var.directory_inputs
+  business_unit      = each.value.business_unit
+  costcenter         = each.value.costcenter
+  directory_contacts = each.value.directory_contacts
+  region             = each.value.region
+}

sample-setup/basic-setup/directory-setup/main.tf

@@ -0,0 +1,11 @@
+output "directories" {
+  value = {
+    for k, v in module.directory : k => {
+      id            = v.directory_id
+      name          = v.directory_name
+      business_unit = v.business_unit
+      costcenter    = v.costcenter
+      region        = v.region
+    }
+  }
+}

sample-setup/basic-setup/directory-setup/outputs.tf

@@ -0,0 +1,13 @@
+terraform {
+  required_providers {
+    btp = {
+      source  = "SAP/btp"
+      version = "~>1.11.0"
+    }
+  }
+}
+
+# Configure the BTP Provider
+provider "btp" {
+  globalaccount = var.globalaccount
+}

sample-setup/basic-setup/directory-setup/provider.tf

@@ -0,0 +1,22 @@
+variable "globalaccount" {
+  type        = string
+  description = "The subdomain of the global account on SAP BTP"
+}
+
+variable "directory_inputs" {
+  type = map(object({
+    business_unit      = string
+    costcenter         = string
+    directory_contacts = list(string)
+    region             = string
+  }))
+  description = <<-EOT
+    The inputs for the directory module.
+    - `business_unit`: Business unit of the project e.g., HR, IT or Sales
+    - `costcenter`: Cost center to be used for subaccounts
+    - `directory_contacts`: Contact persons to be used for directories, added as label
+    - `region`: The geographical region for a directory. The parameter is optional
+      If you set it the possible values are: `EMEA`, `APAC`, `AMER`.
+      Default value: `null`.
+  EOT
+}

sample-setup/basic-setup/directory-setup/test.tfplan

@@ -0,0 +1,43 @@
+## Requirements
+
+| Name | Version |
+|------|---------|
+| <a name="requirement_terraform"></a> [terraform](#requirement\_terraform) | >= 1.11 |
+| <a name="requirement_btp"></a> [btp](#requirement\_btp) | >= 1.11.0 |
+
+## Providers
+
+| Name | Version |
+|------|---------|
+| <a name="provider_btp"></a> [btp](#provider\_btp) | 1.11.0 |
+
+## Modules
+
+| Name | Source | Version |
+|------|--------|---------|
+| <a name="module_dir_namings"></a> [dir\_namings](#module\_dir\_namings) | ../sap-btp-naming-conventions-directory | n/a |
+
+## Resources
+
+| Name | Type |
+|------|------|
+| [btp_directory.self](https://registry.terraform.io/providers/SAP/btp/latest/docs/resources/directory) | resource |
+
+## Inputs
+
+| Name | Description | Type | Default | Required |
+|------|-------------|------|---------|:--------:|
+| <a name="input_business_unit"></a> [business\_unit](#input\_business\_unit) | Business unit of the project e.g., HR, IT or Sales | `string` | n/a | yes |
+| <a name="input_costcenter"></a> [costcenter](#input\_costcenter) | Cost center to be used for subaccounts | `string` | n/a | yes |
+| <a name="input_directory_contacts"></a> [directory\_contacts](#input\_directory\_contacts) | Contact persons to be used for directory, added as label | `list(string)` | n/a | yes |
+| <a name="input_region"></a> [region](#input\_region) | The geographical region for a directory. The parameter is optional<br/>If you set it the possible values are: `EMEA`, `APAC`, `AMER`.<br/>Default value: `null`. | `string` | `null` | no |
+
+## Outputs
+
+| Name | Description |
+|------|-------------|
+| <a name="output_business_unit"></a> [business\_unit](#output\_business\_unit) | Business unit of the project e.g., HR, IT or Sales |
+| <a name="output_costcenter"></a> [costcenter](#output\_costcenter) | Cost center to be used for subaccounts |
+| <a name="output_directory_id"></a> [directory\_id](#output\_directory\_id) | Technical ID of the directory |
+| <a name="output_directory_name"></a> [directory\_name](#output\_directory\_name) | The name of the directory |
+| <a name="output_region"></a> [region](#output\_region) | The geographical region for a directory. The parameter is optional |

sample-setup/basic-setup/directory-setup/variables.tf

@@ -0,0 +1,14 @@
+module "dir_namings" {
+  source             = "../sap-btp-naming-conventions-directory"
+  business_unit      = var.business_unit
+  costcenter         = var.costcenter
+  directory_contacts = var.directory_contacts
+  region             = var.region
+}
+
+
+resource "btp_directory" "self" {
+  name        = module.dir_namings.directory_name
+  description = module.dir_namings.directory_description
+  labels      = module.dir_namings.directory_labels
+}