Skip to content

Commit 8ab4d26

Browse files
authored
chore: add note that HA is experimental (#4601)
1 parent 8acba0c commit 8ab4d26

File tree

1 file changed

+12
-11
lines changed

1 file changed

+12
-11
lines changed

docs/admin/high-availability.md

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,8 @@ workspace <-> coder and user <-> coder connections.
1515

1616
## Setup
1717

18+
> We're stress testing High Availability this week before we enable it by default. To try HA beforehand, set `CODER_EXPERIMENTAL=true` for the Coder server as well as the additional configuration options below.
19+
1820
Coder automatically enters HA mode when multiple instances simultaneously connect
1921
to the same Postgres endpoint.
2022

@@ -28,32 +30,31 @@ embedded relay (default). If you're using [custom relays](../networking.md#custo
2830

2931
Here's an example 3-node network configuration setup:
3032

31-
| Name | `CODER_ADDRESS` | `CODER_DERP_SERVER_RELAY_URL` | `CODER_ACCESS_URL` |
32-
| ------- | --------------- | ----------------------------- | ----------------------- |
33+
| Name | `CODER_ADDRESS` | `CODER_DERP_SERVER_RELAY_URL` | `CODER_ACCESS_URL` |
34+
| --------- | --------------- | ----------------------------- | ------------------------ |
3335
| `coder-1` | `*:80` | `http://10.0.0.1:80` | `https://coder.big.corp` |
3436
| `coder-2` | `*:80` | `http://10.0.0.2:80` | `https://coder.big.corp` |
3537
| `coder-3` | `*:80` | `http://10.0.0.3:80` | `https://coder.big.corp` |
3638

37-
3839
## Kubernetes
3940

4041
If you installed Coder via
4142
[our Helm Chart](../install/kubernetes.md#install-coder-with-helm), just
4243
increase `coder.replicaCount` in `values.yaml`.
4344

44-
4545
If you installed Coder into Kubernetes by some other means, insert the relay URL
4646
via the environment like so:
4747

4848
```yaml
49-
env:
50-
- name: POD_IP
51-
valueFrom:
52-
fieldRef:
53-
fieldPath: status.podIP
54-
- name: CODER_DERP_SERVER_RELAY_URL
55-
value: http://$(POD_IP)
49+
env:
50+
- name: POD_IP
51+
valueFrom:
52+
fieldRef:
53+
fieldPath: status.podIP
54+
- name: CODER_DERP_SERVER_RELAY_URL
55+
value: http://$(POD_IP)
5656
```
57+
5758
Then, increase the number of pods.
5859
5960
## Up next

0 commit comments

Comments
 (0)