feat: introduce-variable-org-stage

docs/admin-guide.md

@@ -212,6 +212,16 @@ Config has five components in `main-notification-endpoint`, `scp`, `scm`,
     `master` instead. We recommend configuring the main scm branch name to
     `main`. As new repositories will most likely use this branch name as their
     default branch.
+- `org` configures settings in case of staged multi-organization ADF deployments.
+  - `stage` defines the AWS Organization stage in case of staged multi-
+    organization ADF deployments. This is an optional setting. In enterprise-
+    grade deployments, it is a common practice to define an explicit dev, int and 
+    prod AWS Organization with its own ADF instance per AWS organization. This 
+    approach allows for well-tested and stable prod AWS Organization deployments. 
+    If set, a matching SSM parameter `/adf/org/stage` gets creates that you can 
+    reference in your buildspec files to allow for org-specific deployments; without 
+    hardcoding the AWS Organization stage in your buildspec. If this variable is not 
+    set, the SSM parameter `/adf/org/stage` defaults to "none".
 
 ## Accounts
 

src/lambda_codebase/initial_commit/adfconfig.yml.j2

@@ -27,3 +27,6 @@ config:
   scm:
     auto-create-repositories: enabled
     default-scm-branch: main
+  #org:
+    # Optional: Use this variable to define the AWS Organization in case of staged multi-organization ADF deployments
+    #stage: dev

src/lambda_codebase/initial_commit/bootstrap_repository/adf-build/main.py

@@ -56,6 +56,7 @@
     "ACCOUNT_BOOTSTRAPPING_STATE_MACHINE_ARN"
 )
 ADF_DEFAULT_SCM_FALLBACK_BRANCH = 'master'
+ADF_DEFAULT_ORG_STAGE = "none"
 LOGGER = configure_logger(__name__)
 
 
@@ -151,6 +152,13 @@ def prepare_deployment_account(sts, deployment_account_id, config):
             ADF_DEFAULT_SCM_FALLBACK_BRANCH,
         )
     )
+    deployment_account_parameter_store.put_parameter(
+        '/adf/org/stage',
+        config.config.get('org', {}).get(
+            'stage',
+            ADF_DEFAULT_ORG_STAGE,
+        )
+    )
     auto_create_repositories = config.config.get(
         'scm', {}).get('auto-create-repositories')
     if auto_create_repositories is not None: