add docs about using AWS CLI v2 from Docker image (#3164)

lucasepe · web-flow · commit 39b2784e97e5 · 2020-10-24T16:41:33.000+02:00
diff --git a/README.md b/README.md
@@ -319,6 +319,49 @@ awslocal kinesis list-streams
 **UPDATE**: Use the environment variable `$LOCALSTACK_HOSTNAME` to determine the target host
 inside your Lambda function. See [Configurations](#Configurations) section for more details.
 
+## Using the official AWS CLI version 2 Docker image with Localstack Docker container
+
+By default the container running [amazon/aws-cli](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2-docker.html) is isolated from `0.0.0.0:4566` on the host machine, that means that aws-cli cannot reach localstack through your shell.
+
+To ensure that the two docker containers can communicate create a network on the docker engine:
+
+```bash
+$ ▶ docker network create localstack
+0c9cb3d37b0ea1bfeb6b77ade0ce5525e33c7929d69f49c3e5ed0af457bdf123
+```
+Then modify the `docker-compose.yml` specifying the network to use:
+
+```yml
+networks:
+  default:
+    external:
+      name: "localstack"
+```
+
+Run AWS Cli v2 docker container using this network (example):
+
+```bash
+$ ▶ docker run --network localstack --rm -it amazon/aws-cli --endpoint-url=http://localstack:4566 lambda list-functions
+{
+    "Functions": []
+}
+```
+
+If you use AWS CLI v2 from a docker container often, create an alias:
+
+```bash
+$ ▶ alias laws='docker run --network localstack --rm -it amazon/aws-cli --endpoint-url=http://localstack:4566'
+```
+
+So you can type:
+
+```bash
+$ ▶ laws lambda list-functions
+{
+    "Functions": []
+}
+```
+
 ### Client Libraries
 
 * Python: https://github.com/localstack/localstack-python-client
