LocalStack 为开发云应用程序提供了一个易于使用的测试/模拟框架。

概述 • 安装 • 示例 • 运行 • 使用 • 变更日志 • 贡献
–
📖 文档 • 💻 专业版 • ☑️ 特性覆盖 • 📢 公告

概述

LocalStack 💻 是一个云服务模拟器，它在一个容器中运行在你的笔记本电脑或CI环境中。使用LocalStack，你可以在本地机器上运行你的AWS应用程序或Lambda，而无需连接到远程云服务提供商！无论您是在测试复杂的CDK应用程序或Terraform配置，还是刚开始学习AWS服务，LocalStack都有助于加快并简化您的测试和开发工作流程。

LocalStack 支持越来越多的AWS服务，如AWS Lambda、S3、Dynamodb、Kinesis、SQS、SNS等！LocalStack的专业版支持额外的API和高级功能。您可以在我们的☑️ 特性覆盖页面上找到支持的API的完整列表。

LocalStack 还提供了一些额外的功能，使您作为云开发者的工作更加轻松！有关更多信息，请查看 LocalStack 的云开发者工具。

要求

• python（支持 Python 3.6 至 3.10）
• pip（Python 软件包管理器）
• Docker

安装

安装 LocalStack 最简单的方法是通过 pip

pip install localstack

注意：请勿使用 sudo 或 root 用户 - LocalStack 应完全在本地非 root 用户下安装和启动。如果 macOS High Sierra 中存在权限问题，请使用 pip install --user localstack 进行安装

它安装了 localstack-cli，该工具用于运行托管 LocalStack 运行时的 Docker 镜像。

示例

通过运行以下命令在 Docker 容器中启动 LocalStack

 % localstack start -d

     __                     _______ __             __
    / /   ____  _________ _/ / ___// /_____ ______/ /__
   / /   / __ \/ ___/ __ `/ /\__ \/ __/ __ `/ ___/ //_/
  / /___/ /_/ / /__/ /_/ / /___/ / /_/ /_/ / /__/ ,<
 /_____/\____/\___/\__,_/_//____/\__/\__,_/\___/_/|_|

 💻 LocalStack CLI 0.14.3

[20:22:20] starting LocalStack in Docker mode 🐳
[20:22:21] detaching

您可以通过运行以下命令查询 LocalStack 中相应服务的状态

% localstack status services
┏━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┓
┃ Service                  ┃ Status      ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━┩
│ acm                      │ ✔ available │
│ apigateway               │ ✔ available │
│ cloudformation           │ ✔ available │
│ cloudwatch               │ ✔ available │
│ config                   │ ✔ available │
│ dynamodb                 │ ✔ available │
...

要在 LocalStack 上使用 SQS（一个全托管的分布式消息队列服务），请运行

% awslocal sqs create-queue --queue-name sample-queue
{
    "QueueUrl": "http://localhost:4566/000000000000/sample-queue"
}

有关 LocalStack AWS 服务及其与 LocalStack 的 awslocal CLI 使用的更多信息，请参阅LocalStack AWS 服务。

运行

您可以通过以下选项运行 LocalStack

• LocalStack CLI
• Docker
• Docker Compose
• Helm

用法

要开始使用 LocalStack，请查看我们的docs.localstack.cloud上的文档。

• LocalStack 配置
• CI 中的 LocalStack
• LocalStack 集成
• LocalStack 工具
• 理解 LocalStack
• 故障排除

要使用图形用户界面（GUI）使用 LocalStack，您可以使用以下 UI 客户端

• Commandeer 桌面应用程序
• DynamoDB 管理员 Web UI

变更日志

请参阅 CHANGELOG.md 以查看每个版本的完整更改列表。

贡献

如果您有兴趣为 LocalStack 贡献

• 首先阅读我们的贡献指南。
• 查看我们的开发者指南。
• 查看我们的路线图。
• 浏览我们的代码库和问题。

我们感谢所有收到的贡献和反馈。

取得联系

要与 LocalStack 团队取得联系，以报告错误/功能请求、支持问题或进行一般讨论，请使用以下方式

• LocalStack Slack 社区
• LocalStack 讨论页面
• LocalStack GitHub 问题跟踪器

贡献者

我们感谢所有为这个项目做出贡献的人。

赞助商

我们还感谢所有为该项目捐赠的赞助商。您可以在Open Collective上成为赞助商。

赞助商

您还可以通过在Open Collective上成为赞助商来支持此项目。您的徽标将显示在此处，并提供到您网站的链接。

许可证

版权（c）2017-2021 LocalStack 维护者和贡献者。

版权（c）2016 Atlassian 及他人。

本版本的 LocalStack 在 Apache 许可证版本 2.0 下发布（请参阅 LICENSE.txt）。通过下载和使用此软件，您同意最终用户许可协议（EULA）。有关我们使用的第三方软件工具的信息，请参阅我们的第三方软件工具页面。