From 2073f8fcc075d79005fe30f294dd55910544b84d Mon Sep 17 00:00:00 2001 From: Pulumi Bot <30351955+pulumi-bot@users.noreply.github.com> Date: Mon, 23 Oct 2023 15:48:39 -0700 Subject: [PATCH] Publish Package Metadata awscontroltower@v0.0.2 (#3369) * Publish Package Metadata for awscontroltower@v0.0.2 * **auto-fix relref lint errors** * fix short code --------- Co-authored-by: pulumi-bot Co-authored-by: Sean Holung --- .../packages/awscontroltower/_index.md | 55 +++++++++++++++++++ .../installation-configuration.md | 52 ++++++++++++++++++ .../registry/packages/awscontroltower.yaml | 14 +++++ 3 files changed, 121 insertions(+) create mode 100644 themes/default/content/registry/packages/awscontroltower/_index.md create mode 100644 themes/default/content/registry/packages/awscontroltower/installation-configuration.md create mode 100644 themes/default/data/registry/packages/awscontroltower.yaml diff --git a/themes/default/content/registry/packages/awscontroltower/_index.md b/themes/default/content/registry/packages/awscontroltower/_index.md new file mode 100644 index 0000000000..0225d146f5 --- /dev/null +++ b/themes/default/content/registry/packages/awscontroltower/_index.md @@ -0,0 +1,55 @@ +--- +title: AWS Control Tower +meta_desc: Provides an overview of the AWS Control Tower package for Pulumi +layout: overview +--- + +The AWS Control Tower provider for Pulumi can be used to provision AWS account with [AWS Control Tower](https://aws.amazon.com/controltower/). + +The AWS Control Tower provider must be configured with the required permissions to manage AWS accounts in AWS Control Tower. + +## Example + +{{< chooser language "typescript,python" >}} +{{% choosable language typescript %}} + +```typescript + +import * as controltower from "@lbrlabs/pulumi-awscontroltower"; + +const account = new controltower.ControlTowerAwsAccount("account", { + organizationalUnit: "Production", + email: "mail@example.com", + name: "Some User", + organizationalUnitIdOnDelete: "ou-48hfnvbc-ufo", + closeAccountOnDelete: true, + sso: { + firstName: "Some", + lastName: "User", + email: "mail@example.com", + }, +}); +``` + +{{% /choosable %}} +{{% choosable language python %}} + +```python +import lbrlabs_pulumi_aws_controltower as controltower + +account = controltower.ControlTowerAwsAccount( + "account", + organizational_unit="Production", + email="mail@example.com", + name="Some User", + organizational_unit_id_on_delete="ou-48hfnvbc-ufo", + close_account_on_delete=True, + sso={ + "firstName": "Some", + "lastName": "User", + "email": "mail@example.com" + } +``` + +{{% /choosable %}} +{{< /chooser >}} \ No newline at end of file diff --git a/themes/default/content/registry/packages/awscontroltower/installation-configuration.md b/themes/default/content/registry/packages/awscontroltower/installation-configuration.md new file mode 100644 index 0000000000..313c056f53 --- /dev/null +++ b/themes/default/content/registry/packages/awscontroltower/installation-configuration.md @@ -0,0 +1,52 @@ +--- +title: AWS Control Tower Installation & Configuration +meta_desc: Information on how to install the AWS Control Tower provider. +layout: package +--- + +## Installation + +The Pulumi AWS Control Tower provider is available as a package in all Pulumi languages: + +* JavaScript/TypeScript: [`@lbrlabs/pulumi-awscontroltwer`](https://www.npmjs.com/package/@lbrlabs/pulumi-awscontroltwer) +* Python: [`lbrlabs_pulumi_aws_controltwer`](https://pypi.org/project/lbrlabs-pulumi-aws-controltower/) +* Go: [`github.com/lbrlabs/pulumi-awscontroltower/sdk/go/controltwer`](https://pkg.go.dev/github.com/lbrlabs/pulumi-awscontroltower/sdk) +* .NET: [`Lbrlabs.PulumiPackage.Scaleway`](https://www.nuget.org/packages/Lbrlabs.PulumiPackage.Awscontroltower) + +### Provider Binary + +The AWS control tower provider binary is a third party binary. It can be installed using the `pulumi plugin` command. + +```bash +pulumi plugin install resource awscontroltower --server github://api.github.com/lbrlabs +``` + +Replace the version string with your desired version. + +## Setup + +The AWS control tower uses the AWS SDK to connect to AWS. Many of the authentication options you're familiar with using [Pulumi AWS)(https://www.pulumi.com/registry/packages/aws/) apply here. + +{{< chooser os "macos,windows" >}} +{{% choosable os macos %}} + +```bash +$ export AWS_ACCESS_KEY_ID= +$ export AWS_SECRET_ACCESS_KEY= +``` + +{{% /choosable %}} + +{{% choosable os windows %}} + +```powershell +> $env:AWS_ACCESS_KEY_ID = "" +> $env:AWS_SECRET_ACCESS_KEY = "" +``` + +{{% /choosable %}} +{{< /chooser >}} + +## Configuration Options + +Use `pulumi config set awscontroltower: