Skip to content

Commit

Permalink
docs: add instructions to upgrade admission controller
Browse files Browse the repository at this point in the history
In 1.8, the admission controller has merged with the operator and the
operator needs an emptyDir and a volume mount to store the webhook
certificates.

Co-authored-by: Blaine Gardner <blaine.gardner@redhat.com>
Co-authored-by: Sébastien Han <seb@redhat.com>

Signed-off-by: Blaine Gardner <blaine.gardner@redhat.com>
(cherry picked from commit 6c09de6)
  • Loading branch information
BlaineEXE authored and mergify-bot committed Dec 9, 2021
1 parent 934a575 commit dad8a7e
Showing 1 changed file with 18 additions and 0 deletions.
18 changes: 18 additions & 0 deletions Documentation/ceph-upgrade.md
Original file line number Diff line number Diff line change
Expand Up @@ -340,6 +340,24 @@ When the operator is updated, it will proceed to update all of the Ceph daemons.
kubectl -n $ROOK_OPERATOR_NAMESPACE set image deploy/rook-ceph-operator rook-ceph-operator=rook/ceph:v1.8.0
```

#### Admission controller
If you use the optional [Admission controller](admission-controller-usage.md), there are additional
updates during this step. The admission controller has been integrated inside the operator
instead of a separate deployment. This means that the webhook server certificates are now stored in
the operator, and the operator manifest must be updated to use the one provided in
`deploy/examples/operator.yaml`. If you are using Helm to manage the deployment, this is handled
automatically.

When updating the operator deployment with the latest example from Rook, there is risk of
overwriting changes if you have customized the operator deployment or to the
`rook-ceph-operator-config` ConfigMap. We suggest that you remove the ConfigMap from `operator.yaml`
before moving on. Additionally, we encourage you to diff the current deployment and the latest one
to be sure any changes you may have made don't get overwritten. Required changes include the
`webhook-cert` volume/mount and `https-webhook` port, though there are some smaller changes as well.

Once you are sure any custom modifications to your operator deployment won't be overwritten, apply
the new `operator.yaml` with `kubectl apply -f deploy/examples/operator.yaml`.

### **4. Wait for the upgrade to complete**

Watch now in amazement as the Ceph mons, mgrs, OSDs, rbd-mirrors, MDSes and RGWs are terminated and
Expand Down

0 comments on commit dad8a7e

Please sign in to comment.