Обзор

LocalStack — это эмулятор облачного сервиса, который работает в одном контейнере на вашем ноутбуке или в вашей среде CI. С помощью LocalStack вы можете запускать приложения AWS или Lambdas полностью на своем локальном компьютере без подключения к удаленному облачному провайдеру! Независимо от того, тестируете ли вы сложные приложения CDK или конфигурации Terraform или только начинаете изучать сервисы AWS, LocalStack помогает ускорить и упростить рабочий процесс тестирования и разработки.

LocalStack поддерживает растущее число сервисов AWS, таких как AWS Lambda, S3, Dynamodb, Kinesis, SQS, SNS и многих других! Pro-версия LocalStack поддерживает дополнительные API и расширенные функции. Полный список поддерживаемых API можно найти на нашей странице «Охват функций».

LocalStack также предоставляет дополнительные функции, которые сделают вашу жизнь облачного разработчика проще! Дополнительную информацию см. в руководствах пользователя LocalStack.

Установить

Самый быстрый способ начать работу с LocalStack — использовать интерфейс командной строки LocalStack. Он позволяет запускать контейнер LocalStack Docker и управлять им непосредственно через командную строку. Прежде чем продолжить, убедитесь, что на вашем компьютере установлена функциональная среда docker .

Brew (macOS или Linux с Homebrew)

Установите LocalStack CLI через наш официальный LocalStack Brew Tap:

 заварить установку 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. Чтобы установить LocalStack CLI с помощью pip , выполните следующую команду:

 python3 -m pip установить локальный стек

Установка localstack-cli позволяет запустить образ Docker, содержащий среду выполнения LocalStack. Для взаимодействия с локальными сервисами AWS необходимо отдельно установить awslocal CLI. Рекомендации по установке можно найти в документации awslocal .

Важно : не используйте sudo и не запускайте его от имени пользователя root . LocalStack должен быть установлен и запущен полностью под локальным пользователем без полномочий root. Если у вас есть проблемы с разрешениями в macOS High Sierra, установите с помощью pip install --user localstack

Быстрый старт

Запустите LocalStack внутри контейнера Docker, выполнив:

 % локальный стек старт -d

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

 ? Интерфейс командной строки LocalStack 3.8.0
 ? Профиль: по умолчанию

[12:47:13] запуск LocalStack в режиме Docker?                       локальный стек.py:494
           подготовка среды bootstrap.py:1240
           настройка контейнера bootstrap.py:1248
           запуск контейнера bootstrap.py:1258
[12:47:15] отсоединение bootstrap.py:1262

Вы можете запросить статус соответствующих служб в LocalStack, выполнив:

 % служб статуса localstack
┏━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━ ━┓
┃ Сервис ┃ Статус ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━ ━┩
│ акм │ ✔ в наличии │
│ apigateway │ ✔ доступен │
│ образование облаков │ ✔ доступно │
│ CloudWatch │ ✔ доступно │
│ конфигурация │ ✔ доступно │
│ dynamodb │ ✔ доступно │
...

Чтобы использовать SQS, полностью управляемую распределенную службу очередей сообщений, в LocalStack, запустите:

 % awslocal sqs create-queue --queue-name образец-очереди
{ "QueueUrl": "http://sqs.us-east-1.localhost.localstack.cloud:4566/000000000000/sample-queue"}

Узнайте больше о сервисах LocalStack AWS и их использовании с помощью awslocal CLI LocalStack.

Бег

Вы можете запустить LocalStack следующими способами:

Интерфейс командной строки LocalStack
Докер
Докер Составление
Шлем

Использование

Чтобы начать использовать LocalStack, ознакомьтесь с нашей документацией.

Конфигурация локального стека
LocalStack в CI
Интеграция LocalStack
Инструменты локального стека
Понимание LocalStack
Часто задаваемые вопросы

Чтобы использовать LocalStack с графическим интерфейсом пользователя, вы можете использовать следующие клиенты пользовательского интерфейса:

Веб-приложение LocalStack
LocalStack Рабочий стол
Расширение Docker LocalStack

Релизы

Пожалуйста, обратитесь к выпускам GitHub, чтобы увидеть полный список изменений для каждого выпуска. Расширенные примечания к выпуску см. в обсуждении LocalStack.

Содействие

Если вы заинтересованы в участии в LocalStack:

Начните с прочтения нашего руководства по участию.
Ознакомьтесь с нашим руководством по настройке среды разработки.
Навигация по нашей кодовой базе и открытые проблемы.

Мы благодарны за все отзывы и отзывы, которые мы получаем.

Свяжитесь с нами

Свяжитесь с командой LocalStack, чтобы сообщить? проблемы, голосование? запросы функций, ?? задайте вопросы поддержке или ?️ обсудите разработку локального облака:

Сообщество LocalStack Slack
Страница обсуждения LocalStack
Трекер проблем LocalStack GitHub

Авторы

Мы благодарны всем людям, которые внесли свой вклад в этот проект.

Сторонники

Мы также благодарны всем нашим спонсорам, которые сделали пожертвования на проект. Вы можете стать спонсором Open Collective.

Спонсоры

Вы также можете поддержать этот проект, став спонсором Open Collective. Здесь появится ваш логотип вместе со ссылкой на ваш сайт.

Лицензия

Авторские права (c) принадлежат сопровождающим и участникам LocalStack, 2017–2024 гг.

Авторские права (c) принадлежат Atlassian и другим, 2016 г.

Эта версия LocalStack выпускается под лицензией Apache версии 2.0 (см. ЛИЦЕНЗИЮ). Загружая и используя это программное обеспечение, вы соглашаетесь с Лицензионным соглашением конечного пользователя (EULA).

Расширять

Дополнительная информация