Uploaded image for project: 'OpenShift Over the Air'
  1. OpenShift Over the Air
  2. OTA-474

Add documentation draft around what happens in the background during upgrade


    • Icon: Task Task
    • Resolution: Done
    • Icon: Major Major
    • None
    • None
    • None
    • OTA 208, OTA 207, OTA 209, OTA 229, OTA 230, OTA 231, OTA 232, OTA 233, OTA 234, OTA 235

      Definition of Done after OTA-904:

      Write draft content targeting the following intent:

      • Extend Understanding OpenShift Container Platform updates with high-level concepts and information about the update process. The page should have:
        • top-level summary (two paragraphs about CVO talking to OSUS, updates delivered via an image, and CVO being a controller that brings cluster components to their new versions. A diagram could be useful.
        • middle-level: slightly more details about main concepts and a high-level upgrade procedure description. This should be accompanied by visual elements (if needed beyond the one in a.)
        • detail-level: only for major concepts, not for everything. Major concepts are individual manifest reconciliation (runlevels, waits on progressing=false) and node upgrades. Where relevant, this should also contain facts relevant for understanding upgrade duration.
      • Duplicate the content in Architecture: Installation and Upgrade page.
      • Do not add any more content into the Understanding OpenShift Container Platform update duration

      Explain basics of how the upgrade is applied :

      • CVO fetches release image
      • CVO updates operators in the following order
      • Each operator is expected to monitor for success
      • Provide example ordering of manifests and command to extract release specific manifests and infer the ordering .

      Note from rh-ee-smodeel in OTA-922

      • In 4.13 we show a banner to say upgrade is in progress and also the Order of cluster operator updates and their status.
        Add docs to look at release image and show the order of manifests applied. 

      Refer https://github.com/openshift/enhancements/tree/master/dev-guide/cluster-version-operator/

       Video from Jatan Malde: https://drive.google.com/file/d/1V1gqpVYvg3-dlnLjp9NjKgX9TmLyPtdi/view?usp=sharing 

            afri@afri.cz Petr Muller
            lmohanty@redhat.com Lalatendu Mohanty
            Evgeni Vakhonin Evgeni Vakhonin
            0 Vote for this issue
            7 Start watching this issue