Skip to content

Commit fa821a6

Browse files
improve replicator doc (#1705)
Co-authored-by: Harsh Mishra <[email protected]>
1 parent 5ad0807 commit fa821a6

File tree

1 file changed

+25
-12
lines changed
  • content/en/user-guide/tools/aws-replicator

1 file changed

+25
-12
lines changed

Diff for: content/en/user-guide/tools/aws-replicator/index.md

+25-12
Original file line numberDiff line numberDiff line change
@@ -37,24 +37,33 @@ These operations can be limited by creating a minimal IAM role with just the pol
3737

3838
See the [supported resources section](#supported-resources) for details of what policy actions are required for each resource.
3939

40-
Replication is triggered using the LocalStack CLI, which must run in a shell configured to access AWS.
41-
If you have the aws-cli v2 installed, the cli will read credentials from your configured `AWS_PROFILE`.
40+
When the replication is triggered using the LocalStack CLI, which must run in a shell configured to access AWS.
41+
Here are some options:
4242

43-
Otherwise, the following environment variables must be set:
43+
{{< tabpane text=true >}}
44+
{{< tab header="AWS CLI v2" >}}
45+
{{% markdown %}}
46+
47+
If you have the AWS CLI v2 installed, the CLI will read credentials from your configured `AWS_PROFILE`.
48+
49+
{{< command >}}
50+
$ export AWS_PROFILE=my-aws-profile
51+
$ localstack replicator ...
52+
{{< /command >}}
53+
54+
{{% /markdown %}}
55+
{{< /tab >}}
56+
{{< tab header="AWS CLI v1" >}}
57+
{{% markdown %}}
58+
If you have the AWS CLI v1 installed or no installation of the AWS CLI, the following environment variables must be set:
4459

4560
- `AWS_ACCESS_KEY_ID`
4661
- `AWS_SECRET_ACCESS_KEY`
4762
- `AWS_SESSION_TOKEN` (optional)
4863
- `AWS_DEFAULT_REGION`
49-
50-
{{< callout "tip" >}}
51-
Use `aws configure export-credentials --format env` to print the required environment variables in a format that can be evaluated.
52-
53-
{{< command >}}
54-
<disable-copy>$ </disable-copy>eval $(AWS_PROFILE=<aws-profile> aws configure export-credentials \
55-
--format env)
56-
{{< /command >}}
57-
{{< /callout >}}
64+
{{% /markdown %}}
65+
{{< /tab >}}
66+
{{< /tabpane >}}
5867

5968
### Trigger a replication job
6069

@@ -306,6 +315,10 @@ Use the `--target-account-id` flag to specify a different account.
306315

307316
## Supported Resources
308317

318+
The project is still in preview state and we welcome feedback and bug reports.
319+
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.
320+
For any other requests or reports, please open a [new github issue](https://github.com/localstack/localstack/issues/new/choose).
321+
309322
{{< callout "tip" >}}
310323
To ensure support for all resources, use the latest LocalStack Docker image.
311324
{{< /callout >}}

0 commit comments

Comments
 (0)