Document importing local container images

Closes #492

Signed-off-by: Jonathon Anderson <janderson@ciq.co>
This commit is contained in:
Jonathon Anderson
2023-04-21 15:42:30 -06:00
parent d9782688b1
commit b0f3a8e4ae

View File

@@ -37,8 +37,8 @@ Apptainer is the most utilized container management tool. You can use
any of these to create and manage the containers to be later imported any of these to create and manage the containers to be later imported
into Warewulf. into Warewulf.
Importing From A Registry Importing Containers
========================= ====================
Warewulf supports importing an image from any OCI compliant Warewulf supports importing an image from any OCI compliant
registry. This means you can import from a public registry or from a registry. This means you can import from a public registry or from a
@@ -104,8 +104,29 @@ doing it this way if you are in a security sensitive environment or
shared environments. You would not want these showing up in bash shared environments. You would not want these showing up in bash
history or logs. history or logs.
Local Files
-----------
It is also possible to import a container from a local file or
directory. For example, Podman can save a `.tar` archive of an OCI
image. This archive can be directly imported into Warewulf, no
registry required.
.. code-block:: console
# podman save alpine:latest >alpine.tar
# wwctl container import alpine.tar alpine
Chroot directories and Apptainer sandbox images can also be imported
directly.
.. code-block:: console
$ apptainer build --sandbox ./rockylinux-8/ docker://ghcr.io/hpcng/warewulf-rockylinux:8
$ sudo wwctl container import ./rockylinux-8/ rockylinux-8
Syncuser Syncuser
-------- ========
At import time Warewulf checks if the names of the users on the host At import time Warewulf checks if the names of the users on the host
match the users and UIDs/GIDs in the imported container. If there is match the users and UIDs/GIDs in the imported container. If there is