datalad deb-bootstrap-builder

Synopsis

datalad deb-bootstrap-builder [-h] [-d DATASET] [--version]

Description

Bootstrap a build environment

This command bootstraps a (containerized) build environment (such as a Singularity container) based on an existing builder configuration (such as a Singularity recipe).

The execution of this command might require administrative privileges and could prompt for a sudo password, for example to build a Singularity image. The resulting bootstrapped build environment will be placed inside of a 'envs/' subdirectory of a 'builder/' dataset.

The following directory tree illustrates this. The configured builder takes the form of a Singularity recipe here.

bullseye <- distribution dataset
├── builder <- builder subdataset
│ ├── envs
│ │   ├── README.md
│ │ └── singularity-amd64.sif <- bootstrapped build environment
│ └── recipes
│ ├── README.md
│ └── singularity-any <- builder configuration

Examples

Bootstrap a configured build environment in a builder subdataset, from a distribution dataset:

% datalad deb-bootstrap-builder -d builder

Options

-h, --help, --help-np

show this help message. --help-np forcefully disables the use of a pager for displaying the help message

-d DATASET, --dataset DATASET

specify a builder dataset that contains a build environment configuration. Constraints: Value must be a Dataset or a valid identifier of a Dataset (e.g. a path) or value must be NONE

--version

show the module and its version which provides the command

Authors

datalad is developed by The DataLad Team and Contributors <team@datalad.org>.