apptainer-test 命令

常用示例

说明

apptainer test executes the test script defined in a container's %test section. This provides a standardized way for container authors to include validation checks that verify the container is functioning correctly. Test scripts typically check that required software is installed, libraries are accessible, and the container can perform its intended function. The exit code of the test script determines pass (0) or fail (non-zero) status. For containers using the Scientific Filesystem (SCIF), the --app flag runs the test section of a specific application within the container. This allows multi-app containers to have independent test suites. Container authors define tests during build time. If no %test section exists, the command completes successfully without executing anything. This command is useful in CI/CD pipelines to validate container builds before deployment.

参数

--app _name_

Run the test section of a specific SCIF app.

--bind, -B _src:dest[:opts]_

Bind mount a host path into the container.

--nv

Enable NVIDIA GPU support.

--rocm

Enable AMD ROCm GPU support.

--contain, -c

Use minimal /dev and empty other directories.

--containall, -C

Full containment mode.

--cleanenv, -e

Clean environment before testing.

--fakeroot

Run test with fake root privileges.

--cwd, --pwd _path_

Set working directory inside container.

--writable, -w

Make file system accessible as read-write.

--writable-tmpfs

Make file system read-write with non-persistent data (tmpfs overlay).

--help, -h

Display help for the test command.