[apisix-helm-chart] branch master updated: doc: update readme (#61)

[to...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

tokers pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/apisix-helm-chart.git


The following commit(s) were added to refs/heads/master by this push:
     new e26517c  doc: update readme (#61)
e26517c is described below

commit e26517c5302d3d839c2f483a211c60dd55d43c0d
Author: Alex Zhang <zc...@gmail.com>
AuthorDate: Wed Apr 14 15:19:36 2021 +0800

    doc: update readme (#61)
---
 docs/en/latest/apisix-ingress-controller.md | 39 +++++++++++++++++++++++++++--
 1 file changed, 37 insertions(+), 2 deletions(-)

diff --git a/docs/en/latest/apisix-ingress-controller.md b/docs/en/latest/apisix-ingress-controller.md
index 8893596..ba6f933 100644
--- a/docs/en/latest/apisix-ingress-controller.md
+++ b/docs/en/latest/apisix-ingress-controller.md
@@ -29,10 +29,12 @@ title: Apache APISIX Ingress Controller Helm Chart
 
 ## Install
 
-To install the chart with release name `apisix-ingress-controller`:
+To install apisix-ingress-controller which release name is `apisix-ingress-controller`:
 
 ```bash
-helm install apisix-ingress-controller --namespace ingress-apisix .
+$ helm repo add apisix https://charts.apiseven.com
+$ helm repo update
+$ helm install apisix-ingress-controller apisix/apisix-ingress-controller --namespace ingress-apisix
 ```
 
 ## Uninstall
@@ -42,3 +44,36 @@ To uninstall/delete the `apisix-ingress-controller` release:
 ```bash
 helm uninstall apisix-ingress-controller --namespace ingress-apisix
 ```
+
+## Deployment Options
+
+### ingress version
+
+By default apisix-ingress-controller watches the [Ingress](https://kubernetes.io/docs/concepts/services-networking/ingress/) resources in api group `networking/v1`, however, if your Kubernetes cluster is prior to `v1.19`, you need to change the ingress watching version.
+
+If your Kubernetes version is older than `v1.14`, then:
+
+```shell
+helm install apisix-ingress-controller apisix/apisix-ingress-controller --namespace ingress-apisix --set config.kubernetes.ingressVersion=extensions/v1beta1
+```
+
+Or if your Kubernetes version is between `v1.14` and `v1.19`, try below:
+
+```shell
+helm install apisix-ingress-controller apisix/apisix-ingress-controller --namespace ingress-apisix --set config.kubernetes.ingressVersion=networking/v1beta1
+```
+
+## Upgrade Considerations
+
+### CRD
+
+CRDs upgrading is special as helm chart will skip to apply these resources when they already exist.
+
+> With the arrival of Helm 3, we removed the old crd-install hooks for a more simple methodology. There is now a special directory called crds that you can create in your chart to hold your CRDs. These CRDs are not templated, but will be installed by default when running a helm install for the chart. If the CRD already exists, it will be skipped with a warning. If you wish to skip the CRD installation step, you can pass the --skip-crds flag.
+
+In such a case, you may need to apply these CRDs by yourself.
+
+```shell
+$ cd /path/to/apisix-ingress-controller
+$ kubectl apply -k samples/deploy/crd/
+```
\ No newline at end of file