You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/content/docs/aws/tutorials/aws-proxy-localstack-extension.mdx
+26-28Lines changed: 26 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
-
title: "Replicating cloud resources locally with LocalStack's AWS Replicator extension"
3
-
description: Learn how you can replicate cloud resources in your local environment using the LocalStack's AWS Replicator extension. This tutorial provides step-by-step guidance on setting up and leveraging the AWS Replicator extension to mirror cloud services locally, enabling efficient hybrid development and testing workflows without maintaining additional configurations.
description: Learn how you can replicate cloud resources in your local environment using the LocalStack's AWS Cloud Proxy extension. This tutorial provides step-by-step guidance on setting up and leveraging the AWS Cloud Proxy extension to mirror cloud services locally, enabling efficient hybrid development and testing workflows without maintaining additional configurations.
@@ -19,13 +19,13 @@ This allows you to work on and test your cloud-based solutions without needing t
19
19
However, sometimes you might need to smoothly switch between your local setup and actual cloud resources, especially in hybrid scenarios.
20
20
This could be useful, for example, if you want to share a database with your local Lambda function, or if you require access to S3 files stored remotely while running a Glue ETL job locally.
21
21
22
-
With the [AWS Replicator extension](https://github.com/localstack/localstack-extensions/tree/main/aws-replicator), you can:
22
+
With the [AWS Cloud Proxy extension](https://github.com/localstack/localstack-extensions/tree/main/aws-proxy), you can:
23
23
24
24
- Enable your local environment to mirror AWS cloud resources at the API level, allowing for direct interaction with cloud services.
25
25
- Facilitate the forwarding of specific requests from LocalStack to AWS without the need for complex proxy setups.
26
26
- Support scenarios that require a combination of local and cloud resources, such as testing cloud services with local databases or functions.
27
27
28
-
In this tutorial, you will learn how to install the AWS Replicator extension and utilize its different modes to seamlessly work in a hybrid environment.
28
+
In this tutorial, you will learn how to install the AWS Cloud Proxy extension and utilize its different modes to seamlessly work in a hybrid environment.
29
29
30
30
## Prerequisites
31
31
@@ -35,17 +35,17 @@ In this tutorial, you will learn how to install the AWS Replicator extension and
35
35
-[LocalStack Web Application account](https://app.localstack.cloud/sign-up)
36
36
-[AWS Account](https://aws.amazon.com/) with an [`AWS_ACCESS_KEY_ID` & `AWS_SECRET_ACCESS_KEY`](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey)
37
37
38
-
## Install the AWS Replicator extension
38
+
## Install the AWS Cloud Proxy extension
39
39
40
-
To install the AWS Replicator Extension, follow these steps:
40
+
To install the AWS Cloud Proxy Extension, follow these steps:
41
41
42
42
1. Launch your LocalStack container using the `localstack` CLI, ensuring that `LOCALSTACK_AUTH_TOKEN` is available in the environment.
43
43
2. Visit the [Extensions library](https://app.localstack.cloud/extensions/library) page on the LocalStack Web Application.
Once the installation is complete, you will notice that your LocalStack container has restarted with the AWS Replicator extension successfully installed.
48
+
Once the installation is complete, you will notice that your LocalStack container has restarted with the AWS Cloud Proxy extension successfully installed.
49
49
To confirm the installation, execute the following command:
After verifying the successful installation, you can shut down the LocalStack container to re-start it with additional configuration variables.
65
65
66
-
## Tutorial: Working with the AWS Replicator Extension
66
+
## Tutorial: Working with the AWS Cloud Proxy Extension
67
67
68
68
In this tutorial, you will set up a basic example consisting of:
69
69
@@ -74,23 +74,23 @@ In this tutorial, you will set up a basic example consisting of:
74
74
The basic architecture for the scenario is outlined in the figure below.
75
75
It shows the relationship between the resources deployed in the LocalStack container, the LocalStack AWS Proxy, and the remote AWS account.
76
76
77
-

77
+

78
78
79
-
In the following sections, you will create the SQS queue on your local machine and the remote cloud to showcase how you can switch between the two with the AWS Replicator extension.
79
+
In the following sections, you will create the SQS queue on your local machine and the remote cloud to showcase how you can switch between the two with the AWS Cloud Proxy extension.
80
80
81
81
### Create the Lambda function
82
82
83
83
Begin by running your LocalStack container with the following configuration:
To invoke the local Lambda function with the remote SQS queue:
219
217
@@ -231,14 +229,14 @@ You will observe the local Lambda function being invoked once again, with corres
231
229
232
230
You can even run the standard `awslocal` commands in your terminal that would query the remote cloud resources, instead of the local ones.
233
231
234
-
Upon completion, you can click **Disable** on the AWS Replicator extension web interface to deactivate the proxy configuration.
232
+
Upon completion, you can click **Disable** on the AWS Cloud Proxy extension web interface to deactivate the proxy configuration.
235
233
Additionally, you can delete the remote SQS queue to avoid AWS billing for long-running resources.
236
234
To remove local resources, stop the LocalStack container to clear the local Lambda function and SQS queue.
237
235
238
236
## Conclusion
239
237
240
-
In this tutorial, you've discovered how the AWS Replicator extension bridges the gap between local and remote cloud resources by mirroring resources from real AWS accounts into your LocalStack instance.
241
-
You can explore additional use-cases with the AWS Replicator extension, such as:
238
+
In this tutorial, you've discovered how the AWS Cloud Proxy extension bridges the gap between local and remote cloud resources by mirroring resources from real AWS accounts into your LocalStack instance.
239
+
You can explore additional use-cases with the AWS Cloud Proxy extension, such as:
242
240
243
241
- Developing a local Lambda function that interacts with a remote DynamoDB table
244
242
- Executing a local Athena SQL query in LocalStack, accessing files in a real S3 bucket on AWS
0 commit comments