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

sysext: Document setting up a symlink to /dev/null to disable default #298

Merged
merged 1 commit into from
Apr 6, 2023
Merged

sysext: Document setting up a symlink to /dev/null to disable default #298

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 7 additions & 2 deletions docs/container-runtimes/use-a-custom-docker-or-containerd-version.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -133,8 +133,13 @@ storage:
[plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc.options]
SystemdCgroup = true
directories:
- path: /etc/extensions/docker-flatcar
- path: /etc/extensions/containerd-flatcar
links:
- path: /etc/extensions/docker-flatcar.raw
target: /dev/null
overwrite: true
- path: /etc/extensions/containerd-flatcar.raw
target: /dev/null
overwrite: true
```

While the system services have a `PATH` variable that prefers `/opt/bin/` by placing it first, you have to run the following command on every interactive login shell (also after `sudo` or `su`) to make sure you use the correct binaries.
Expand Down
12 changes: 8 additions & 4 deletions docs/provisioning/sysext/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ Upholds=docker.socket
## Supplying your sysext image from Ignition

The following Butane Config YAML can be be transpiled to Ignition JSON and will download a custom Docker+containerd sysext image on first boot.
It also takes care of disabling Torcx and future built-in Docker and containerd sysext images we plan to ship in Flatcar.
It also takes care of disabling Torcx and future built-in Docker and containerd sysext images we plan to ship in Flatcar (to revert this, you can find the original target of the symlinks in `/usr/share/flatcar/etc/extensions/` - as said, this is not yet shipped).

```yaml
variant: flatcar
Expand All @@ -65,9 +65,13 @@ storage:
contents:
source: https://myserver.net/mydocker.raw
- path: /etc/systemd/system-generators/torcx-generator
directories:
- path: /etc/extensions/docker-flatcar
- path: /etc/extensions/containerd-flatcar
links:
- path: /etc/extensions/docker-flatcar.raw
target: /dev/null
overwrite: true
- path: /etc/extensions/containerd-flatcar.raw
target: /dev/null
overwrite: true
```
After boot you can see it loaded in the output of the `systemd-sysext` command:
Expand Down