diff --git a/content/en/user-guide/tools/aws-replicator/index.md b/content/en/user-guide/tools/aws-replicator/index.md index 010e4eba5b..fb0709f997 100644 --- a/content/en/user-guide/tools/aws-replicator/index.md +++ b/content/en/user-guide/tools/aws-replicator/index.md @@ -37,24 +37,33 @@ These operations can be limited by creating a minimal IAM role with just the pol See the [supported resources section](#supported-resources) for details of what policy actions are required for each resource. -Replication is triggered using the LocalStack CLI, which must run in a shell configured to access AWS. -If you have the aws-cli v2 installed, the cli will read credentials from your configured `AWS_PROFILE`. +When the replication is triggered using the LocalStack CLI, which must run in a shell configured to access AWS. +Here are some options: -Otherwise, the following environment variables must be set: +{{< tabpane text=true >}} +{{< tab header="AWS CLI v2" >}} +{{% markdown %}} + +If you have the AWS CLI v2 installed, the CLI will read credentials from your configured `AWS_PROFILE`. + +{{< command >}} +$ export AWS_PROFILE=my-aws-profile +$ localstack replicator ... +{{< /command >}} + +{{% /markdown %}} +{{< /tab >}} +{{< tab header="AWS CLI v1" >}} +{{% markdown %}} +If you have the AWS CLI v1 installed or no installation of the AWS CLI, the following environment variables must be set: - `AWS_ACCESS_KEY_ID` - `AWS_SECRET_ACCESS_KEY` - `AWS_SESSION_TOKEN` (optional) - `AWS_DEFAULT_REGION` - -{{< callout "tip" >}} -Use `aws configure export-credentials --format env` to print the required environment variables in a format that can be evaluated. - -{{< command >}} -$ eval $(AWS_PROFILE= aws configure export-credentials \ - --format env) -{{< /command >}} -{{< /callout >}} +{{% /markdown %}} +{{< /tab >}} +{{< /tabpane >}} ### Trigger a replication job @@ -306,6 +315,10 @@ Use the `--target-account-id` flag to specify a different account. ## Supported Resources +The project is still in preview state and we welcome feedback and bug reports. +We have opened a [github issue where you can request and upvote](https://github.com/localstack/localstack/issues/12439) to help us prioritize our efforts and support the resources with the most impact. +For any other requests or reports, please open a [new github issue](https://github.com/localstack/localstack/issues/new/choose). + {{< callout "tip" >}} To ensure support for all resources, use the latest LocalStack Docker image. {{< /callout >}}