From 8e8b7bb639e54d7b9be7908b740250ac0c09b969 Mon Sep 17 00:00:00 2001
From: Michele Cereda <cereda.michele@gmail.com>
Date: Sun, 10 Nov 2024 16:06:32 +0100
Subject: [PATCH] chore: start notes on localstack

---
 .vscode/settings.json                         |  1 +
 .../cloud computing/aws/localstack.md         | 71 +++++++++++++++++++
 2 files changed, 72 insertions(+)
 create mode 100644 knowledge base/cloud computing/aws/localstack.md

diff --git a/.vscode/settings.json b/.vscode/settings.json
index f67a02b..fcd2cd2 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -219,6 +219,7 @@
         "libexec",
         "lighttpd",
         "localdomain",
+        "localstack",
         "lockfiles",
         "lucene",
         "luci",
diff --git a/knowledge base/cloud computing/aws/localstack.md b/knowledge base/cloud computing/aws/localstack.md
new file mode 100644
index 0000000..0696246
--- /dev/null
+++ b/knowledge base/cloud computing/aws/localstack.md	
@@ -0,0 +1,71 @@
+# Title
+
+AWS service emulator that runs in a single container.
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+   1. [Sources](#sources)
+
+## TL;DR
+
+<details>
+  <summary>Setup</summary>
+
+```sh
+brew install 'localstack/tap/localstack-cli'
+localstack --version
+
+# Install on Kubernetes
+helm -n 'localstack' upgrade -i --create-namespace 'localstack' --repo 'https://helm.localstack.cloud' 'localstack'
+```
+
+</details>
+
+<details>
+  <summary>Usage</summary>
+
+```sh
+# Validate the configuration
+localstack config validate
+
+# Run
+docker run --rm -it \
+  -p '127.0.0.1:4566:4566' -p '127.0.0.1:4510-4559:4510-4559' \
+  -v '/var/run/docker.sock:/var/run/docker.sock' \
+  'localstack/localstack'
+```
+
+</details>
+
+<!-- Uncomment if used
+<details>
+  <summary>Real world use cases</summary>
+
+```sh
+```
+
+</details>
+-->
+
+## Further readings
+
+- [Website]
+- [Codebase]
+- [Documentation]
+
+### Sources
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- In-article sections -->
+<!-- Knowledge base -->
+<!-- Files -->
+<!-- Upstream -->
+[codebase]: https://github.com/localstack/localstack
+[documentation]: https://docs.localstack.cloud/
+[website]: https://www.localstack.cloud/
+
+<!-- Others -->