docs(installation): Update Installation pages (#7077)

* Update Installation docs

* Add installation steps for install from a GitHub release and from the GCS bucket

* Update docs-gb/install/installation.md

Co-authored-by: Antanina Vertsinskaya  <antanina.vertsinskaya@seldon.io>

---------

Co-authored-by: Antanina Vertsinskaya <antanina.vertsinskaya@seldon.io>

Author: vtaskow

docs-gb/install/aws.md

@@ -137,49 +137,7 @@ For custom configuration and more details on installing Seldon Core with Istio p
 
 ## Install Seldon Core
 
-Before we install Seldon Core, we'll create a new namespace `seldon-system` for the operator to run in:
-
-```bash
-kubectl create namespace seldon-system
-```
-
-We're now ready to install Seldon Core in our cluster. Run the following command for your choice of Ingress:
-
-{% tabs %}
-
-{% tab title="Istio" %}
-
-```bash
-helm install seldon-core seldon-core-operator \
-    --repo https://storage.googleapis.com/seldon-charts \
-    --set usageMetrics.enabled=true \
-    --set istio.enabled=true \
-    --namespace seldon-system
-```
-
-{% endtab %}
-
-{% tab title="Ambassador" %}
-
-```bash
-helm install seldon-core seldon-core-operator \
-    --repo https://storage.googleapis.com/seldon-charts \
-    --set usageMetrics.enabled=true \
-    --set ambassador.enabled=true \
-    --namespace seldon-system
-```
-
-{% endtab %}
-
-{% endtabs %}
-
-You can check that your Seldon Controller is running by doing:
-
-```bash
-kubectl get pods -n seldon-system
-```
-
-You should see a `seldon-controller-manager` pod with `STATUS=Running`.
+To install Seldon Core, you can refer to [this](./installation.md#install-seldon-core-with-helm) page.
 
 ## Accessing your models
 

docs-gb/install/azure.md

@@ -136,49 +136,7 @@ For custom configuration and more details on installing Seldon Core with Istio p
 
 ## Install Seldon Core
 
-Before we install Seldon Core, we'll create a new namespace `seldon-system` for the operator to run in:
-
-```bash
-kubectl create namespace seldon-system
-```
-
-We're now ready to install Seldon Core in our cluster. Run the following command for your choice of Ingress:
-
-{% tabs %}
-
-{% tab title="Istio" %}
-
-```bash
-helm install seldon-core seldon-core-operator \
-    --repo https://storage.googleapis.com/seldon-charts \
-    --set usageMetrics.enabled=true \
-    --set istio.enabled=true \
-    --namespace seldon-system
-```
-
-{% endtab %}
-
-{% tab title="Ambassador" %}
-
-```bash
-helm install seldon-core seldon-core-operator \
-    --repo https://storage.googleapis.com/seldon-charts \
-    --set usageMetrics.enabled=true \
-    --set ambassador.enabled=true \
-    --namespace seldon-system
-```
-
-{% endtab %}
-
-{% endtabs %}
-
-You can check that your Seldon Controller is running by doing:
-
-```bash
-kubectl get pods -n seldon-system
-```
-
-You should see a `seldon-controller-manager` pod with `STATUS=Running`.
+To install Seldon Core, you can refer to [this](./installation.md#install-seldon-core-with-helm) page.
 
 ## Accessing your models
 

docs-gb/install/gcp.md

@@ -136,49 +136,7 @@ For custom configuration and more details on installing Seldon Core with Istio p
 
 ## Install Seldon Core
 
-Before we install Seldon Core, we'll create a new namespace `seldon-system` for the operator to run in:
-
-```bash
-kubectl create namespace seldon-system
-```
-
-We're now ready to install Seldon Core in our cluster. Run the following command for your choice of Ingress:
-
-{% tabs %}
-
-{% tab title="Istio" %}
-
-```bash
-helm install seldon-core seldon-core-operator \
-    --repo https://storage.googleapis.com/seldon-charts \
-    --set usageMetrics.enabled=true \
-    --set istio.enabled=true \
-    --namespace seldon-system
-```
-
-{% endtab %}
-
-{% tab title="Ambassador" %}
-
-```bash
-helm install seldon-core seldon-core-operator \
-    --repo https://storage.googleapis.com/seldon-charts \
-    --set usageMetrics.enabled=true \
-    --set ambassador.enabled=true \
-    --namespace seldon-system
-```
-
-{% endtab %}
-
-{% endtabs %}
-
-You can check that your Seldon Controller is running by doing:
-
-```bash
-kubectl get pods -n seldon-system
-```
-
-You should see a `seldon-controller-manager` pod with `STATUS=Running`.
+To install Seldon Core, you can refer to [this](./installation.md#install-seldon-core-with-helm) page.
 
 ## Accessing your models
 

docs-gb/install/installation.md

@@ -3,12 +3,11 @@
 ## Pre-requisites
 
 - Kubernetes cluster >= 1.23
-  - For Openshift it requires version >= 4.10
 - Installer method
   - Helm version >= 3.0
   - Kustomize version >= 0.1.0
 - Ingress
-  - Istio : we recommend >= 1.16
+  - Istio: we recommend >= 1.16
   - Ambassador v1 and v2
 
 ### Kubernetes Compatibility Matrix
@@ -17,48 +16,77 @@ Seldon Core 1.16 bumps minimum Kubernetes version to 1.23. This is because as pa
 
 Following table provides a summary of Seldon Core / Kubernetes version compatibility for recent version of Seldon Core.
 
-| Core Version \ K8s Version | 1.21 | 1.22 | 1.23 | 1.24 | 1.25 | 1.26 | 1.27 |
-|---------------------------|------|------|------|------|------|------|------|
-| 1.11                      | ✓    |      |      |      |      |      |      |
-| 1.12                      | ✓    | ✓    | ✓    | ✓    |      |      |      |
-| 1.13                      | ✓    | ✓    | ✓    | ✓    |      |      |      |
-| 1.14                      | ✓    | ✓    | ✓    | ✓    |      |      |      |
-| 1.15                      | ✓    | ✓    | ✓    | ✓    |      |      |      |
-| 1.16                      |      |      | ✓    | ✓    | ✓    | ✓    | ✓    |
-| 1.17                      |      |      | ✓    | ✓    | ✓    | ✓    | ✓    |
-| 1.18                      |      |      | ✓    | ✓    | ✓    | ✓    | ✓    |
+| Core Version \ K8s Version | 1.23 | 1.24 | 1.25 | 1.26 | 1.27 | 1.28 | 1.29 | 1.30 | 1.31 | 1.32 | 1.33 | 1.34 | 1.35 |
+|----------------------------|------|------|------|------|------|------|------|------|------|------|------|------|------|
+| 1.16                       | ✓    | ✓    | ✓    | ✓    | ✓    |      |      |      |      |      |      |      |      |
+| 1.17                       | ✓    | ✓    | ✓    | ✓    | ✓    |      |      |      |      |      |      |      |      |
+| 1.18                       | ✓    | ✓    | ✓    | ✓    | ✓    |      |      |      |      |      |      |      |      |
+| 1.19                       | ✓    | ✓    | ✓    | ✓    | ✓    | ✓    | ✓    | ✓    | ✓    | ✓    | ✓    | ✓    | ✓    |
 
 It is always recommended to first upgrade Seldon Core to the latest supported version on your Kubernetes cluster and then upgrade the Kubernetes cluster.
 
 ### Running older versions of Seldon Core?
 
-Make sure you read the [Upgrading Seldon Core Guide](../reference/upgrading.md)
+Make sure you read the [Upgrading Seldon Core Guide](../upgrading.md) to understand breaking changes and best practices for upgrading.
 
 - **Seldon Core will stop supporting versions prior to 1.0 so make sure you upgrade.**
-- If you are running an older version of Seldon Core, and will be upgrading it please make sure you read the [Upgrading Seldon Core docs](../reference/upgrading.md) to understand breaking changes and best practices for upgrading.
-- Please see [Migrating from Helm v2 to Helm v3](https://helm.sh/docs/topics/v2_v3_migration/) if you are already running Seldon Core using Helm v2 and wish to upgrade.
 
 # Install Seldon Core with Helm
 
-First [install Helm 3.x](https://docs.helm.sh/docs/intro/install/). When helm is installed you can deploy the seldon controller to manage your Seldon Deployment graphs.
+You will first need to add the seldonio Helm repo:
+```bash
+helm repo add seldonio https://storage.googleapis.com/seldon-charts
+helm repo update
+```
 
-If you want to provide advanced parameters with your installation you can check the full [Seldon Core Helm Chart Reference](../reference/helm.html).
+And then install the `seldon-core-operator` chart:
+```bash
+kubectl create namespace seldon-system
+helm install seldon-core-operator seldonio/seldon-core-operator --namespace seldon-system
+```
 
-The namespace `seldon-system` is preferred, so we can create it:
+To install a specific version of the chart, you can list the available versions:
+```bash
+helm search repo seldon/seldon-core-operator --versions
+```
 
+And then either install it from scratch:
 ```bash
-kubectl create namespace seldon-system
+helm install seldon-core-operator seldonio/seldon-core-operator \
+  --namespace seldon-system \
+  --version 1.17.1
+```
+Or, upgrade your existing installation:
+```bash
+helm upgrade --install seldon-core-operator seldon/seldon-core-operator \
+  --version 1.17.1 \
+  --namespace seldon-system
 ```
 
-Now we can install Seldon Core in the `seldon-system` namespace.
+To install it from a locally downloaded chart(GitHub Release):
+1. Download the chart - https://github.com/SeldonIO/helm-charts/releases/tag/seldon-core-operator-1.18.2
+2. Install the archive from the folder you downloaded it in:
+```bash
+ helm install seldon-core-operator \
+  ./seldon-core-operator-1.18.2.tgz \
+  --namespace seldon-system
+```
+
+To install it from our GCS bucket:
+```bash
+helm install seldon-core-operator \
+  https://storage.googleapis.com/seldon-charts/seldon-core-operator-1.17.1.tgz \
+  --namespace seldon-system
+```
 
+If you want to provide advanced parameters with your installation you can check the full [Seldon Core Helm Chart Reference](./advanced-helm-chart-configuration.md).
+For example, if you want to install the operator with Istio or Ambassador enabled, and usage metrics enabled you can 
 {% tabs %}
 
 {% tab title="Istio" %}
 
 ```bash
-helm install seldon-core seldon-core-operator \
-    --repo https://storage.googleapis.com/seldon-charts \
+helm install seldon-core-operator seldonio/seldon-core-operator \
     --set usageMetrics.enabled=true \
     --set istio.enabled=true \
     --namespace seldon-system
@@ -69,8 +97,7 @@ helm install seldon-core seldon-core-operator \
 {% tab title="Ambassador" %}
 
 ```bash
-helm install seldon-core seldon-core-operator \
-    --repo https://storage.googleapis.com/seldon-charts \
+helm install seldon-core-operator seldonio/seldon-core-operator \
     --set usageMetrics.enabled=true \
     --set ambassador.enabled=true \
     --namespace seldon-system
@@ -80,14 +107,18 @@ helm install seldon-core seldon-core-operator \
 
 {% endtabs %}
 
-For full instructions on installation with Istio and Ambassador read the following pages:
+You can check that the operator is running:
+```bash
+kubectl get pods -n seldon-system
+```
 
-- [Ingress with Istio](../ingress/istio.md)
-- [Ingress with Ambassador](../ingress/ambassador.md)
+You should see a `seldon-controller-manager` pod with `STATUS=Running`.
 
-### Install a specific version
 
-In order to install a specific version you can do so by running the same command above with the `--version` flag, followed by the version you want to run.
+For full instructions on installation with Istio and Ambassador read the following pages:
+
+- [Ingress with Istio](../routing/istio.md)
+- [Ingress with Ambassador](../routing/ambassador.md)
 
 ### Install a SNAPSHOT version
 
@@ -97,13 +128,7 @@ This means that you can try out a dev version of master if you want to try a spe
 
 For this you would be able to clone the repository, and then checkout the relevant SNAPSHOT branch.
 
-Once you have done that you can install seldon-core using the following command:
-
-```bash
-helm install helm-charts/seldon-core-operator seldon-core-operator
-```
-
-In this case `helm-charts/seldon-core-operator` is the folder within the repository that contains the charts.
+Once you have done that you can install the `seldon-core-operator`, as described above in the page.
 
 ### Install with cert-manager
 
@@ -169,7 +194,7 @@ You can install Seldon Core from [Operator Hub](https://operatorhub.io/operator/
 
 # Upgrading from Previous Versions
 
-See our [upgrading notes](../reference/upgrading.md)
+See our [upgrading notes](../upgrading.md)
 
 # Advanced Usage
 
@@ -191,7 +216,8 @@ We label the namespace with `seldon.io/controller-id=<namespace>` to ensure if t
 Install the Operator into the namespace:
 
 ```bash
-helm install seldon-namespaced seldon-core-operator  --repo https://storage.googleapis.com/seldon-charts  \
+helm install seldon-namespaced seldon-core-operator \
+    --repo https://storage.googleapis.com/seldon-charts \
     --set singleNamespace=true \
     --set image.pullPolicy=IfNotPresent \
     --set usageMetrics.enabled=false \
@@ -247,7 +273,7 @@ An example install is provided in the Makefile in the Operator folder:
 make deploy-controllerid
 ```
 
-See the [multiple server example notebook](../examples/multiple_operators.html).
+See the [multiple server example notebook](../notebooks/multiple_operators.md).
 
 ## Install behind a proxy
 

docs-gb/install/kind.md

@@ -183,49 +183,7 @@ For custom configuration and more details on installing Seldon Core with Istio p
 
 ## Install Seldon Core
 
-Before we install Seldon Core, we'll create a new namespace `seldon-system` for the operator to run in:
-
-```bash
-kubectl create namespace seldon-system
-```
-
-We're now ready to install Seldon Core in our cluster. Run the following command for your choice of Ingress:
-
-{% tabs %}
-
-{% tab title="Istio" %}
-
-```bash
-helm install seldon-core seldon-core-operator \
-    --repo https://storage.googleapis.com/seldon-charts \
-    --set usageMetrics.enabled=true \
-    --set istio.enabled=true \
-    --namespace seldon-system
-```
-
-{% endtab %}
-
-{% tab title="Ambassador" %}
-
-```bash
-helm install seldon-core seldon-core-operator \
-    --repo https://storage.googleapis.com/seldon-charts \
-    --set usageMetrics.enabled=true \
-    --set ambassador.enabled=true \
-    --namespace seldon-system
-```
-
-{% endtab %}
-
-{% endtabs %}
-
-You can check that your Seldon Controller is running by doing:
-
-```bash
-kubectl get pods -n seldon-system
-```
-
-You should see a `seldon-controller-manager` pod with `STATUS=Running`.
+To install Seldon Core, you can refer to [this](./installation.md#install-seldon-core-with-helm) page.
 
 ## Local Port Forwarding