From 57fac199cbc1445ae9bc19953633ae8e7b8ec6a9 Mon Sep 17 00:00:00 2001
From: gh-actions SEE ALSOapptainer verify - Verify digital signature(s) within an image
apptainer version - Show the version for Apptainer
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_build.html b/public/docs/user/main/cli/apptainer_build.html index 9895b83d..c09ac63c 100644 --- a/public/docs/user/main/cli/apptainer_build.html +++ b/public/docs/user/main/cli/apptainer_build.html @@ -429,7 +429,7 @@Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_cache_clean.html b/public/docs/user/main/cli/apptainer_cache_clean.html index e432c12a..3a54a9cf 100644 --- a/public/docs/user/main/cli/apptainer_cache_clean.html +++ b/public/docs/user/main/cli/apptainer_cache_clean.html @@ -274,7 +274,7 @@apptainer cache - Manage the local cache
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_cache_list.html b/public/docs/user/main/cli/apptainer_cache_list.html index 13ca6db9..eea719a3 100644 --- a/public/docs/user/main/cli/apptainer_cache_list.html +++ b/public/docs/user/main/cli/apptainer_cache_list.html @@ -269,7 +269,7 @@apptainer cache - Manage the local cache
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_capability.html b/public/docs/user/main/cli/apptainer_capability.html index 7617f772..bd35b308 100644 --- a/public/docs/user/main/cli/apptainer_capability.html +++ b/public/docs/user/main/cli/apptainer_capability.html @@ -276,7 +276,7 @@Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_capability_add.html b/public/docs/user/main/cli/apptainer_capability_add.html index e380dbec..cc597b5b 100644 --- a/public/docs/user/main/cli/apptainer_capability_add.html +++ b/public/docs/user/main/cli/apptainer_capability_add.html @@ -274,7 +274,7 @@apptainer capability - Manage Linux capabilities for users and groups
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_capability_avail.html b/public/docs/user/main/cli/apptainer_capability_avail.html index 5c899177..63a295f3 100644 --- a/public/docs/user/main/cli/apptainer_capability_avail.html +++ b/public/docs/user/main/cli/apptainer_capability_avail.html @@ -272,7 +272,7 @@apptainer capability - Manage Linux capabilities for users and groups
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_capability_drop.html b/public/docs/user/main/cli/apptainer_capability_drop.html index 7db2c4be..d8709eb2 100644 --- a/public/docs/user/main/cli/apptainer_capability_drop.html +++ b/public/docs/user/main/cli/apptainer_capability_drop.html @@ -274,7 +274,7 @@apptainer capability - Manage Linux capabilities for users and groups
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_capability_list.html b/public/docs/user/main/cli/apptainer_capability_list.html index 7f0ec928..837898cd 100644 --- a/public/docs/user/main/cli/apptainer_capability_list.html +++ b/public/docs/user/main/cli/apptainer_capability_list.html @@ -268,7 +268,7 @@apptainer capability - Manage Linux capabilities for users and groups
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_checkpoint.html b/public/docs/user/main/cli/apptainer_checkpoint.html index 3f0f4c17..cc2f5c16 100644 --- a/public/docs/user/main/cli/apptainer_checkpoint.html +++ b/public/docs/user/main/cli/apptainer_checkpoint.html @@ -268,7 +268,7 @@Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_checkpoint_create.html b/public/docs/user/main/cli/apptainer_checkpoint_create.html index 383b06ab..98dd8fd8 100644 --- a/public/docs/user/main/cli/apptainer_checkpoint_create.html +++ b/public/docs/user/main/cli/apptainer_checkpoint_create.html @@ -264,7 +264,7 @@apptainer checkpoint - Manage container checkpoint state (experimental)
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_checkpoint_delete.html b/public/docs/user/main/cli/apptainer_checkpoint_delete.html index e9bdfee6..cbd251a8 100644 --- a/public/docs/user/main/cli/apptainer_checkpoint_delete.html +++ b/public/docs/user/main/cli/apptainer_checkpoint_delete.html @@ -263,7 +263,7 @@apptainer checkpoint - Manage container checkpoint state (experimental)
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_checkpoint_instance.html b/public/docs/user/main/cli/apptainer_checkpoint_instance.html index 4d156026..b495a7dc 100644 --- a/public/docs/user/main/cli/apptainer_checkpoint_instance.html +++ b/public/docs/user/main/cli/apptainer_checkpoint_instance.html @@ -265,7 +265,7 @@apptainer checkpoint - Manage container checkpoint state (experimental)
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_checkpoint_list.html b/public/docs/user/main/cli/apptainer_checkpoint_list.html index d9a9ee88..7582a078 100644 --- a/public/docs/user/main/cli/apptainer_checkpoint_list.html +++ b/public/docs/user/main/cli/apptainer_checkpoint_list.html @@ -264,7 +264,7 @@apptainer checkpoint - Manage container checkpoint state (experimental)
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_config.html b/public/docs/user/main/cli/apptainer_config.html index 32afd58c..a2f58d59 100644 --- a/public/docs/user/main/cli/apptainer_config.html +++ b/public/docs/user/main/cli/apptainer_config.html @@ -267,7 +267,7 @@Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_config_fakeroot.html b/public/docs/user/main/cli/apptainer_config_fakeroot.html index cadb034b..68f5ac86 100644 --- a/public/docs/user/main/cli/apptainer_config_fakeroot.html +++ b/public/docs/user/main/cli/apptainer_config_fakeroot.html @@ -277,7 +277,7 @@apptainer config - Manage various apptainer configuration (root user only)
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_config_global.html b/public/docs/user/main/cli/apptainer_config_global.html index 0c2b5254..f3f2cbcb 100644 --- a/public/docs/user/main/cli/apptainer_config_global.html +++ b/public/docs/user/main/cli/apptainer_config_global.html @@ -281,7 +281,7 @@apptainer config - Manage various apptainer configuration (root user only)
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_delete.html b/public/docs/user/main/cli/apptainer_delete.html index 4db69205..6e3b7e26 100644 --- a/public/docs/user/main/cli/apptainer_delete.html +++ b/public/docs/user/main/cli/apptainer_delete.html @@ -268,7 +268,7 @@Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_instance_list.html b/public/docs/user/main/cli/apptainer_instance_list.html index 033d80e4..75f4174f 100644 --- a/public/docs/user/main/cli/apptainer_instance_list.html +++ b/public/docs/user/main/cli/apptainer_instance_list.html @@ -281,7 +281,7 @@apptainer instance - Manage containers running as services
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_instance_run.html b/public/docs/user/main/cli/apptainer_instance_run.html index 72f20af4..4b256056 100644 --- a/public/docs/user/main/cli/apptainer_instance_run.html +++ b/public/docs/user/main/cli/apptainer_instance_run.html @@ -367,7 +367,7 @@apptainer instance - Manage containers running as services
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_instance_start.html b/public/docs/user/main/cli/apptainer_instance_start.html index d8529d79..5987c8e3 100644 --- a/public/docs/user/main/cli/apptainer_instance_start.html +++ b/public/docs/user/main/cli/apptainer_instance_start.html @@ -364,7 +364,7 @@apptainer instance - Manage containers running as services
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_instance_stats.html b/public/docs/user/main/cli/apptainer_instance_stats.html index 08aeac3e..b823c520 100644 --- a/public/docs/user/main/cli/apptainer_instance_stats.html +++ b/public/docs/user/main/cli/apptainer_instance_stats.html @@ -272,7 +272,7 @@apptainer instance - Manage containers running as services
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_instance_stop.html b/public/docs/user/main/cli/apptainer_instance_stop.html index 67063b64..cfc43bd9 100644 --- a/public/docs/user/main/cli/apptainer_instance_stop.html +++ b/public/docs/user/main/cli/apptainer_instance_stop.html @@ -282,7 +282,7 @@apptainer instance - Manage containers running as services
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_key.html b/public/docs/user/main/cli/apptainer_key.html index 92368865..3c716f56 100644 --- a/public/docs/user/main/cli/apptainer_key.html +++ b/public/docs/user/main/cli/apptainer_key.html @@ -277,7 +277,7 @@Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_key_export.html b/public/docs/user/main/cli/apptainer_key_export.html index 4c37b15e..5e505bd6 100644 --- a/public/docs/user/main/cli/apptainer_key_export.html +++ b/public/docs/user/main/cli/apptainer_key_export.html @@ -272,7 +272,7 @@apptainer key - Manage OpenPGP keys
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_key_import.html b/public/docs/user/main/cli/apptainer_key_import.html index 2ed8bf1d..e4e60ee0 100644 --- a/public/docs/user/main/cli/apptainer_key_import.html +++ b/public/docs/user/main/cli/apptainer_key_import.html @@ -269,7 +269,7 @@apptainer key - Manage OpenPGP keys
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_key_list.html b/public/docs/user/main/cli/apptainer_key_list.html index 92b36c32..a6c1ecff 100644 --- a/public/docs/user/main/cli/apptainer_key_list.html +++ b/public/docs/user/main/cli/apptainer_key_list.html @@ -270,7 +270,7 @@apptainer key - Manage OpenPGP keys
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_key_newpair.html b/public/docs/user/main/cli/apptainer_key_newpair.html index 7d470db2..d15a3c04 100644 --- a/public/docs/user/main/cli/apptainer_key_newpair.html +++ b/public/docs/user/main/cli/apptainer_key_newpair.html @@ -272,7 +272,7 @@apptainer key - Manage OpenPGP keys
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_key_pull.html b/public/docs/user/main/cli/apptainer_key_pull.html index 53345ca6..66cac064 100644 --- a/public/docs/user/main/cli/apptainer_key_pull.html +++ b/public/docs/user/main/cli/apptainer_key_pull.html @@ -270,7 +270,7 @@apptainer key - Manage OpenPGP keys
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_key_push.html b/public/docs/user/main/cli/apptainer_key_push.html index 1646aa51..2f0debb6 100644 --- a/public/docs/user/main/cli/apptainer_key_push.html +++ b/public/docs/user/main/cli/apptainer_key_push.html @@ -266,7 +266,7 @@apptainer key - Manage OpenPGP keys
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_key_remove.html b/public/docs/user/main/cli/apptainer_key_remove.html index 4e10928a..562e85e0 100644 --- a/public/docs/user/main/cli/apptainer_key_remove.html +++ b/public/docs/user/main/cli/apptainer_key_remove.html @@ -268,7 +268,7 @@apptainer key - Manage OpenPGP keys
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_key_search.html b/public/docs/user/main/cli/apptainer_key_search.html index fced6004..842956e1 100644 --- a/public/docs/user/main/cli/apptainer_key_search.html +++ b/public/docs/user/main/cli/apptainer_key_search.html @@ -272,7 +272,7 @@apptainer key - Manage OpenPGP keys
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_keyserver.html b/public/docs/user/main/cli/apptainer_keyserver.html index 2de368b2..a3a2a721 100644 --- a/public/docs/user/main/cli/apptainer_keyserver.html +++ b/public/docs/user/main/cli/apptainer_keyserver.html @@ -271,7 +271,7 @@Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_keyserver_add.html b/public/docs/user/main/cli/apptainer_keyserver_add.html index 83baf248..f2a8a232 100644 --- a/public/docs/user/main/cli/apptainer_keyserver_add.html +++ b/public/docs/user/main/cli/apptainer_keyserver_add.html @@ -273,7 +273,7 @@apptainer keyserver - Manage apptainer keyservers
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_keyserver_list.html b/public/docs/user/main/cli/apptainer_keyserver_list.html index c2572a59..1dacc4b7 100644 --- a/public/docs/user/main/cli/apptainer_keyserver_list.html +++ b/public/docs/user/main/cli/apptainer_keyserver_list.html @@ -264,7 +264,7 @@apptainer keyserver - Manage apptainer keyservers
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_keyserver_login.html b/public/docs/user/main/cli/apptainer_keyserver_login.html index 2335ff6e..68d0bd7b 100644 --- a/public/docs/user/main/cli/apptainer_keyserver_login.html +++ b/public/docs/user/main/cli/apptainer_keyserver_login.html @@ -266,7 +266,7 @@apptainer keyserver - Manage apptainer keyservers
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_keyserver_logout.html b/public/docs/user/main/cli/apptainer_keyserver_logout.html index 0c0e2208..566f753f 100644 --- a/public/docs/user/main/cli/apptainer_keyserver_logout.html +++ b/public/docs/user/main/cli/apptainer_keyserver_logout.html @@ -263,7 +263,7 @@apptainer keyserver - Manage apptainer keyservers
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_keyserver_remove.html b/public/docs/user/main/cli/apptainer_keyserver_remove.html index e4c549f0..4a900e80 100644 --- a/public/docs/user/main/cli/apptainer_keyserver_remove.html +++ b/public/docs/user/main/cli/apptainer_keyserver_remove.html @@ -264,7 +264,7 @@apptainer keyserver - Manage apptainer keyservers
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_oci.html b/public/docs/user/main/cli/apptainer_oci.html index 846ee4a8..e69ec89e 100644 --- a/public/docs/user/main/cli/apptainer_oci.html +++ b/public/docs/user/main/cli/apptainer_oci.html @@ -278,7 +278,7 @@Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_oci_attach.html b/public/docs/user/main/cli/apptainer_oci_attach.html index e384e4b7..844bbab4 100644 --- a/public/docs/user/main/cli/apptainer_oci_attach.html +++ b/public/docs/user/main/cli/apptainer_oci_attach.html @@ -263,7 +263,7 @@apptainer oci - Manage OCI containers
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_oci_create.html b/public/docs/user/main/cli/apptainer_oci_create.html index ef5fd83d..bb118ab3 100644 --- a/public/docs/user/main/cli/apptainer_oci_create.html +++ b/public/docs/user/main/cli/apptainer_oci_create.html @@ -269,7 +269,7 @@apptainer oci - Manage OCI containers
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_oci_delete.html b/public/docs/user/main/cli/apptainer_oci_delete.html index 5ee6c554..0613f2a2 100644 --- a/public/docs/user/main/cli/apptainer_oci_delete.html +++ b/public/docs/user/main/cli/apptainer_oci_delete.html @@ -263,7 +263,7 @@apptainer oci - Manage OCI containers
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_oci_exec.html b/public/docs/user/main/cli/apptainer_oci_exec.html index 7146aed1..6bd93ec8 100644 --- a/public/docs/user/main/cli/apptainer_oci_exec.html +++ b/public/docs/user/main/cli/apptainer_oci_exec.html @@ -263,7 +263,7 @@apptainer oci - Manage OCI containers
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_oci_kill.html b/public/docs/user/main/cli/apptainer_oci_kill.html index 61ce8716..23097044 100644 --- a/public/docs/user/main/cli/apptainer_oci_kill.html +++ b/public/docs/user/main/cli/apptainer_oci_kill.html @@ -267,7 +267,7 @@apptainer oci - Manage OCI containers
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_oci_mount.html b/public/docs/user/main/cli/apptainer_oci_mount.html index 05dfaeae..79fec1da 100644 --- a/public/docs/user/main/cli/apptainer_oci_mount.html +++ b/public/docs/user/main/cli/apptainer_oci_mount.html @@ -262,7 +262,7 @@apptainer oci - Manage OCI containers
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_oci_pause.html b/public/docs/user/main/cli/apptainer_oci_pause.html index 65d94ee1..8bb1d554 100644 --- a/public/docs/user/main/cli/apptainer_oci_pause.html +++ b/public/docs/user/main/cli/apptainer_oci_pause.html @@ -262,7 +262,7 @@apptainer oci - Manage OCI containers
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_oci_resume.html b/public/docs/user/main/cli/apptainer_oci_resume.html index 95b787f1..0671a84c 100644 --- a/public/docs/user/main/cli/apptainer_oci_resume.html +++ b/public/docs/user/main/cli/apptainer_oci_resume.html @@ -263,7 +263,7 @@apptainer oci - Manage OCI containers
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_oci_run.html b/public/docs/user/main/cli/apptainer_oci_run.html index 18866d6a..1ef0cad0 100644 --- a/public/docs/user/main/cli/apptainer_oci_run.html +++ b/public/docs/user/main/cli/apptainer_oci_run.html @@ -274,7 +274,7 @@apptainer oci - Manage OCI containers
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_oci_start.html b/public/docs/user/main/cli/apptainer_oci_start.html index e147d732..166a7a2e 100644 --- a/public/docs/user/main/cli/apptainer_oci_start.html +++ b/public/docs/user/main/cli/apptainer_oci_start.html @@ -263,7 +263,7 @@apptainer oci - Manage OCI containers
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_oci_state.html b/public/docs/user/main/cli/apptainer_oci_state.html index 5e0639e1..16f64afa 100644 --- a/public/docs/user/main/cli/apptainer_oci_state.html +++ b/public/docs/user/main/cli/apptainer_oci_state.html @@ -264,7 +264,7 @@apptainer oci - Manage OCI containers
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_oci_umount.html b/public/docs/user/main/cli/apptainer_oci_umount.html index 108d1610..16beb44c 100644 --- a/public/docs/user/main/cli/apptainer_oci_umount.html +++ b/public/docs/user/main/cli/apptainer_oci_umount.html @@ -263,7 +263,7 @@apptainer oci - Manage OCI containers
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_oci_update.html b/public/docs/user/main/cli/apptainer_oci_update.html index 6c39ce8e..30e151c0 100644 --- a/public/docs/user/main/cli/apptainer_oci_update.html +++ b/public/docs/user/main/cli/apptainer_oci_update.html @@ -268,7 +268,7 @@apptainer oci - Manage OCI containers
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_overlay.html b/public/docs/user/main/cli/apptainer_overlay.html index 4e9d5c26..cfe56b89 100644 --- a/public/docs/user/main/cli/apptainer_overlay.html +++ b/public/docs/user/main/cli/apptainer_overlay.html @@ -268,7 +268,7 @@Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_overlay_create.html b/public/docs/user/main/cli/apptainer_overlay_create.html index c059fc27..9df74711 100644 --- a/public/docs/user/main/cli/apptainer_overlay_create.html +++ b/public/docs/user/main/cli/apptainer_overlay_create.html @@ -277,7 +277,7 @@apptainer overlay - Manage an EXT3 writable overlay image
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_plugin.html b/public/docs/user/main/cli/apptainer_plugin.html index cdcb86bc..4d3cb906 100644 --- a/public/docs/user/main/cli/apptainer_plugin.html +++ b/public/docs/user/main/cli/apptainer_plugin.html @@ -276,7 +276,7 @@Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_plugin_compile.html b/public/docs/user/main/cli/apptainer_plugin_compile.html index 1118a0ed..2ea11065 100644 --- a/public/docs/user/main/cli/apptainer_plugin_compile.html +++ b/public/docs/user/main/cli/apptainer_plugin_compile.html @@ -265,7 +265,7 @@apptainer plugin - Manage Apptainer plugins
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_plugin_create.html b/public/docs/user/main/cli/apptainer_plugin_create.html index 7985bb00..1a3554b6 100644 --- a/public/docs/user/main/cli/apptainer_plugin_create.html +++ b/public/docs/user/main/cli/apptainer_plugin_create.html @@ -267,7 +267,7 @@apptainer plugin - Manage Apptainer plugins
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_plugin_disable.html b/public/docs/user/main/cli/apptainer_plugin_disable.html index 2143118b..65876ea6 100644 --- a/public/docs/user/main/cli/apptainer_plugin_disable.html +++ b/public/docs/user/main/cli/apptainer_plugin_disable.html @@ -263,7 +263,7 @@apptainer plugin - Manage Apptainer plugins
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_plugin_enable.html b/public/docs/user/main/cli/apptainer_plugin_enable.html index 2e013e0c..9b06282d 100644 --- a/public/docs/user/main/cli/apptainer_plugin_enable.html +++ b/public/docs/user/main/cli/apptainer_plugin_enable.html @@ -263,7 +263,7 @@apptainer plugin - Manage Apptainer plugins
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_plugin_inspect.html b/public/docs/user/main/cli/apptainer_plugin_inspect.html index 25f5c1e7..25eb2321 100644 --- a/public/docs/user/main/cli/apptainer_plugin_inspect.html +++ b/public/docs/user/main/cli/apptainer_plugin_inspect.html @@ -267,7 +267,7 @@apptainer plugin - Manage Apptainer plugins
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_plugin_install.html b/public/docs/user/main/cli/apptainer_plugin_install.html index 600cff2c..f5570f0b 100644 --- a/public/docs/user/main/cli/apptainer_plugin_install.html +++ b/public/docs/user/main/cli/apptainer_plugin_install.html @@ -263,7 +263,7 @@apptainer plugin - Manage Apptainer plugins
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_plugin_list.html b/public/docs/user/main/cli/apptainer_plugin_list.html index 6c456303..da87f66a 100644 --- a/public/docs/user/main/cli/apptainer_plugin_list.html +++ b/public/docs/user/main/cli/apptainer_plugin_list.html @@ -264,7 +264,7 @@apptainer plugin - Manage Apptainer plugins
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_plugin_uninstall.html b/public/docs/user/main/cli/apptainer_plugin_uninstall.html index da35b892..2624f239 100644 --- a/public/docs/user/main/cli/apptainer_plugin_uninstall.html +++ b/public/docs/user/main/cli/apptainer_plugin_uninstall.html @@ -262,7 +262,7 @@apptainer plugin - Manage Apptainer plugins
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_pull.html b/public/docs/user/main/cli/apptainer_pull.html index a6fb4829..18c3525f 100644 --- a/public/docs/user/main/cli/apptainer_pull.html +++ b/public/docs/user/main/cli/apptainer_pull.html @@ -298,7 +298,7 @@Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_registry_list.html b/public/docs/user/main/cli/apptainer_registry_list.html index 742f9bdc..188f6204 100644 --- a/public/docs/user/main/cli/apptainer_registry_list.html +++ b/public/docs/user/main/cli/apptainer_registry_list.html @@ -263,7 +263,7 @@apptainer registry - Manage authentication to OCI/Docker registries
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_registry_login.html b/public/docs/user/main/cli/apptainer_registry_login.html index 92aaa115..68e0c3a0 100644 --- a/public/docs/user/main/cli/apptainer_registry_login.html +++ b/public/docs/user/main/cli/apptainer_registry_login.html @@ -275,7 +275,7 @@apptainer registry - Manage authentication to OCI/Docker registries
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_registry_logout.html b/public/docs/user/main/cli/apptainer_registry_logout.html index fa146701..b5109e0c 100644 --- a/public/docs/user/main/cli/apptainer_registry_logout.html +++ b/public/docs/user/main/cli/apptainer_registry_logout.html @@ -264,7 +264,7 @@apptainer registry - Manage authentication to OCI/Docker registries
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_remote.html b/public/docs/user/main/cli/apptainer_remote.html index ed80a023..dcc588d5 100644 --- a/public/docs/user/main/cli/apptainer_remote.html +++ b/public/docs/user/main/cli/apptainer_remote.html @@ -285,7 +285,7 @@Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_remote_add.html b/public/docs/user/main/cli/apptainer_remote_add.html index b6e1bc3a..2e15f9d1 100644 --- a/public/docs/user/main/cli/apptainer_remote_add.html +++ b/public/docs/user/main/cli/apptainer_remote_add.html @@ -269,7 +269,7 @@apptainer remote - Manage apptainer remote endpoints
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_remote_get-login-password.html b/public/docs/user/main/cli/apptainer_remote_get-login-password.html index c03484bb..fab0402e 100644 --- a/public/docs/user/main/cli/apptainer_remote_get-login-password.html +++ b/public/docs/user/main/cli/apptainer_remote_get-login-password.html @@ -260,7 +260,7 @@apptainer remote - Manage apptainer remote endpoints
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_remote_list.html b/public/docs/user/main/cli/apptainer_remote_list.html index 91e8f251..c4deb28a 100644 --- a/public/docs/user/main/cli/apptainer_remote_list.html +++ b/public/docs/user/main/cli/apptainer_remote_list.html @@ -264,7 +264,7 @@apptainer remote - Manage apptainer remote endpoints
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_remote_login.html b/public/docs/user/main/cli/apptainer_remote_login.html index 27f97da6..b09484a2 100644 --- a/public/docs/user/main/cli/apptainer_remote_login.html +++ b/public/docs/user/main/cli/apptainer_remote_login.html @@ -271,7 +271,7 @@apptainer remote - Manage apptainer remote endpoints
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_remote_logout.html b/public/docs/user/main/cli/apptainer_remote_logout.html index e0390848..3e58a662 100644 --- a/public/docs/user/main/cli/apptainer_remote_logout.html +++ b/public/docs/user/main/cli/apptainer_remote_logout.html @@ -265,7 +265,7 @@apptainer remote - Manage apptainer remote endpoints
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_remote_remove.html b/public/docs/user/main/cli/apptainer_remote_remove.html index 26c5c3c0..2fe2beb1 100644 --- a/public/docs/user/main/cli/apptainer_remote_remove.html +++ b/public/docs/user/main/cli/apptainer_remote_remove.html @@ -264,7 +264,7 @@apptainer remote - Manage apptainer remote endpoints
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_remote_status.html b/public/docs/user/main/cli/apptainer_remote_status.html index 6e366886..172f7aa3 100644 --- a/public/docs/user/main/cli/apptainer_remote_status.html +++ b/public/docs/user/main/cli/apptainer_remote_status.html @@ -267,7 +267,7 @@apptainer remote - Manage apptainer remote endpoints
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_remote_use.html b/public/docs/user/main/cli/apptainer_remote_use.html index 803d4b44..0002c27c 100644 --- a/public/docs/user/main/cli/apptainer_remote_use.html +++ b/public/docs/user/main/cli/apptainer_remote_use.html @@ -265,7 +265,7 @@apptainer remote - Manage apptainer remote endpoints
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_run-help.html b/public/docs/user/main/cli/apptainer_run-help.html index c39924c5..614a52aa 100644 --- a/public/docs/user/main/cli/apptainer_run-help.html +++ b/public/docs/user/main/cli/apptainer_run-help.html @@ -288,7 +288,7 @@Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_sif_add.html b/public/docs/user/main/cli/apptainer_sif_add.html index 415510fa..b0f88f4c 100644 --- a/public/docs/user/main/cli/apptainer_sif_add.html +++ b/public/docs/user/main/cli/apptainer_sif_add.html @@ -297,7 +297,7 @@apptainer sif - Manipulate Singularity Image Format (SIF) images
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_sif_del.html b/public/docs/user/main/cli/apptainer_sif_del.html index 17e11625..0c7339d0 100644 --- a/public/docs/user/main/cli/apptainer_sif_del.html +++ b/public/docs/user/main/cli/apptainer_sif_del.html @@ -260,7 +260,7 @@apptainer sif - Manipulate Singularity Image Format (SIF) images
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_sif_dump.html b/public/docs/user/main/cli/apptainer_sif_dump.html index 5174d44a..c371d1e8 100644 --- a/public/docs/user/main/cli/apptainer_sif_dump.html +++ b/public/docs/user/main/cli/apptainer_sif_dump.html @@ -260,7 +260,7 @@apptainer sif - Manipulate Singularity Image Format (SIF) images
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_sif_header.html b/public/docs/user/main/cli/apptainer_sif_header.html index e4b318c3..4141022e 100644 --- a/public/docs/user/main/cli/apptainer_sif_header.html +++ b/public/docs/user/main/cli/apptainer_sif_header.html @@ -260,7 +260,7 @@apptainer sif - Manipulate Singularity Image Format (SIF) images
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_sif_info.html b/public/docs/user/main/cli/apptainer_sif_info.html index a1f9de2c..862b60f6 100644 --- a/public/docs/user/main/cli/apptainer_sif_info.html +++ b/public/docs/user/main/cli/apptainer_sif_info.html @@ -260,7 +260,7 @@apptainer sif - Manipulate Singularity Image Format (SIF) images
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_sif_list.html b/public/docs/user/main/cli/apptainer_sif_list.html index 0d3825fd..f5b33a15 100644 --- a/public/docs/user/main/cli/apptainer_sif_list.html +++ b/public/docs/user/main/cli/apptainer_sif_list.html @@ -260,7 +260,7 @@apptainer sif - Manipulate Singularity Image Format (SIF) images
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_sif_new.html b/public/docs/user/main/cli/apptainer_sif_new.html index 62184f5d..28290d6b 100644 --- a/public/docs/user/main/cli/apptainer_sif_new.html +++ b/public/docs/user/main/cli/apptainer_sif_new.html @@ -260,7 +260,7 @@apptainer sif - Manipulate Singularity Image Format (SIF) images
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_sif_setprim.html b/public/docs/user/main/cli/apptainer_sif_setprim.html index 01ac4d2f..6a2115f1 100644 --- a/public/docs/user/main/cli/apptainer_sif_setprim.html +++ b/public/docs/user/main/cli/apptainer_sif_setprim.html @@ -260,7 +260,7 @@apptainer sif - Manipulate Singularity Image Format (SIF) images
Auto generated by spf13/cobra on 11-Mar-2024
+Auto generated by spf13/cobra on 12-Mar-2024
diff --git a/public/docs/user/main/cli/apptainer_sign.html b/public/docs/user/main/cli/apptainer_sign.html index 0e4980c5..5154385b 100644 --- a/public/docs/user/main/cli/apptainer_sign.html +++ b/public/docs/user/main/cli/apptainer_sign.html @@ -276,7 +276,7 @@--build-arg-file
they will overwrite values defined in
-this section.
-Consider the example from the definition file above:
-Bootstrap: docker
-From: ubuntu:{{ VERSION }}
-Stage: build
-
-%arguments
- VERSION=22.04
-
The value in this entry VERSION=22.04
will replace the template variable
-{{ VERSION }}
during the build process by default.
However, if a user builds the image with the command
-apptainer build --build-arg VERSION=23.04 my_container.sif my_container.def
-
then the From image tag will be overridden to 23.04
rather than 22.04
.
Apptainer definition files support templating: +definition files can include placeholders for values that will be passed at +build time, either using command-line options or by specifying a file that +contains the relevant values.
+To use templating, include a {{ placeholder }}
at the point in your
+definition file where you’d like the passed-in value to go. For example:
Bootstrap: docker
+From: ubuntu:22.04
+Stage: build
+
+%runscript
+ echo {{ some_text }}
+
When building a container from this definition file, a concrete value for
+{{ some_text }}
can be passed via the --build-arg
flag to the build
+command. This flag accepts a varname=value
pair, as shown here:
$ apptainer build --build-arg some_text="Hello world" ./my_container.sif ./my_container.def
+INFO: Starting build...
+Getting image source signatures
+Copying blob f4bb4e8dca02 skipped: already exists
+Copying config 2b7cc08dcd done |
+Writing manifest to image destination
+2024/03/08 14:17:24 info unpack layer: sha256:f4bb4e8dca02be491b4f72d2ef2127a64ce49c48d0d9c0a0fcaffa625067679d
+INFO: Adding runscript
+INFO: Creating SIF file...
+INFO: Build complete: ./my_container.sif
+
+$ apptainer run ./my_container.sif
+Hello world
+
Alternatively, the varname=value
assignments can be placed in a file, and
+the path to that file specified using the --build-arg-file
flag to the
+build
command, as shown here:
$ cat << EOF > ./my_args_file.txt
+some_text="Hello again, world"
+EOF
+
+$ apptainer build -F --build-arg-file ./my_args_file.txt ./my_container.sif ./my_container.def
+INFO: Starting build...
+Getting image source signatures
+Copying blob f4bb4e8dca02 skipped: already exists
+Copying config 2b7cc08dcd done |
+Writing manifest to image destination
+2024/03/08 14:17:24 info unpack layer: sha256:f4bb4e8dca02be491b4f72d2ef2127a64ce49c48d0d9c0a0fcaffa625067679d
+INFO: Adding runscript
+INFO: Creating SIF file...
+INFO: Build complete: ./my_container.sif
+
+$ apptainer run ./my_container.sif
+Hello again, world
+
A single definition file can use multiple different templating variables, use a +single variable more than once, and use variables in different sections of the +definition file, as shown here:
+Bootstrap: docker
+From: ubuntu:22.04
+Stage: build
+
+%setup
+ echo {{ file_contents }} > /tmp/test_file
+
+%environment
+ export CUSTOM_VAR_ONE={{ var_value1 }}
+ export CUSTOM_VAR_TWO={{ var_value2 }}
+
+%runscript
+ echo "file contents:" `cat /tmp/test_file`
+ echo "--> this should, if I'm not mistaken, equal:" {{ file_contents }}
+ echo ""
+ echo "env var: ${CUSTOM_VAR_ONE}"
+ echo "--> this should, if I'm not mistaken, equal:" {{ var_value1 }}
+ echo ""
+ echo "env var: ${CUSTOM_VAR_TWO}"
+ echo "--> this should, if I'm not mistaken, equal:" {{ var_value2 }}
+ echo ""
+ echo "and finally, here's some text:" {{ some_text}}
+
To use this definition file, one can pass values for all the different variables
+using --build-arg
flags:
$ apptainer build -F --build-arg file_contents="'I am in a file'" --build-arg var_value1="'I am in an env var'" --build-arg var_value2="'I am also in an env var'" --build-arg some_text="'I am just some text'" ./my_container.sif ./my_container.def
+INFO: Starting build...
+Getting image source signatures
+Copying blob f4bb4e8dca02 skipped: already exists
+Copying config 2b7cc08dcd done |
+Writing manifest to image destination
+2024/03/08 14:42:15 info unpack layer: sha256:f4bb4e8dca02be491b4f72d2ef2127a64ce49c48d0d9c0a0fcaffa625067679d
+INFO: Running setup scriptlet
++ echo I am in a file
+INFO: Adding environment to container
+INFO: Adding runscript
+INFO: Creating SIF file...
+INFO: Build complete: ./my_container.sif
+
+$ apptainer run ./my_container.sif
+file contents: I am in a file
+--> this should, if I'm not mistaken, equal: I am in a file
+
+env var: I am in an env var
+--> this should, if I'm not mistaken, equal: I am in an env var
+
+env var: I am also in an env var
+--> this should, if I'm not mistaken, equal: I am also in an env var
+
+and finally, here's some text: I am just some text
+
Or one can place the values for the different values in a file, and pass the
+path to that file using the --build-arg-file
flag:
$ cat << EOF > ./my_args_file.txt
+file_contents="I am in a file"
+var_value1="I am in an env var"
+var_value2="I am also in an env var"
+some_text="I am just some text"
+EOF
+
+$ apptainer build -F --build-arg-file ./my_args_file.txt ./my_container.sif ./my_container.def
+INFO: Starting build...
+Getting image source signatures
+Copying blob f4bb4e8dca02 skipped: already exists
+Copying config 2b7cc08dcd done |
+Writing manifest to image destination
+2024/03/08 14:42:15 info unpack layer: sha256:f4bb4e8dca02be491b4f72d2ef2127a64ce49c48d0d9c0a0fcaffa625067679d
+INFO: Running setup scriptlet
++ echo I am in a file
+INFO: Adding environment to container
+INFO: Adding runscript
+INFO: Creating SIF file...
+INFO: Build complete: ./my_container.sif
+
+$ apptainer run ./my_container.sif
+file contents: I am in a file
+--> this should, if I'm not mistaken, equal: I am in a file
+
+env var: I am in an env var
+--> this should, if I'm not mistaken, equal: I am in an env var
+
+env var: I am also in an env var
+--> this should, if I'm not mistaken, equal: I am also in an env var
+
+and finally, here's some text: I am just some text
+
Or one can use a combination of both strategies:
+$ cat << EOF > ./my_args_file.txt
+var_value1="I am in an env var"
+some_text="I am just some text"
+EOF
+
+$ apptainer build -F --build-arg file_contents="'I am in a file'" --build-arg var_value2="'I am also in an env var'" --build-arg-file ./my_args_file.txt ./my_container.sif ./my_container.def
+INFO: Starting build...
+Getting image source signatures
+Copying blob f4bb4e8dca02 skipped: already exists
+Copying config 2b7cc08dcd done |
+Writing manifest to image destination
+2024/03/08 14:42:15 info unpack layer: sha256:f4bb4e8dca02be491b4f72d2ef2127a64ce49c48d0d9c0a0fcaffa625067679d
+INFO: Running setup scriptlet
++ echo I am in a file
+INFO: Adding environment to container
+INFO: Adding runscript
+INFO: Creating SIF file...
+INFO: Build complete: ./my_container.sif
+
+$ apptainer run ./my_container.sif
+file contents: I am in a file
+--> this should, if I'm not mistaken, equal: I am in a file
+
+env var: I am in an env var
+--> this should, if I'm not mistaken, equal: I am in an env var
+
+env var: I am also in an env var
+--> this should, if I'm not mistaken, equal: I am also in an env var
+
+and finally, here's some text: I am just some text
+
In the event that an argument is passed via --build-arg
more than once, the
+last occurrence will take precedence:
$ apptainer build -F --build-arg file_contents="'I am in a file (1st time)'" --build-arg var_value2="'I am also in an env var'" --build-arg file_contents="'I am in a file (2nd time)'" --build-arg-file ./my_args_file.txt ./my_container.sif ./my_container.def
+INFO: Starting build...
+Getting image source signatures
+Copying blob f4bb4e8dca02 skipped: already exists
+Copying config 2b7cc08dcd done |
+Writing manifest to image destination
+2024/03/08 14:42:15 info unpack layer: sha256:f4bb4e8dca02be491b4f72d2ef2127a64ce49c48d0d9c0a0fcaffa625067679d
+INFO: Running setup scriptlet
++ echo 'I am in a file (2nd time)'
+INFO: Adding environment to container
+INFO: Adding runscript
+INFO: Creating SIF file...
+INFO: Build complete: ./my_container.sif
+
+$ apptainer run ./my_container.sif
+file contents: I am in a file (2nd time)
+--> this should, if I'm not mistaken, equal: I am in a file (2nd time)
+
+env var: I am in an env var
+--> this should, if I'm not mistaken, equal: I am in an env var
+
+env var: I am also in an env var
+--> this should, if I'm not mistaken, equal: I am also in an env var
+
+and finally, here's some text: I am just some text
+
In the event that a variable is defined both in the file passed to
+--build-arg-file
and via the command line using --build-arg
flag, the value passed via the
+command line will take precedence:
$ cat << EOF > ./my_args_file.txt
+var_value1="I am in an env var"
+var_value2="I am also in an env var (from build arg file)"
+some_text="I am just some text"
+EOF
+
+$ apptainer build -F --build-arg file_contents="'I am in a file'" --build-arg var_value2="'I am also in an env var (from command line)'" --build-arg-file ./my_args_file.txt ./my_container.sif ./my_container.def
+INFO: Starting build...
+Getting image source signatures
+Copying blob f4bb4e8dca02 skipped: already exists
+Copying config 2b7cc08dcd done |
+Writing manifest to image destination
+2024/03/08 14:42:15 info unpack layer: sha256:f4bb4e8dca02be491b4f72d2ef2127a64ce49c48d0d9c0a0fcaffa625067679d
+INFO: Running setup scriptlet
++ echo 'I am in a file'
+INFO: Adding environment to container
+INFO: Adding runscript
+INFO: Creating SIF file...
+INFO: Build complete: ./my_container.sif
+
+$ apptainer run ./my_container.sif
+file contents: I am in a file
+--> this should, if I'm not mistaken, equal: I am in a file
+
+env var: I am in an env var
+--> this should, if I'm not mistaken, equal: I am in an env var
+
+env var: I am also in an env var (from command line)
+--> this should, if I'm not mistaken, equal: I am also in an env var (from command line)
+
+and finally, here's some text: I am just some text
+
If a definition file contains a variable placeholder and no value for that
+variable is provided (via either --build-arg
or --build-arg-file
),
+Apptainer will generate an error:
Bootstrap: docker
+From: ubuntu:22.04
+Stage: build
+
+%runscript
+ echo "Here is some text:" {{ some_text }}
+ echo "And here is some more text:" {{ some_more_text }}
+
$ apptainer build -F --build-arg some_more_text="more more more" ./my_container.sif ./my_container.def
+FATAL: Unable to build from ./my_container.def: build var some_text is not defined through either --build-arg (--build-arg-file) or 'arguments' section
+
However, definition files can provide default values for some or all variables
+using the %arguments
section, as shown here:
Bootstrap: docker
+From: ubuntu:22.04
+Stage: build
+
+%runscript
+ echo "Here is some text:" {{ some_text }}
+ echo "And here is some more text:" {{ some_more_text }}
+
+%arguments
+ some_text="Some default text"
+ some_more_text="Some more default text"
+
$ apptainer build -F --build-arg some_more_text="more more more" ./my_container.sif ./my_container.def
+INFO: Starting build...
+Getting image source signatures
+Copying blob f4bb4e8dca02 skipped: already exists
+Copying config 2b7cc08dcd done |
+Writing manifest to image destination
+2024/03/08 14:52:53 info unpack layer: sha256:f4bb4e8dca02be491b4f72d2ef2127a64ce49c48d0d9c0a0fcaffa625067679d
+INFO: Adding runscript
+INFO: Creating SIF file...
+INFO: Build complete: ./my_container.sif
+
+$ apptainer run ./my_container.sif
+Here is some text: Some default text
+And here is some more text: more more more
+
Note that in the event of a variable having both a default value and a value
+explicitly set via --build-arg
or --build-arg-file
, the explicitly-set
+value will take precedence (as the example above shows).