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: README.md
+13-1Lines changed: 13 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,7 +18,7 @@ Note that the command above also installs the latest version of the underlying A
18
18
pip install awscli-local
19
19
```
20
20
21
-
**Note:** Automatic installation of AWS CLI version 2 is currently not supported yet (at the time of writing there is no official pypi package for`v2` available), but the`awslocal`command shouldtechnically alsowork with AWS CLI v2.
21
+
**Note:** Automatic installation of AWS CLI version 2 is currently not supported yet (at the time of writing there is no official pypi package for`v2` available), but the`awslocal` technically alsoworks with AWS CLI v2 (see[this section](#Limitations) for more details).
22
22
23
23
##Usage
24
24
@@ -49,6 +49,18 @@ localstack is bound to another interface (i.e. docker-machine).
49
49
with`USE_SSL=true` enabled). Defaults to`false`.
50
50
*`DEFAULT_REGION`: Set the default region. Overrides`AWS_DEFAULT_REGION` environment variable.
51
51
52
+
##Limitations
53
+
54
+
* Please note that there is a known limitation for using the`cloudformation package ...` command with the AWS CLI v2. The problem is that the AWS CLI v2 is[not available as a package on pypi.org](https://github.com/aws/aws-cli/issues/4947), but is instead shipped as a binary package that cannot be easily patched from`awslocal`. To work around this issue, you have 2 options:
55
+
56
+
- Downgrade to the v1 AWS CLI (this is the recommended approach)
57
+
- There is an inofficial way to install AWS CLI v2 from sources. We do not recommend this, but it is technically possible. Also, you should install these libraries in a Python virtualenv, to avoid version clashes with other libraries on your system: