folkslinux
/
CBL-Mariner
mirror of https://github.com/microsoft/CBL-Mariner.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #78 from microsoft/jslobodzian/update-image-build-instructions 

Update building.md
This commit is contained in:
jslobodzian 2020-08-25 14:35:33 -07:00 committed by GitHub
parent d74dad026e 645c0acb3c
commit b8c1e961a1
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 23 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
toolkit/docs/building/building.md
View File

@ -7,6 +7,8 @@ Building
- [Build Packages](#build-packages)
- [Build Images](#build-images)
- [Build ISOs](#build-isos)
- [Further Reading](#further-reading)
- [ISOs](#isos)
- [Packages](#packages)
- [Working on Packages](#working-on-packages)
- [Force Rebuilds](#force-rebuilds)
@ -86,29 +88,34 @@ Once the toolchain is built, all packages can be built with the toolchain. Larg
# Still from the toolkit folder, copy the toolchain archive built in the previous step into the toolkit folder
mv ../build/toolchain/toolchain_built_rpms_all.tar.gz .
# Build ALL packages
sudo make build-packages -j$(nproc) CONFIG_FILE= TOOLCHAIN_ARCHIVE=toolchain_built_rpms_all.tar.gz DOWNLOAD_SRPMS=y REBUILD_TOOLS=y REBUILD_TOOLCHAIN=n REBUILD_PACKAGES=y PACKAGE_IGNORE_LIST="openjdk8"
# Build ALL packages FOR AMD64
sudo make build-packages -j$(nproc) CONFIG_FILE= TOOLCHAIN_ARCHIVE=toolchain_built_rpms_all.tar.gz DOWNLOAD_SRPMS=y REBUILD_TOOLS=y REBUILD_TOOLCHAIN=n REBUILD_PACKAGES=y PACKAGE_IGNORE_LIST="openjdk8 openjdk8_aarch64 shim-unsigned-aarch64"
# Build ALL packages FOR ARM64
sudo make build-packages -j$(nproc) CONFIG_FILE= TOOLCHAIN_ARCHIVE=toolchain_built_rpms_all.tar.gz DOWNLOAD_SRPMS=y REBUILD_TOOLS=y REBUILD_TOOLCHAIN=n REBUILD_PACKAGES=y PACKAGE_IGNORE_LIST="openjdk8 openjdk8_aarch64 shim-unsigned-amd64"
```
## Build Images
Build the default image (`core-efi.json`) and create the `vhdx` specified in the config file while using prebuilt components where possible (i.e. download from Microsoft servers):
Different images can be produced from the build system. All images are generated in the out/images folder.
```bash
# Still from the toolkit folder
# Build out/images/core-efi/core-efi.vhdx image from remote components
sudo make image
```
Large parts of the build are parallelized. Enable this by setting the `-j` flag for `make` to the number of parallel jobs to allow:
```bash
# Run the build in parallel using one thread per CPU core.
sudo make image -j$(nproc)
```
Build a different image using prebuilt components:
```bash
# Build out/images/config/config.* image from remote components
sudo make image CONFIG_FILE="/path/to/my/config.json" -j$(nproc)
# To build a Mariner VHD Image (VHD folder: ../out/images/core-legacy)
sudo make image CONFIG_FILE=./imageconfigs/core-legacy.json TOOLCHAIN_ARCHIVE=toolchain_built_rpms_all.tar.gz REBUILD_TOOLCHAIN=n REBUILD_PACKAGES=n REBUILD_TOOLS=y REPO_LIST=
# To build a Mariner VHDX Image (VHDX folder ../out/images/core-efi)
sudo make image CONFIG_FILE=./imageconfigs/core-legacy.json TOOLCHAIN_ARCHIVE=toolchain_built_rpms_all.tar.gz REBUILD_TOOLCHAIN=n REBUILD_PACKAGES=n REBUILD_TOOLS=y REPO_LIST=
# To build a Mariner ISO Image (ISO folder: ../out/images/full)
sudo make iso CONFIG_FILE=./imageconfigs/full.json TOOLCHAIN_ARCHIVE=toolchain_built_rpms_all.tar.gz REBUILD_TOOLCHAIN=n REBUILD_PACKAGES=n REBUILD_TOOLS=y REPO_LIST=
# To build a Mariner Contianer Image (Container Folder: ../out/images/core-container/*.tar.gz
sudo make image CONFIG_FILE=./imageconfigs/core-container.json TOOLCHAIN_ARCHIVE=./toolchain_built_rpms_all.tar.gz REBUILD_TOOLCHAIN=n REBUILD_PACKAGES=n REBUILD_TOOLS=y REPO_LIST=
```
# Further Reading
## ISOs
ISO installers can be built with:
```bash