From 1dc8b46539b31062ce60d5dd035f9f6bc68ed5e4 Mon Sep 17 00:00:00 2001 From: Jonathon Anderson Date: Thu, 26 Sep 2024 18:12:17 -0600 Subject: [PATCH] Added workaround documentation for importing containers with sockets. - Workaround for #892 Signed-off-by: Jonathon Anderson --- CHANGELOG.md | 1 + userdocs/contents/containers.rst | 36 ++++++++++++++++++++++++++++++-- 2 files changed, 35 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index d4992f64d..fd46a93fd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -53,6 +53,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). - Added `--syncuser` flag to `wwctl container shell`. #1358 - Added a troubleshooting guide. #1234 +- Added workaround documentation for importing containers with sockets. #892 ### Changed diff --git a/userdocs/contents/containers.rst b/userdocs/contents/containers.rst index 2ee7a236a..ae1635e19 100644 --- a/userdocs/contents/containers.rst +++ b/userdocs/contents/containers.rst @@ -122,6 +122,21 @@ directly. $ apptainer build --sandbox ./rockylinux-8/ docker://ghcr.io/warewulf/warewulf-rockylinux:8 $ sudo wwctl container import ./rockylinux-8/ rockylinux-8 +.. note:: + + If a source directory includes persistent sockets, these sockets may cause the import operation to fail. + + .. code-block:: + + Copying sources... + ERROR : could not import image: lchown ./rockylinux-8/run/user/0/gnupg/d.kg8ijih5tq41ixoeag4p1qup/S.gpg-agent: no such file or directory + + To resolve this, remove the sockets from the source directory. + + .. code-block:: bash + + find ./rockylinux-8/ -type s -delete + HTTP proxies ------------ @@ -382,7 +397,8 @@ issues in most circumstances: your system BIOS or firmware. Duplicating a container -============================ +======================= + It is possible to duplicate an installed image by using : .. code-block:: console @@ -391,8 +407,24 @@ It is possible to duplicate an installed image by using : This kind of duplication can be useful if you are looking for canary tests. +.. note:: + + If a source container includes persistent sockets, these sockets may cause the copy operation to fail. + + .. code-block:: + + Copying sources... + ERROR : could not duplicate image: lchown /var/lib/warewulf/chroots/rocky-8/rootfs/run/user/0/gnupg/d.kg8ijih5tq41ixoeag4p1qup/S.gpg-agent: no such file or directory + + To resolve this, remove the sockets from the source container. + + .. code-block:: bash + + find $(wwctl container show rocky-8) -type s -delete + Multi-arch container management -============================ +=============================== + It is possible to build, edit, and provision containers of different architectures (i.e. aarch64) from an x86_64 host by using QEMU. Simply run the appropriate command below based on your container management tools.