Skip to content
This repository was archived by the owner on Aug 7, 2025. It is now read-only.

Commit 976ef11

Browse files
authored
add docs on new k8s executors (#1572)
1 parent beddd96 commit 976ef11

File tree

1 file changed

+17
-6
lines changed
  • content/en/user-guide/localstack-enterprise/kubernetes-executor

1 file changed

+17
-6
lines changed

content/en/user-guide/localstack-enterprise/kubernetes-executor/index.md

Lines changed: 17 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,10 @@ tags: ["Enterprise plan"]
88

99
## Introduction
1010

11-
LocalStack Enterprise provides a Kubernetes executor for compute services like EC2, ECS, and Lambda.
12-
It allows you to run EC2 instances, ECS tasks, and Lambda functions in your Kubernetes clusters.
13-
By default, LocalStack uses the `docker` backend for compute services.
14-
You can switch to the `kubernetes` executor by setting the appropriate environment variables.
11+
LocalStack Enterprise provides a Kubernetes executor for various emulated services.
12+
It allows you to run these services as Kubernetes pods in your Kubernetes clusters.
13+
By default, LocalStack uses the `docker` backend for these services.
14+
You can use either service-specific configuration variables or the generic `CONTAINER_RUNTIME` variable set to `kubernetes` to enable the Kubernetes executor.
1515

1616
## EC2 Kubernetes Executor
1717

@@ -33,14 +33,14 @@ The current implementation is in preview and does not support volumes, custom AM
3333

3434
## ECS Kubernetes Executor
3535

36-
LocalStack Enterprise image allows you to run ECS tasks on Kubernetes.
36+
The LocalStack Enterprise image allows you to run ECS tasks on Kubernetes.
3737
The tasks are added to ELB load balancer target groups.
3838
You can do so by setting the `ECS_TASK_EXECUTOR` environment variable to `kubernetes` in the LocalStack container.
3939

4040
## Lambda Kubernetes Executor
4141

4242
The LocalStack Enterprise image allows you to execute Lambda functions as Kubernetes pods.
43-
You can do so by setting the `lambda.executor` configuration to `kubernetes` in the LocalStack container.
43+
You can do so by setting `LAMBDA_RUNTIME_EXECUTOR` ( or `lambda.executor` when using the Helm configuration) to `kubernetes`.
4444
For more information, see the [Helm Chart configuration](https://github.com/localstack/helm-charts/blob/ce47b1590605901650ab788556bc871efbd78b8d/charts/localstack/values.yaml#L178-L208).
4545

4646
- Kubernetes Lambda Executor in LocalStack scales Lambda execution by spawning new environments (running in pods) during concurrent invocations.
@@ -56,3 +56,14 @@ For more information, see the [Helm Chart configuration](https://github.com/loca
5656
The `/var/lib/localstack` directory should be persisted over LocalStack runs, typically in a volume.
5757

5858
Lambda hot reloading & remote debugging are not supported in the Kubernetes executor as the bind mounting into pods cannot be done at runtime.
59+
60+
## Other services
61+
62+
You can run the following services on Kubernetes clusters using the LocalStack Enterprise image:
63+
64+
- [DocumentDB](https://docs.localstack.cloud/user-guide/aws/docdb/)
65+
- [MWAA](https://docs.localstack.cloud/user-guide/aws/docdb/)
66+
- [RDS](https://docs.localstack.cloud/user-guide/aws/rds/) ([MySQL](https://docs.localstack.cloud/user-guide/aws/rds/#mysql-engine) & [MSSQL](https://docs.localstack.cloud/user-guide/aws/rds/#microsoft-sql-server-engine))
67+
68+
To use Kubernetes as the runtime backend, set the `CONTAINER_RUNTIME` configuration variable to `kubernetes`.
69+
Note that there are no service-specific configuration variables for these services.

0 commit comments

Comments
 (0)