GitHub configuration

All new repositories must be configured to use the following branch ruleset: https://raw.githubusercontent.com/seapath/.github/main/branch-default-ruleset.json.

To enable it:

• Go to the project settings

• In the left menu, select "Rulesets" in "Rules"

• Click on the "New ruleset" button, then "Import a ruleset"

• Select the "branch-default-ruleset.json"

• On the new screen go to the end, click on the button "Create"

Release procedure

• Bump SEAPATH Yocto distribution version

• Add v1.0.0.xml file in repo-manifest (pointing to v1.0.0 repositories using commit ID)

• Use this v1.0.0.xml file as default manifest

• tag these repositories with v1.0.0:

  • ansible

  • build_debian_iso

  • yocto_bsp

  • meta-seapath

  • ansible-role-systemd-networkd

  • vm_manager

  • cockpit-*

  • python3-setup-ovs

  • repo-manifest

  • snmp_passpersist

  • cukinia-tests

• Revert the repo-manifest

• Publish ansible code on ansible-galaxy with version v1.0.0

• Write a wiki page with all the release note

• Write one dedicated release note for the following repositories :

  • ansible

  • build_debian_iso

  • yocto_bsp

Release validation tests

The following tasks should be validated before any new release.

Yocto

• Validate the following image builds with cqfd. Also, keep built .wic and .swu image files marked with a * for later use.

• Flasher *
• cqfd -b flasher
• Hypervisor cluster
• Release image * → cqfd -b host_efi_swu
• Debug image → cqfd -b host_efi_dbg_swu
• Minimal image → cqfd -b host_efi_minimal
• Hypervisor standalone *
• cqfd run ./build.sh -v -i seapath-host-efi-swu-image --distro seapath-standalone-host
• Guest
• Release image * → cqfd -b guest_efi
• Debug image → cqfd -b guest_efi_dbg
• Observer *
• cqfd -b observer_efi_swu
• Create a SEAPATH flasher USB key.
• Flash and validate a standalone hypervisor
• Flash a machine with the built standalone release image using the flasher.
• Boot the newly flashed machine, check that it is reachable from SSH.
• Ansible configuration → Use the revision that will be release of SEAPATH Ansible
• Set up the Ansible inventory for the standalone test machine
• Configure the standalone hypervisor: cqfd run ansible-playbook --limit standalone_machine --skip-tags "package-install" playbooks/seapath_setup_main.yaml
• Flash a SEAPATH cluster: 2 hypervisors and 1 observer
• Run Ansible setup on the SEAPATH cluster
• Set up the Ansible inventory for the cluster
• Configure the cluster cqfd run ansible-playbook --limit cluster_machines --skip-tags "package-install" playbooks/seapath_setup_main.yaml
• Run Cukinia tests
• Run Cukinia’s test on a standalone hypervisor
• Run Cukinia’s test on a hypervisor inside a cluster
• Run Cukinia’s test on an observer
• Run Cukinia’s test on a VM
• Deploy a standalone VM
• Deploy a VM in a cluster

Debian

TODO