Skip to content

Commit aa49952

Browse files
authored
docs: fix AWS Organization import command (#860)
1 parent 434f586 commit aa49952

1 file changed

Lines changed: 14 additions & 5 deletions

File tree

docs/layers/accounts/deploy-accounts.mdx

Lines changed: 14 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ This guide walks through deploying AWS accounts using `atmos` workflows. Before
2222
| Steps | Actions |
2323
| ---------------------------- | --------------------------------------------------------------------------- |
2424
| Validate prerequisites | Review account configuration |
25-
| Import AWS Organization | `atmos workflow deploy/organization -f quickstart/foundation/accounts` |
25+
| Import AWS Organization | `atmos terraform import account -s core-gbl-root ...` |
2626
| Deploy accounts | `atmos workflow deploy/accounts -f quickstart/foundation/accounts` |
2727
| Deploy accounts settings | `atmos workflow deploy/account-settings -f quickstart/foundation/accounts` |
2828
| Finalize account setup | Click Ops (optional) |
@@ -56,14 +56,23 @@ This guide walks through deploying AWS accounts using `atmos` workflows. Before
5656

5757
The AWS Organization was created manually as part of the [Prepare AWS Organization](/layers/accounts/prepare-aws-organization/) guide. Now we need to import this existing organization into Terraform so it can be managed as infrastructure-as-code.
5858

59-
Run the organization workflow, which will import the existing AWS Organization into Terraform state:
59+
Import the existing AWS Organization into Terraform state using the following command. Replace `ORG_ID` with your AWS Organization ID (e.g., `o-abc123def4`):
6060

61-
<AtmosWorkflow workflow="deploy/organization" fileName="quickstart/foundation/accounts" />
61+
```bash
62+
atmos terraform import account -s core-gbl-root "aws_organizations_organization.this[0]" ORG_ID
63+
```
64+
65+
:::info Finding Your Organization ID
66+
You can find your Organization ID in the AWS Console under **AWS Organizations****Settings**, or by running:
67+
```bash
68+
aws organizations describe-organization --query 'Organization.Id' --output text
69+
```
70+
:::
6271

63-
This workflow runs `terraform import` to bring the existing AWS Organization under Terraform management. After this step, all organization-level changes will be managed through Atmos and Terraform.
72+
This command runs `terraform import` to bring the existing AWS Organization under Terraform management. After this step, all organization-level changes will be managed through Atmos and Terraform.
6473

6574
:::tip Verify Import
66-
After the workflow completes, verify the organization was imported successfully:
75+
After the import completes, verify the organization was imported successfully:
6776
```bash
6877
atmos terraform plan account -s core-gbl-root
6978
```

0 commit comments

Comments
 (0)