跳转到主要内容

LocalStack - 一个完整的本地云栈

项目描述

:zap: 我们很高兴宣布发布 LocalStack 3.7 :zap

LocalStack - A fully functional local cloud stack

CircleCI Coverage Status PyPI Version Docker Pulls PyPi downloads Backers on Open Collective Sponsors on Open Collective PyPI License Code style: black Ruff Twitter

LocalStack 是一个云软件开发框架,用于在本地开发和测试您的 AWS 应用程序。

概述安装快速入门运行用法版本贡献
📖 文档💻 专业版☑️ LocalStack 覆盖范围


概述

LocalStack 是一个云服务模拟器,在您的笔记本电脑或 CI 环境的单个容器中运行。使用 LocalStack,您可以在本地机器上完全运行您的 AWS 应用程序或 Lambdas,而无需连接到远程云提供商!无论您是在测试复杂的 CDK 应用程序或 Terraform 配置,还是刚开始了解 AWS 服务,LocalStack 都可以帮助您加快并简化测试和开发工作流程。

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

LocalStack 还提供了其他功能,使您的云开发生活更加轻松!有关更多信息,请参阅 LocalStack 的 用户指南

安装

开始使用 LocalStack 的最快方式是通过使用 LocalStack CLI。它允许您通过命令行直接启动和管理 LocalStack Docker 容器。在继续之前,请确保您的机器已安装功能齐全的 docker 环境

Brew(macOS 或 Linux with Homebrew)

通过我们的 官方 LocalStack Brew Tap 安装 LocalStack CLI。

brew install localstack/tap/localstack-cli

二进制下载(MacOS、Linux、Windows)

如果您的机器上未安装 Brew,您可以直接下载预构建的 LocalStack CLI 二进制文件

  • 访问 localstack/localstack-cli 并下载适用于您的平台的最新版本。
  • 将下载的存档解压到您的 PATH 变量中包含的目录
    • 对于 MacOS/Linux,使用以下命令:sudo tar xvzf ~/Downloads/localstack-cli-*-darwin-*-onefile.tar.gz -C /usr/local/bin

PyPI(MacOS、Linux、Windows)

LocalStack 是使用 Python 开发的。要使用 pip 安装 LocalStack CLI,请运行以下命令

python3 -m pip install localstack

localstack-cli 安装使您能够运行包含 LocalStack 运行时的 Docker 图像。要使用本地 AWS 服务进行交互,您需要单独安装 awslocal CLI。有关安装说明,请参阅 awslocal 文档

重要:不要使用 sudo 或以 root 用户运行。LocalStack 必须完全在本地非 root 用户下安装和启动。如果 macOS High Sierra 中存在权限问题,请使用 pip install --user localstack 安装。

快速入门

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

 % localstack start -d

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

 💻 LocalStack CLI 3.7.0
 👤 Profile: default

[12:47:13] starting LocalStack in Docker mode 🐳                       localstack.py:494
           preparing environment                                       bootstrap.py:1240
           configuring container                                       bootstrap.py:1248
           starting container                                          bootstrap.py:1258
[12:47:15] detaching                                                   bootstrap.py:1262

您可以通过运行以下命令查询 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://sqs.us-east-1.localhost.localstack.cloud:4566/000000000000/sample-queue"
}

有关 LocalStack AWS 服务和如何使用 LocalStack 的 awslocal CLI 使用它们的更多信息,请参阅 LocalStack AWS 服务

运行

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

用法

要开始使用 LocalStack,请查看我们的 文档

要使用具有图形用户界面的 LocalStack,您可以使用以下 UI 客户端

版本发布

请参阅 GitHub 版本发布 以查看每个版本的所有更改列表。有关扩展的发布说明,请参阅 LocalStack 讨论

贡献

如果您有兴趣为 LocalStack 贡献

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

联系

与 LocalStack 团队联系,报告 🐞 问题,点赞 👍 功能请求,🙋🏽 提问 支持问题,或 🗣️ 讨论本地云开发

贡献者

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

赞助商

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

赞助商

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

许可

版权(c)2017-2024 LocalStack 维护者和贡献者。

版权(c)2016 Atlassian 及他人。

此版本 LocalStack 依据 Apache License 2.0 发布(见 LICENSE)。通过下载和使用此软件,您同意 最终用户许可协议(EULA)

项目详情


发布历史 发布通知 | RSS 源

下载文件

下载适用于您平台的应用程序文件。如果您不确定要选择哪个,请了解有关安装包的更多信息。

源分发

localstack-3.8.0.tar.gz (5.7 kB 查看哈希值)

上传时间

支持