LocalStack est un émulateur de service cloud qui s'exécute dans un seul conteneur sur votre ordinateur portable ou dans votre environnement CI. Avec LocalStack, vous pouvez exécuter vos applications AWS ou Lambdas entièrement sur votre machine locale sans vous connecter à un fournisseur de cloud distant ! Que vous testiez des applications CDK complexes ou des configurations Terraform, ou que vous commenciez tout juste à vous renseigner sur les services AWS, LocalStack vous aide à accélérer et à simplifier votre flux de test et de développement.
LocalStack prend en charge un nombre croissant de services AWS, comme AWS Lambda, S3, Dynamodb, Kinesis, SQS, SNS et bien d'autres ! La version Pro de LocalStack prend en charge des API supplémentaires et des fonctionnalités avancées. Vous pouvez trouver une liste complète des API prises en charge sur notre page Couverture des fonctionnalités.
LocalStack fournit également des fonctionnalités supplémentaires pour vous faciliter la vie en tant que développeur cloud ! Consultez les guides de l'utilisateur de LocalStack pour plus d'informations.
Le moyen le plus rapide de démarrer avec LocalStack consiste à utiliser la CLI LocalStack. Il vous permet de démarrer et de gérer le conteneur LocalStack Docker directement via votre ligne de commande. Assurez-vous que votre ordinateur dispose d'un environnement docker
fonctionnel installé avant de continuer.
Installez la CLI LocalStack via notre LocalStack Brew Tap officiel :
Brew install localstack/tap/localstack-cli
Si Brew n'est pas installé sur votre machine, vous pouvez télécharger directement le binaire CLI LocalStack pré-construit :
Visitez localstack/localstack-cli et téléchargez la dernière version pour votre plateforme.
Extrayez l'archive téléchargée dans un répertoire inclus dans votre variable PATH
:
Pour MacOS/Linux, utilisez la commande : sudo tar xvzf ~/Downloads/localstack-cli-*-darwin-*-onefile.tar.gz -C /usr/local/bin
LocalStack est développé en utilisant Python. Pour installer la CLI LocalStack à l'aide pip
, exécutez la commande suivante :
python3 -m pip installer localstack
L'installation localstack-cli
vous permet d'exécuter l'image Docker contenant le runtime LocalStack. Pour interagir avec les services AWS locaux, vous devez installer la CLI awslocal
séparément. Pour connaître les instructions d'installation, reportez-vous à la documentation awslocal
.
Important : N'utilisez pas
sudo
et ne l'exécutez pas en tant qu'utilisateurroot
. LocalStack doit être installé et démarré entièrement sous un utilisateur local non root. Si vous rencontrez des problèmes avec les autorisations dans macOS High Sierra, installez avecpip install --user localstack
Démarrez LocalStack dans un conteneur Docker en exécutant :
% démarrage de la pile locale -d __ _______ __ __ / / ____ _________ _/ / ___// /_____ ______/ /__ / / / __ / ___/ __ `/ /__ / __/ __ `/ ___/ //_/ / /___/ /_/ / /__/ /_/ / /___/ / /_/ /_/ / /__/ ,< /_____/____/___/__,_/_//____/__/__,_/___/_/|_| ? CLI LocalStack 3.8.0 ? Profil : par défaut [12:47:13] démarrer LocalStack en mode Docker ? localstack.py : 494 préparation de l'environnement bootstrap.py:1240 configuration du conteneur bootstrap.py:1248 démarrage du conteneur bootstrap.py:1258 [12:47:15] détachement de bootstrap.py:1262
Vous pouvez interroger l'état des services respectifs sur LocalStack en exécutant :
% de services d'état de la pile locale ┏━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━ ━┓ ┃ Service ┃ Statut ┃ ┡━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━ ━┩ │ acm │ ✔ disponible │ │ apigateway │ ✔ disponible │ │ formation de nuages │ ✔ disponible │ │ cloudwatch │ ✔ disponible │ │ configuration │ ✔ disponible │ │ dynamodb │ ✔ disponible │ ...
Pour utiliser SQS, un service de file d'attente de messages distribué entièrement géré, sur LocalStack, exécutez :
% awslocal sqs create-queue --queue-name exemple-file d'attente { "QueueUrl": "http://sqs.us-east-1.localhost.localstack.cloud:4566/000000000000/sample-queue"}
Apprenez-en davantage sur les services AWS LocalStack et sur leur utilisation avec la CLI awslocal
de LocalStack.
Vous pouvez exécuter LocalStack via les options suivantes :
CLI LocalStack
Docker
Docker Composer
Barre
Pour commencer à utiliser LocalStack, consultez notre documentation.
Configuration de la pile locale
LocalStack dans CI
Intégrations LocalStack
Outils LocalStack
Comprendre LocalStack
Foire aux questions
Pour utiliser LocalStack avec une interface utilisateur graphique, vous pouvez utiliser les clients d'interface utilisateur suivants :
Application Web LocalStack
Bureau LocalStack
Extension Docker LocalStack
Veuillez vous référer aux versions de GitHub pour voir la liste complète des modifications pour chaque version. Pour les notes de version étendues, veuillez vous référer à LocalStack Discuss.
Si vous souhaitez contribuer à LocalStack :
Commencez par lire notre guide de contribution.
Consultez notre guide de configuration de l’environnement de développement.
Parcourez notre base de code et ouvrez des problèmes.
Nous sommes reconnaissants pour toutes les contributions et commentaires que nous recevons.
Contacter l'équipe LocalStack pour signaler ? problèmes, vote positif ? demandes de fonctionnalités, ?? posez des questions d'assistance, ou ?️ discutez du développement cloud local :
Communauté Slack LocalStack
Page de discussion de LocalStack
Suivi des problèmes LocalStack GitHub
Nous remercions toutes les personnes qui ont contribué à ce projet.
Nous remercions également tous nos donateurs qui ont fait un don au projet. Vous pouvez devenir sponsor d’Open Collective.
Vous pouvez également soutenir ce projet en devenant sponsor sur Open Collective. Votre logo apparaîtra ici avec un lien vers votre site Web.
Copyright (c) 2017-2024 Mainteneurs et contributeurs de LocalStack.
Copyright (c) 2016 Atlassian et autres.
Cette version de LocalStack est publiée sous la licence Apache, version 2.0 (voir LICENCE). En téléchargeant et en utilisant ce logiciel, vous acceptez le contrat de licence d'utilisateur final (CLUF).