Skip to content

Tune to You Needs

Artefacts#

The mio-wizard – One-Shot Edition can be downloaded from either the Stable Releases or Packages pages. Depending on your Debian 12 / Bookworm base image, you will need to install some additional system packages.

Local install#

curl -OJ https://codeberg.org/api/packages/kosmonum/generic/mio-ose/next/mio-wizard
sudo install -m 755 -o root -g root mio-wizard /usr/local/bin/mio-wizard
sudo mio-wizard install

Head over to our Getting Started section. There, you can find more information about the next steps.

Continues Integration#

All of the OCI/Docker images we provide come with everything you need.

This is a minimal example of a pipeline for a system upgrade task. Extend and adjust it to your needs.

Jump In Automation

Join our Vision Supporters Channel to gain access to our maintained, ready-to-use action and workflow integrations.

Optimize your pipeline

  • Utilize your CI-Actions to abstract boilerplate tasks, which can help lower the mental load and improve code maintainability.
  • Look up your CI-pipeline capabilities to reuse code blocks, for example, by using Woodpeckers's sequence merges or Bitbucket's YAML anchors.
  • If you are using Woodpecker-CI, remember to adjust the evaluate expression when running individual steps exclusively.
  • If your pipeline does not support filtering, consider prepending additional checks. For instance, you can use the following conditional statement in a Bitbucket pipeline to prevent running the build on the master branch: if [ "${BITBUCKET_BRANCH:-}" != "master" ]; then exit 2; fi
Woodpecker-CI 
# yaml-language-server: $schema=https://codeberg.org/Codeberg-CI/woodpecker/raw/branch/main/pipeline/frontend/yaml/linter/schema/schema.json
---
when:
  - event: manual
    branch: master

steps:
  upgrade:
    image: codeberg.org/kosmonum/mio-ose/mio:next
  commands:
    # init
    - mio-wizard id
    - mio-wizard init
    - . ./activate
    # task
    # Use an additional pipeline variable to select the INSTANCE.
    - |
      if [ -n "${INSTANCE:-}" ]; then
        make HOSTS="${INSTANCE}" do-backup do-upgrade do-cleanup
      else
        make do-backup do-upgrade do-cleanup
      fi
  environment:
    MIO_ID_KEY_B64S:
      from_secret: key
    MIO_ID_KEY_PW_B64S:
      from_secret: key-pw

Development#

General instructions will be provided subsequently.