{"id":18636692,"url":"https://github.com/localstack/localstack-on-k8s","last_synced_at":"2025-04-11T09:31:07.523Z","repository":{"id":61974515,"uuid":"550959361","full_name":"localstack/localstack-on-k8s","owner":"localstack","description":"Sample repository that illustrates running LocalStack on Kubernetes","archived":false,"fork":false,"pushed_at":"2023-10-25T15:11:52.000Z","size":21,"stargazers_count":13,"open_issues_count":0,"forks_count":5,"subscribers_count":11,"default_branch":"main","last_synced_at":"2024-02-24T23:47:18.460Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/localstack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2022-10-13T15:50:22.000Z","updated_at":"2024-02-11T05:29:32.000Z","dependencies_parsed_at":"2023-02-06T07:46:33.590Z","dependency_job_id":"245c92d0-d011-4808-8e5c-4bef0a36bc93","html_url":"https://github.com/localstack/localstack-on-k8s","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/localstack%2Flocalstack-on-k8s","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/localstack%2Flocalstack-on-k8s/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/localstack%2Flocalstack-on-k8s/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/localstack%2Flocalstack-on-k8s/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/localstack","download_url":"https://codeload.github.com/localstack/localstack-on-k8s/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223464622,"owners_count":17149582,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-07T05:31:16.167Z","updated_at":"2025-04-11T09:31:07.515Z","avatar_url":"https://github.com/localstack.png","language":"Python","readme":"\u003e [!IMPORTANT]\n\u003e This repository has been archived.\n\u003e \n\u003e Please use our official helm chart (https://github.com/localstack/helm-charts) to deploy LocalStack to kubernetes.\n\n# LocalStack on Kubernetes\n\nSample repository that illustrates running LocalStack on Kubernetes (k8s).\n\n## Prerequisites\n\nThis sample requires the following tools installed on your machine:\n* Python 3.7+\n* [`awslocal`](https://github.com/localstack/awscli-local)\n* [Docker](https://www.docker.com)\n* [Git](https://git-scm.com)\n* [Helm](https://helm.sh)\n* [`kubectl`](https://kubernetes.io/docs/tasks/tools/#kubectl)\n* [Serverless](https://www.npmjs.com/package/serverless)\n\n## Installing\n\nTo install the Python dependencies in a virtualenv:\n```\nmake install\n```\n\nTo create an embedded Kubernetes (k3d) cluster in Docker and install LocalStack in it (via Helm):\n```\nmake init\n```\n\nAfter initialization, your `kubectl` command-line should be automatically configured to point to the local cluster context:\n```\n$ kubectl config current-context\nk3d-ls-cluster\n```\n\n## Deploying the sample app\n\nOnce LocalStack is installed in the Kubernetes cluster, we can deploy the sample app on the LocalStack instance:\n```\nmake deploy\n```\n\n## Interacting with the sample app\n\nOnce the sample app is deployed, the Kubernetes environment should contain the following resources:\n\n```\n$ kubectl get all\nNAME                              READY   STATUS    RESTARTS   AGE\npod/localstack-6fd5b98f59-zcx2t   1/1     Running   0          5m\n\nNAME                 TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)                         AGE\nservice/kubernetes   ClusterIP   10.43.0.1       \u003cnone\u003e        443/TCP                         5m\nservice/localstack   NodePort    10.43.100.167   \u003cnone\u003e        4566:31566/TCP,4571:31571/TCP   5m\n\nNAME                         READY   UP-TO-DATE   AVAILABLE   AGE\ndeployment.apps/localstack   1/1     1            1           5m\n\nNAME                                    DESIRED   CURRENT   READY   AGE\nreplicaset.apps/localstack-6fd5b98f59   1         1         1       5m\n```\n\nThe LocalStack instance should be available via the local ingress port `8081`. We can verify that the resources were successfully created by running a few `awslocal` commands against the local endpoint:\n```\n$ awslocal sqs --endpoint-url=http://localhost:8081 list-queues\n{\n    \"QueueUrls\": [\n        \"http://localhost:8081/000000000000/requestQueue\"\n    ]\n}\n$ awslocal apigateway --endpoint-url=http://localhost:8081 get-rest-apis\n{\n    \"items\": [\n        {\n            \"id\": \"ses2pi5oap\",\n            \"name\": \"local-localstack-demo\",\n...\n```\n\nWe can then use a browser to open the [Web UI](http://localhost:8081/archive-bucket/index.html), which should have been deployed to an S3 bucket inside LocalStack. The Web UI can be used to interact with the sample application, send new requests to the backend, inspect the state of existing requests, etc.\n\n## License\n\nThis code is available under the Apache 2.0 license.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flocalstack%2Flocalstack-on-k8s","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flocalstack%2Flocalstack-on-k8s","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flocalstack%2Flocalstack-on-k8s/lists"}