Build Configuration
- The BCLD build process has many default variables and safeties.
- BCLD will mostly build an image without issue.
- Many build parameters have been implemented to further customize the builds.
- Below is a list of available customizations for building a BCLD-IMG.
- All
Defaulttype variables can be configured in the build configuration.
| CONFIG | SETTING EXAMPLE | DESCRIPTION | TYPE |
|---|---|---|---|
| BUILD ENVs | |||
APT_CLEANUP |
true/false | Option to clean chroot after installation. | Optional |
BCLD_APP |
/opt/deb-app-afname | Full path of the application to launch within BCLD. Overrides DEFAULT_APP. |
Optional |
BCLD_ARCH |
amd64 | Architecture of the distribution used. | Default |
BCLD_CODE_NAME |
Omniscius | Codename for the BCLD release. | Default |
BCLD_DATE |
14-dec-2022 | Date prefix for file name. | Default |
BCLD_HOME |
/root | Path to ${HOME} within chroot. | Default |
BCLD_MD5 |
./test/bcld.md5 | Location of BCLD MD5 within repository. | Default |
BCLD_MODEL |
release, debug, test | Option for switching between modes. | MANDATORY |
BCLD_PATCH |
1 | BCLD patch number. | Default |
BCLD_PKG_EXTRA |
r8168-dkms | Extra packages to install. | Optional |
BCLD_RELEASE |
11.X | BCLD release number. | Default |
BCLD_REPO_BRANCH |
main | Dummy repo name. | Default |
BCLD_SECRET |
************ | SSH password for TEST. | Optional |
BCLD_TAG_EXTRA |
r8168 | Adds postfix to BCLD_VERSION. |
Optional |
BCLD_TERM |
xterm-256color | BCLD terminal settings. | Default |
CODE_NAME |
focal, bionic | Ubuntu Release Code Name | Default |
DEBIAN_FRONTEND |
noninteractive | Use autonomous installers. | Default |
DEBIAN_PRIORITY |
critical | Critical packages can be installed without interaction. | Default |
DEFAULT_APP |
(/usr/bin/qutebrowser &) && /usr/bin/qutebrowser :tab-close | Default command to open within BCLD. | Default |
FAT_LABEL |
BCLD-USB | BCLD disk label. | Default |
HOME |
/root | Path to ${HOME} on build machine. | Default |
KEEP_BOOTSTRAP |
true, false | The build either keeps the bootstrap, or deletes it before the next build | Optional |
KERNEL_MINOR |
5.15 | Minor kernel release. | Default |
KERNEL_MODEL |
generic | Kernel model name. | Default |
KERNEL_PATCH |
0-40 | Kernel patch and release. | Default |
LC_ALL |
C | Universal language settings for the console. | Default |
TEMP, TMP, TMPDIR
|
/tmp | Temporary folder | Default |
UBUNTU_RELEASE |
22.04 | Ubuntu release. | Default |
UBUNTU_REPO |
http://archive.ubuntu.com/ubuntu/ | Official Ubuntu repository. | Default |
UBUNTU_URL |
http://cdimage.ubuntu.com/ubuntu-base/releases/20.04/release/ubuntu-base-20.04.1-base-amd64.tar.gz | Ubuntu Base image URL. | Default |
WEB_DIR |
/var/www/html | Web directory for RepoMan. | Default |
BCLD_USER |
omniscius-release | Username within BCLD. Consists of combination of BCLD_CODE_NAME and BCLD_MODEL. |
Default |
KERNEL_SHORT |
5.15-0-40 | Short kernel name. Combination of KERNEL_MINOR and KERNEL_PATCH. |
Default |
KERNEL_VERSION |
5.15-0-40-generic | Long kernel name. Combination of KERNEL_SHORT and KERNEL_MODEL. |
Default |
BCLD_VERSION_FILE |
14-dec-2022_BCLD-Omniscius-3_TEST.img_BCLD_TAG_EXTRA
|
Full VERSION string for file names. | Default |
BCLD_VERSION_STRING |
12.10-3 BCLD Test (Omniscius) | Concatenated VERSION string for human reading. | Default |
-
Configuration
2.1 Build Configuration
2.2 Build Flow
2.3 Client Configuration -
Collaboration
6.1 Community Guidelines
6.2 Workflow
6.3 Definitions
6.4 About Us