132440451d
Splitting subiquity into server and client means that in general old versions of the client can still be running when the server is updated (the client running on tty1 will be restarted by snapd/systemd when the snap is updated but clients running via e.g. ssh will not). I implemented a way for the client to detect this and restart itself: the server sets a header in all responses that indicates if it has been updated. So far so good. But the way it knows that it has been updated is to check the presence of a file that is only created when subiquity itself triggers the refresh, so it's not there in the case of manual refresh, and as reported in https://bugs.launchpad.net/bugs/1921820 this can lead to the client crashing because it cannot parse the new server's response. This simply changes to creating the marker file in the snap post-refresh hook, which will be executed for manual snap refreshes as well. While I'm at it, remove the rest of the post-install hook that restarted subiquity clients running on the serial line as the generic machinery will work for these too. |
||
---|---|---|
.github/workflows | ||
bin | ||
console_conf | ||
debian | ||
examples | ||
fake_deps | ||
font | ||
kbds | ||
po | ||
scripts | ||
snap/hooks | ||
subiquity | ||
subiquitycore | ||
.flake8 | ||
.gitignore | ||
.gitmodules | ||
DESIGN.md | ||
LICENSE | ||
Makefile | ||
README.md | ||
autoinstall-schema.json | ||
languagelist | ||
requirements.txt | ||
reserved-usernames | ||
setup.py | ||
snapcraft.yaml | ||
tox.ini | ||
users-and-groups |
README.md
subiquity & console-conf
Ubuntu Server Installer & Snappy first boot experience
The repository contains the source for the new server installer (the "subiquity" part, aka "ubiquity for servers") and for the snappy first boot experience (the "console-conf" part).
We track bugs in Launchpad at https://bugs.launchpad.net/subiquity. Snappy first boot issues can also be discussed in the forum at https://forum.snapcraft.io.
Our localization platform is Launchpad, translations are managed at https://translations.launchpad.net/ubuntu/+source/subiquity/
To update translation template in launchpad:
- update po/POTFILES.in with any new files that contain translations
- execute clean target, i.e. $ debuild -S
- dput subiquity into Ubuntu
To export and update translations in subiquity:
- Wait for new subiquity to publish
- Request fresh translation export from Launchpad at https://translations.launchpad.net/ubuntu/focal/+source/subiquity/+export
- wait for export to generate
- download, unpack, rename .po files into po directory, and commit changes
Acquire subiquity from source
git clone https://github.com/canonical/subiquity
cd subiquity && make install_deps
Testing out the installer Text-UI (TUI)
SUbiquity's text UI is available for testing without actually installing anything to a system or a VM. Subiquity developers make use of this for rapid development. After checking out subiquity you can start it:
make dryrun
All of the features are present in dry-run mode. The installer will emit its backend configuration files to /tmp/subiquity-config-* but it won't attempt to run any installer commands (which would fail without root privileges). Further, subiquity can load other machine profiles in case you want to test out the installer without having access to the machine. A few sample machine profiles are available in the repository at ./examples/ and can be loaded via the MACHINE make variable:
make dryrun MACHINE=examples/simple.json
Generating machine profiles
Machine profiles are generated from the probert tool. To collect a machine profile:
PYTHONPATH=probert ./probert/bin/probert --all > mymachine.json
Testing changes in KVM
To try out your changes for real, it is necessary to install them into an ISO. Rather than building one from scratch, it's much easier to install your version of subiquity into the daily image. Here's how to do this:
-
Build your change into a snap:
$ snapcraft snap --output subiquity_test.snap
-
Grab the current version of the installer:
$ urlbase=http://cdimage.ubuntu.com/ubuntu-server/daily-live/current $ isoname=$(distro-info -d)-live-server-$(dpkg --print-architecture).iso $ zsync ${urlbase}/${isoname}.zsync
-
Run the provided script to make a copy of the downloaded installer that has your version of subiquity:
$ sudo ./scripts/inject-subiquity-snap.sh ${isoname} subiquity_test.snap custom.iso
-
Boot the new iso in KVM:
$ qemu-img create -f raw target.img 10G $ kvm -m 1024 -boot d -cdrom custom.iso -hda target.img -serial stdio
-
Finally, boot the installed image:
$ kvm -m 1024 -hda target.img -serial stdio
The first three steps are bundled into the script ./scripts/test-this-branch.sh.