Merge pull request #8 from fiskaltrust/split-out-loadbalancer

Split out loadbalancer

bring-your-own-datacenter/Chart.yaml

@@ -1,7 +1,7 @@
 apiVersion: v2
 name: bring-your-own-datacenter
 type: application
-version: 1.3.38
+version: 1.3.45-rc1
 kubeVersion: ^v1.22.0-0
 keywords:
   - fiskaltrust
@@ -10,8 +10,3 @@ keywords:
 home: https://github.com/fiskaltrust/product-de-bring-your-own-datacenter
 sources:
   - https://github.com/fiskaltrust/helm-charts/tree/master/bring-your-own-datacenter
-dependencies:
-  - name: emissary-ingress
-    version: 7.4.1
-    repository: https://app.getambassador.io
-    condition: emissary-ingress.install

bring-your-own-datacenter/MIGRATION.md

@@ -108,3 +108,61 @@ The following steps will update the helm repo, uninstall the helm chart, delete
 > helm repo update
 > helm install bring-your-own-datcenter fiskaltrust/bring-your-own-datacenter -f new.config.yaml -n bring-your-own-datacenter --version 1.3.26
 > ```
+
+## `v1.3.45`
+
+### Background
+
+In this version we took the emissary ingress installation out of the helm chart.
+This will fixes issues with multiple installations and will ease future updates.
+
+The emissary ingress now needs to be installed and configured in a seperate step before the byodc helm chart is installed.
+
+### Migration Guide
+
+#### Update `config.yaml`
+
+##### Emissary Ingress
+The following configuration values were moved:
+
+| old path                          | new path            |
+|-----------------------------------|---------------------|
+| `loadbalancer.config.tls.enabled` | `emissary.tls`      |
+| `loadbalancer.config.hostname`    | `emissary.hostname` |
+
+
+The `emissary-ingress` configuration section was removed.
+Emissary ingress needs to be configured from [its own chart](https://artifacthub.io/packages/helm/datawire/emissary-ingress/#configuration).
+
+##### Proxy
+
+We've also deprecated the `byodc.proxy.http`, `byodc.proxy.https`, `byodc.proxy.no`, `byodc.proxy.ftp` and `byodc.proxy.all` variables.
+These variables still work but willbe removed in a future version.
+
+Instead you can now configure the proxy settings directly in the `byodc.proxy` variable using a [proxy string like its use in the fiskaltrust.Middleware](https://link.fiskaltrust.cloud/rollout/proxy).
+
+#### Perform upgrade
+
+1. List all helm releases
+   ```sh
+   helm list
+   ```
+2. Uninstall the `byodc` release listed by the previous command.
+   ```sh
+   helm uninstall <release-name> -n <byodc-namespace>
+   ```
+   > ***Note:** If helm can not uninstall of find the release the whole namespace can be deleted and recreated like this:*
+   > ```sh
+   > kubectl delete namespace <byodc-namespace>`
+   > `kubectl create namespace <byodc-namespace>`
+   > ```
+3. Install emissary ingress v3.x. Please follow the [official installation instructions](https://www.getambassador.io/docs/emissary/3.5/topics/install/helm).
+   > ***Note:** When performing the `helm install` step you can also provide a `config.yaml` file to configure emissary ingress.*
+4. Update the helm repository
+   ```sh
+   helm repo update
+   ```
+4. Install the new helm chart
+   ```sh
+   helm install <release-name> fiskaltrust/bring-your-own-datacenter -f <path-to-config-yaml> -n <byodc-namespace> --version 1.3.45-rc1 --devel
+   ```

bring-your-own-datacenter/README.md

@@ -7,6 +7,10 @@
 
 ## Installation
 
+### Install Emissary Ingress
+
+Install emissary ingress v3.x. Please follow the [official installation instructions](https://www.getambassador.io/docs/emissary/3.5/topics/install/helm).
+
 ### Create Namespace
 
 Connect to your Kubernetes cluster and create the `bring-your-own-datacenter` namespace.
@@ -55,5 +59,10 @@ helm uninstall bring-your-own-datacenter --namespace bring-your-own-datacenter
 kubectl delete namespace bring-your-own-datacenter
 ```
 
+## Updating
+
+Please check the [migration guide](./MIGRATION.md) for specific update instructions to your version. If none are mentioned you can update like this:
 
-<!-- helm dependency update -->
+```sh
+helm upgrade --install bring-your-own-datcenter fiskaltrust/bring-your-own-datacenter --namespace bring-your-own-datacenter -f config.yaml
+```