Skip to content
This repository has been archived by the owner on Oct 26, 2023. It is now read-only.

Commit

Permalink
sysext: Add debugging commands
Browse files Browse the repository at this point in the history
When unsure what files an image ships or why the image is not compatible
it can help to list the image contents or show the debug output from the
matching.
  • Loading branch information
pothos committed Sep 26, 2023
1 parent 95cbe6d commit f6f54c0
Showing 1 changed file with 15 additions and 0 deletions.
15 changes: 15 additions & 0 deletions docs/provisioning/sysext/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -184,4 +184,19 @@ systemd:
This configuration will enable the `systemd-sysupdate.timer` unit that will check every 2-6 hours for a new Docker sysext image available from the latest release of [`sysext-bakery`][sysext-bakery].
Use `arm64` instead of `x86-64` for arm64 machines.

## Debugging

You can list the contents of a systemd-sysext image like this (assuming an image without dm-verity):

```
sudo unshare -m sh -c "mount docker-compose-2.18.1.raw /tmp && cd /tmp && find usr"
# If you use systemd-sysext for extending "/opt", use "find opt" as last command
```

To get more information about found incompatibilities during merging, enable the debug output:

```
sudo SYSTEMD_LOG_LEVEL=debug systemd-sysext refresh
```

[sysext-bakery]: https://github.com/flatcar/sysext-bakery

0 comments on commit f6f54c0

Please sign in to comment.