livebook-dev/livebook
1
1
Fork 0
mirror of https://github.com/livebook-dev/livebook.git synced 2024-09-20 10:05:57 +08:00
Code Issues Packages Projects Releases Wiki Activity
livebook/docs/deployment/clustering.md
José Valim de22485641
Instructions for k8s agent (#2697)
2024-07-02 11:24:30 +02:00

1.2 KiB
Raw Blame History

Clustering

If you plan to run several Livebook instances behind a load balancer, you need to enable clustering via the LIVEBOOK_CLUSTER environment variable. In addition you must set LIVEBOOK_SECRET_KEY_BASE and LIVEBOOK_COOKIE to different random values (use openssl rand -base64 48 to generate said values).

Depending on the clustering strategy of your choice, you must set additional environment variables, oftentimes, at runtime. When using the Livebook Docker image, you can create a file at /app/user/env.sh that exports the necessary environment variables. This file is invoked right before booting Livebook.

You may set LIVEBOOK_CLUSTER to one of the following values.

auto

Detects the hosting platform and automatically sets up a cluster using DNS configuration. Currently the only supported platform is Fly.io (and Kubernetes when using Livebook Teams).

dns:QUERY

Sets up a cluster using DNS for queries for A/AAAA records to discover new nodes. Additionally, you must additionally set the following env vars:

  • LIVEBOOK_NODE=livebook_server@MACHINE_IP, where MACHINE_IP is the machine IP of each deployed node

  • If your cloud requires IPv6, also set ERL_AFLAGS="-proto_dist inet6_tcp"