Skip to content

Commit c0426fc

Browse files
fluktuidCopilot
andauthored
docs: clarify server_url on cluster creation (#1002)
* docs: clarify server_url on cluster creation the creating node may not have a server_url set this is due to harvester-installer config validator the config-valudator needs to do this thus harvester checks the value see https://github.com/harvester/harvester-installer/blob/8317a66fd50b7954f8d1a87a957abbb11994bfbc/pkg/console/validator.go\#L422 see https://github.com/harvester/harvester-installer/blob/8317a66fd50b7954f8d1a87a957abbb11994bfbc/pkg/config/cos.go\#L377 fixes harvester/harvester#10325 Signed-off-by: Lukas Paluch <paluch@tuxig.com> * Update docs/install/harvester-configuration.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Lukas f. Paluch <paluch@tuxig.com> --------- Signed-off-by: Lukas Paluch <paluch@tuxig.com> Signed-off-by: Lukas f. Paluch <paluch@tuxig.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
1 parent e684771 commit c0426fc

1 file changed

Lines changed: 12 additions & 1 deletion

File tree

docs/install/harvester-configuration.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Harvester configuration file can be provided during manual or automatic installa
2121

2222
```yaml
2323
scheme_version: 1
24-
server_url: https://cluster-VIP:443
24+
server_url: "" # empty or absent in create mode; set to https://cluster-VIP:443 in join mode
2525
token: TOKEN_VALUE
2626
os:
2727
ssh_authorized_keys:
@@ -146,6 +146,7 @@ Make sure that your custom configuration always has the correct scheme version.
146146
`server_url` is the URL of the Harvester cluster, which is used for the new `node` to join the cluster.
147147

148148
This configuration is mandatory when the installation is in `JOIN` mode. The default format of `server_url` is `https://cluster-VIP:443`.
149+
In `CREATE` mode the parameter must be absent or with empty value (`""`). Otherwise the installation fails.
149150

150151
:::note
151152

@@ -155,6 +156,16 @@ To ensure a high availability (HA) Harvester cluster, please use either the Harv
155156

156157
#### Example
157158

159+
for cluster creation
160+
161+
```yaml
162+
server_url: '' # or remove this line
163+
install:
164+
mode: create
165+
```
166+
167+
or to join a cluster
168+
158169
```yaml
159170
server_url: https://cluster-VIP:443
160171
install:

0 commit comments

Comments
 (0)