Skip to content

Commit

Permalink
Advise users to set --validate=false when installing with kubectl
Browse files Browse the repository at this point in the history
Signed-off-by: James Munnelly <james@munnelly.eu>
  • Loading branch information
munnerz committed Oct 10, 2019
1 parent dd0c89a commit ac51e06
Show file tree
Hide file tree
Showing 2 changed files with 15 additions and 11 deletions.
13 changes: 7 additions & 6 deletions docs/getting-started/install/kubernetes.rst
Original file line number Diff line number Diff line change
Expand Up @@ -61,12 +61,13 @@ are included in a single YAML manifest file:
kubectl apply -f https://github.com/jetstack/cert-manager/releases/download/v0.11.0/cert-manager.yaml
.. note::
If you are running kubectl v1.12 or below, you will need to add the
If you are running Kubernetes v1.15 or below, you will need to add the
``--validate=false`` flag to your ``kubectl apply`` command above else you
will receive a validation error relating to the ``caBundle`` field of the
``ValidatingWebhookConfiguration`` resource.
This issue is resolved in Kubernetes 1.13 onwards. More details can be found
in `kubernetes/kubernetes#69590`_.
will receive a validation error relating to the
``x-kubernetes-preserve-unknown-fields`` field in our
``CustomResourceDefinition`` resources.
This is a benign error and occurs due to the way ``kubectl`` performs
resource validation.

.. note::
When running on GKE (Google Kubernetes Engine), you may encounter a
Expand Down Expand Up @@ -116,7 +117,7 @@ In order to install the Helm chart, you must run:
.. code-block:: shell
# Install the CustomResourceDefinition resources separately
kubectl apply -f https://raw.githubusercontent.com/jetstack/cert-manager/release-0.11/deploy/manifests/00-crds.yaml
kubectl apply --validate=false -f https://raw.githubusercontent.com/jetstack/cert-manager/release-0.11/deploy/manifests/00-crds.yaml
# Create the namespace for cert-manager
kubectl create namespace cert-manager
Expand Down
13 changes: 8 additions & 5 deletions docs/tasks/upgrading/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,7 @@ version number you want to install:
# Install the cert-manager CustomResourceDefinition resources before
# upgrading the Helm chart
kubectl apply \
--validate=false \
-f https://raw.githubusercontent.com/jetstack/cert-manager/<version>/deploy/manifests/00-crds.yaml
# Add the Jetstack Helm repository if you haven't already
Expand Down Expand Up @@ -67,15 +68,17 @@ version number you want to install:
.. code:: shell
kubectl apply \
--validate=false \
-f https://github.com/jetstack/cert-manager/releases/download/<version>/cert-manager.yaml
.. note::
If you are running kubectl v1.12 or below, you will need to add the
If you are running Kubernetes v1.15 or below, you will need to add the
``--validate=false`` flag to your ``kubectl apply`` command above else you
will receive a validation error relating to the ``caBundle`` field of the
``ValidatingWebhookConfiguration`` resource.
This issue is resolved in Kubernetes 1.13 onwards. More details can be found
in `kubernetes/kubernetes#69590`_.
will receive a validation error relating to the
``x-kubernetes-preserve-unknown-fields`` field in our
``CustomResourceDefinition`` resources.
This is a benign error and occurs due to the way ``kubectl`` performs
resource validation.

.. toctree::
:maxdepth: 1
Expand Down

0 comments on commit ac51e06

Please sign in to comment.