Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: keep instances running during update/upgrade #609

Merged
merged 1 commit into from
Feb 5, 2025

Conversation

minaelee
Copy link
Contributor

@minaelee minaelee commented Feb 5, 2025

This PR adds a section in the How to update and upgrade docs page to explain that instances can be left running during and update/upgrade but the storage/network services might briefly be affected. It also explains how to use cluster evacuate to migrate instances away before an update/upgrade, including live migration for pre-configured VMs, and how to use cluster restore to migrate them back afterward.

@github-actions github-actions bot added the Documentation Documentation needs updating label Feb 5, 2025
To ensure that the update or upgrade does not affect workloads on running instances at all, use the following live-migration approach:

- Use virtual machines (VMs) instead of system containers for crucial workloads; in general, containers cannot be live-migrated.
- Each VM must be pre-configured for live migration. See: {ref}`lxd:live-migration-vms` for information on the required configurations.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We have fixed this already in v2-edge and it should be configured by default starting with the next MicroCloud release if you create a new cluster.
But for now I think it makes sense to explicitly document this.

@roosterfish roosterfish merged commit f707e5c into canonical:main Feb 5, 2025
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Documentation Documentation needs updating
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants