docs: update remote deployment docs with working nginx-install example (#2625)
- Update the docs on k3s deployment for installing `ingress-nginx`, fixes #2619. - Also fix the indentation on the code blocks so markdown carries on list numbering. At the moment the numbering confusingly resets after point 3. - Update indentation on all code blocks so they show up as part of list + wrap long commands. --------- Co-authored-by: Ilya Kreymer <ikreymer@gmail.com>
This commit is contained in:
parent
2aad7b8dc0
commit
8b54444b7e
@ -10,12 +10,16 @@
|
||||
# k3s
|
||||
# ---
|
||||
#
|
||||
# One way to deploy this is with k3s, which will require the following changes:
|
||||
# One way to deploy this is with k3s (https://k3s.io/), which will require the following changes:
|
||||
#
|
||||
# Make sure to disable traefik on your k3s cluster by adding `--no-deploy traefik` to the systemd unit that starts k3s _before_ starting your server. One way to check that traefik is not running your cluster is with `kubectl get deployments -n kube-system` and see if traefik shows up in the output
|
||||
# Make sure to disable traefik on your k3s cluster by adding `--no-deploy traefik` to the systemd unit that starts k3s _before_ starting your server.
|
||||
# One way to check that traefik is not running your cluster is with `kubectl get deployments -n kube-system` and see if traefik shows up in the output.
|
||||
#
|
||||
# Once traefik has been disabled, you must install `nginx-ingress` which can be installed by:
|
||||
# helm upgrade --install nginx ingress-nginx/ingress-nginx -n ingress-nginx --create-namespace
|
||||
# Once traefik has been disabled, you must install `nginx-ingress`, which can be installed by:
|
||||
#
|
||||
# helm upgrade --install ingress-nginx ingress-nginx \
|
||||
# --repo https://kubernetes.github.io/ingress-nginx \
|
||||
# --namespace ingress-nginx --create-namespace
|
||||
#
|
||||
# You'll also need to install cert-manager. Browsertrix recommends installing cert-manager through jetpack with the following command:
|
||||
#
|
||||
|
@ -21,9 +21,10 @@ For a single-machine remote deployment, we recommend using [MicroK8s](https://mi
|
||||
|
||||
4. Run with:
|
||||
|
||||
```shell
|
||||
helm upgrade --install -f ./chart/values.yaml -f ./chart/my-config.yaml btrix ./chart/
|
||||
```
|
||||
```shell
|
||||
helm upgrade --install -f ./chart/values.yaml -f ./chart/my-config.yaml \
|
||||
btrix ./chart/
|
||||
```
|
||||
|
||||
## Single Machine Deployment with k3s
|
||||
|
||||
@ -31,21 +32,28 @@ Another option for a single-machine remote deployment is [k3s](https://k3s.io)
|
||||
|
||||
1. Install K3s, as suggested in the [local deployment guide](../deploy/local.md). Make sure to **disable traefik** which can be done by adding `--no-deploy traefik` to the `systemd` unit when installing k3s
|
||||
|
||||
2. Install `nginx-ingress` with: `helm upgrade --install nginx ingress-nginx/ingress-nginx -n ingress-nginx --create-namespace`
|
||||
2. Install `nginx-ingress` with:
|
||||
|
||||
```zsh
|
||||
helm upgrade --install ingress-nginx ingress-nginx \
|
||||
--repo https://kubernetes.github.io/ingress-nginx \
|
||||
--namespace ingress-nginx --create-namespace
|
||||
```
|
||||
|
||||
3. Install `cert-manager`. We recommend installing `cert-manager` through Jetpack, like so:
|
||||
|
||||
```zsh
|
||||
helm repo add jetstack https://charts.jetstack.io
|
||||
helm repo update
|
||||
```zsh
|
||||
helm repo add jetstack https://charts.jetstack.io
|
||||
helm repo update
|
||||
|
||||
helm repo update jetstack
|
||||
helm upgrade --install \
|
||||
cert-manager jetstack/cert-manager \
|
||||
--namespace cert-manager \
|
||||
--create-namespace \
|
||||
--version v1.12.0 \
|
||||
--set installCRDs=true
|
||||
```
|
||||
helm repo update jetstack
|
||||
helm upgrade --install \
|
||||
cert-manager jetstack/cert-manager \
|
||||
--namespace cert-manager \
|
||||
--create-namespace \
|
||||
--version v1.12.0 \
|
||||
--set installCRDs=true
|
||||
```
|
||||
|
||||
4. Copy `cp ./chart/examples/k3s-hosted.yaml ./chart/my-config.yaml` to make local changes.
|
||||
|
||||
@ -55,9 +63,10 @@ helm upgrade --install \
|
||||
|
||||
7. Run with:
|
||||
|
||||
```shell
|
||||
helm upgrade --install -f ./chart/values.yaml -f ./chart/my-config.yaml btrix ./chart/
|
||||
```
|
||||
```shell
|
||||
helm upgrade --install -f ./chart/values.yaml -f ./chart/my-config.yaml \
|
||||
btrix ./chart/
|
||||
```
|
||||
|
||||
### Using Custom Storage
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user