fix: zed upgrade to 2023.1

doc/source/index.rst

@@ -26,6 +26,7 @@ curated by years of experience from our team alongside other features such as:
    quick-start
    config/index
    deploy/index
+   upgrade/index
    admin/index
 
 

doc/source/upgrade/index.rst

@@ -0,0 +1,31 @@
+#############
+Upgrade Guide
+#############
+
+There can be prepare works before perform upgrade Atmosphere cross branch.
+
+This document will provide guideline for Atmosphere upgrade.
+
+General Upgrade process
+=======================
+
+Upgrade Atmosphere in general just need to tag new Atmosphere version.
+You can reference deployment guideline for more detail.
+
+Cross branch Upgrade
+====================
+
+Here we documentation some breaking changes that need to be in place for upgrade.
+
+stable/zed to stable/2023.1
+---------------------------
+
+Here are items that need to check before run upgrade from stable/zed to stable/2023.1:
+  * Add Ansible Global Variables `rabbitmq_skip_spec_diff` with value `true`.
+    Because RabbitMQ cluster spec changed when across stable/zed to stable/2023.1.
+
+  * Following Helm releases should be uninstall due to CRD changed:
+
+    * prometheus-pushgateway
+    * rabbitmq-messaging-topology-operator
+    * node-feature-discovery-worker

roles/ingress_nginx/vars/main.yml

@@ -14,6 +14,7 @@
 
 _ingress_nginx_helm_values:
   controller:
+    allowSnippetAnnotations: true
     image:
       registry: "{{ atmosphere_images['ingress_nginx_controller'] | vexxhost.kubernetes.docker_image('domain') }}"
       image: "{{ atmosphere_images['ingress_nginx_controller'] | vexxhost.kubernetes.docker_image('path') }}"

roles/keycloak/tasks/main.yml

@@ -33,7 +33,7 @@
       - version
   register: mysql_ready
   until: mysql_ready is not failed
-  retries: 10
+  retries: 60
   delay: 5
 
 - name: Create Keycloak database

zuul.d/jobs.yaml

@@ -84,3 +84,9 @@
     parent: atmosphere-molecule-aio-full
     vars:
       tox_envlist: molecule-aio-ovn
+
+- job:
+    name: atmosphere-molecule-aio-upgrade-zed-2023.1
+    run: zuul.d/playbooks/upgrade/run-zed-2023.1.yml
+    timeout: 10800
+    parent: atmosphere-molecule-aio-full

zuul.d/playbooks/upgrade/run-zed-2023.1.yml

@@ -0,0 +1,84 @@
+# Copyright (c) 2024 VEXXHOST, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+- name: Upgrade test
+  hosts: all
+  become: true
+  tasks:
+    - name: Checkout to Zed branch
+      become: true
+      ansible.builtin.shell: |
+        git stash
+        git checkout stable/zed
+      args:
+        chdir: "{{ zuul.project.src_dir }}"
+
+    - name: run molecule
+      become: true
+      ansible.builtin.shell: |
+        export ATMOSPHERE_NETWORK_BACKEND=openvswitch
+        pip install --ignore-installed poetry
+        poetry install
+        poetry run molecule test -s aio
+      args:
+        chdir: "{{ zuul.project.src_dir }}"
+
+    # Prepare for 2023.1 branch
+    - name: Uninstall Helm chart rabbitmq-cluster-operator
+      run_once: true
+      kubernetes.core.helm:
+        name: 'rabbitmq-cluster-operator'
+        release_namespace: 'openstack'
+        state: absent
+        wait: true
+
+    - name: Uninstall Helm chart node-feature-discovery
+      run_once: true
+      kubernetes.core.helm:
+        name: 'node-feature-discovery'
+        release_namespace: 'monitoring'
+        state: absent
+        wait: true
+
+    - name: Uninstall Helm chart prometheus-pushgateway
+      run_once: true
+      kubernetes.core.helm:
+        name: 'prometheus-pushgateway'
+        release_namespace: 'monitoring'
+        state: absent
+        wait: true
+
+    - name: Add rabbitmq_skip_spec_diff
+      ansible.builtin.lineinfile:
+        path: "{{ ansible_user_dir }}/{{ zuul.project.src_dir }}/molecule/aio/group_vars/all/molecule.yml"
+        insertafter: EOF
+        line: 'rabbitmq_skip_spec_diff: true'
+
+    - name: Checkout to new branch
+      become: true
+      ansible.builtin.shell: |
+        git restore .
+        git checkout stable/2023.1
+        git stash pop
+      args:
+        chdir: "{{ zuul.project.src_dir }}"
+
+    - name: run molecule
+      become: true
+      ansible.builtin.shell: |
+        export ATMOSPHERE_NETWORK_BACKEND=openvswitch
+        poetry install
+        poetry run molecule test -s aio
+      args:
+        chdir: "{{ zuul.project.src_dir }}"

zuul.d/project.yaml

@@ -74,6 +74,8 @@
             dependencies: *molecule_check_dependencies
         - atmosphere-molecule-aio-ovn:
             dependencies: *molecule_check_dependencies
+        - atmosphere-molecule-aio-upgrade-zed-2023.1:
+            dependencies: *molecule_check_dependencies
         - atmosphere-molecule-csi-local-path-provisioner:
             dependencies: *molecule_check_dependencies
         - atmosphere-molecule-csi-rbd: