本地堆疊

概述

LocalStack 是一個雲端服務模擬器，可以在筆記型電腦或 CI 環境中的單一容器中運作。透過 LocalStack，您可以完全在本機電腦上執行 AWS 應用程式或 Lambda，而無需連接到遠端雲端提供者！無論您是測試複雜的 CDK 應用程式或 Terraform 配置，還是剛開始了解 AWS 服務，LocalStack 都可以協助加快和簡化您的測試和開發工作流程。

LocalStack 支援越來越多的 AWS 服務，例如 AWS Lambda、S3、Dynamodb、Kinesis、SQS、SNS 等等！ LocalStack 的 Pro 版本支援額外的 API 和進階功能。您可以在我們的「功能覆蓋範圍」頁面上找到支援的 API 的完整清單。

LocalStack 還提供了額外的功能，讓您作為雲端開發人員的生活更加輕鬆！查看 LocalStack 的使用者指南以取得更多資訊。

安裝

開始使用 LocalStack 最快的方法是使用 LocalStack CLI。它使您能夠直接透過命令列啟動和管理 LocalStack Docker 容器。在繼續之前，請確保您的電腦安裝了功能正常的docker環境。

Brew（附有 Homebrew 的 macOS 或 Linux）

透過我們的官方 LocalStack Brew Tap 安裝 LocalStack CLI：

 brew 安裝 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 安裝 localstack

localstack-cli安裝可讓您執行包含 LocalStack 執行階段的 Docker 映像。要與本機 AWS 服務交互，您需要單獨安裝awslocal CLI。有關安裝指南，請參閱awslocal文件。

重要提示：不要使用sudo或以root使用者身分執行。 LocalStack 必須完全在本機非 root 使用者下安裝和啟動。如果您在 macOS High Sierra 中遇到權限問題，請使用pip install --user localstack進行安裝

快速入門

透過執行以下命令在 Docker 容器內啟動 LocalStack：

 % 本地堆疊啟動 -d

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

 ？ LocalStack CLI 3.8.0
 ？設定檔：預設

[12:47:13] 以 Docker 模式啟動 LocalStack ？                       localstack.py：494
           準備環境 bootstrap.py:1240
           配置容器 bootstrap.py:1248
           啟動容器 bootstrap.py:1258
[12:47:15] 分離 bootstrap.py:1262

您可以透過執行以下命令查詢LocalStack上各個服務的狀態：

 % localstack狀態服務
┏────────────────────────────────────────────────── ─┳────────────────────────────┓
┃ 服務 ┃ 狀態 ┃
┡────────────────────────────────────────────────── ───╇────────────────────────────┩
│ acm │ ✔ 可用 │
│ apigateway │ ✔ 可用 │
│ 雲端資訊 │ ✔ 可用 │
│ 雲端觀察 │ ✔ 可用 │
│ 配置 │ ✔ 可用 │
│ dynamodb │ ✔ 可用 │
…

若要在 LocalStack 上使用 SQS（一種完全託管的分散式訊息佇列服務），請執行：

 % awslocal sqs create-queue --queue-name 樣本隊列
{「QueueUrl」：「http://sqs.us-east-1.localhost.localstack.cloud：4566/000000000000/sample-queue」}

了解有關 LocalStack AWS 服務以及將其與 LocalStack 的awslocal CLI 結合使用的更多資訊。

跑步

您可以透過以下選項執行 LocalStack：

• 本地堆疊CLI

• 碼頭工人

• Docker 組合

• 舵

用法

若要開始使用 LocalStack，請查看我們的文件。

• 本地堆疊配置

• CI 中的 LocalStack

• 本地堆疊集成

• 本地堆疊工具

• 了解LocalStack

• 常見問題解答

若要將 LocalStack 與圖形使用者介面結合使用，您可以使用以下 UI 用戶端：

• LocalStack Web 應用程式

• LocalStack桌面

• LocalStack Docker 擴充

發布

請參閱 GitHub 版本以查看每個版本的完整變更清單。有關擴充發行說明，請參閱 LocalStack 討論。

貢獻

如果您有興趣為 LocalStack 做出貢獻：

• 首先閱讀我們的貢獻指南。

• 查看我們的開發環境設定指南。

• 瀏覽我們的程式碼庫和未解決的問題。

我們感謝收到的所有貢獻和回饋。

聯絡我們

聯絡 LocalStack 團隊進行報告？問題，按讚？功能請求，??詢問支援問題，或？

• LocalStack Slack 社區

• LocalStack 討論頁面

• LocalStack GitHub 問題追蹤器

貢獻者

我們感謝所有為這個項目做出貢獻的人。

支持者

我們也感謝所有為該項目捐款的支持者。您可以成為 Open Collective 的支持者。

贊助商

您也可以透過成為 Open Collective 的贊助商來支持該專案。您的徽標將與您網站的連結一起顯示在此處。

執照

版權所有 (c) 2017-2024 LocalStack 維護者和貢獻者。

版權所有 (c) 2016 Atlassian 等。

此版本的 LocalStack 是根據 Apache 許可證版本 2.0 發布的（請參閱許可證）。下載並使用本軟體即表示您同意最終使用者授權協議 (EULA)。