Skip to content

Commit

Permalink
Use rootlesskit instead of buildah unshare in the docs (#2980)
Browse files Browse the repository at this point in the history
They seem to do equivalent things (put us into the fake root environment
created using newuidmap/newgidmap. However, `buildah` appears to be a
podman tool. This PR updates it to rootlesskit so that everything is in
the Docker world.

Came across `rootlesskit` here:
https://forums.docker.com/t/proper-way-to-share-data-root-directory-in-rootless-mode/120448/2
  • Loading branch information
ben-z authored Aug 9, 2024
1 parent 7bfc2f4 commit ad96368
Showing 1 changed file with 3 additions and 3 deletions.
6 changes: 3 additions & 3 deletions pages/docs/compute-cluster/machine-usage-guide.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -305,12 +305,12 @@ For more information about storage quotas, please see the [Quotas](./quotas) pag
To free up space for Docker, you can selectively delete files from the `/var/lib/cluster/users/$(id -u)/docker` directory until you are no longer over quota. However, it could be difficult to determine which files to delete. If you would like to delete all your Docker files (including images, containers, volumes, etc.), which effectively resets your Docker installation, you can delete the entire directory:

```bash copy
buildah unshare rm -r /var/lib/cluster/users/$(id -u)/docker
rootlesskit rm -r /var/lib/cluster/users/$(id -u)/docker
```

Here, `buildah unshare{:bash}` puts us in the USERNS[^buildah-unshare], which allows us to manage files created by `uidmap` (used by Docker rootless).
Here, `rootlesskit{:bash}` puts us in the "fake root" environment used by Docker rootless[^rootlesskit], which allows us to manage files owned by subuid/subgid.

[^buildah-unshare]: https://github.com/containers/podman/issues/1386#issuecomment-417640661
[^rootlesskit]: Learn more about rootlesskit [here](https://github.com/rootless-containers/rootlesskit).

If you would prefer to use Docker tools to clean up your Docker installation (e.g. `docker system prune --all{:bash}`), you can reach out to a WATcloud team member to temporarily increase your storage quota so that Docker daemon can be started.

Expand Down

0 comments on commit ad96368

Please sign in to comment.