summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorQuentin Schulz <quentin.schulz@theobroma-systems.com>2023-10-12 17:16:03 +0200
committerQuentin Schulz <quentin.schulz@theobroma-systems.com>2023-11-16 09:43:52 +0000
commit01d7cc373a611a82ad97d5dfa01429e1cac4f83b (patch)
tree4dda8484327e3f78c5d001ca37b2d007760686f6
parentc86a865eb829403da467b0673435f2374b01968d (diff)
README: simplify build instructions
The podman line is quite difficult to read and to maintain. Moreover, it was using SELinux relabeling incorrectly according to podman's docs[1]: """ Note: Do not relabel system files and directories. For these types of containers we recommend disabling SELinux separation. The option --security-opt label=disable disables SELinux separation for the container. """ Also, not everybody is using podman, some people are using docker. Finally, kas package provides a shell script that prepares the whole container startup command line by itself, called kas-container. So let's use that one instead. [1] https://docs.podman.io/en/latest/markdown/podman-run.1.html#volume-v-source-volume-host-dir-container-dir-options Reported-by: Jakob Unterwurzacher <jakob.unterwurzacher@theobroma-systems.com> Signed-off-by: Quentin Schulz <quentin.schulz@theobroma-systems.com>
-rw-r--r--README14
1 files changed, 11 insertions, 3 deletions
diff --git a/README b/README
index acee087..345bf0d 100644
--- a/README
+++ b/README
@@ -46,12 +46,20 @@ kas-theobroma.yml is a configuration file to be used by kas
(https://github.com/siemens/kas) which sets up everything one needs to build the
minimal BSP image that can run on the supported boards listed above.
-One builds the image by running the following commands:
+It is recommended to install the kas package through the distro manager:
-$ podman run -it --rm --userns=keep-id -e USER_ID=$UID -e GROUP_ID=$GID -w $PWD/.. -v $PWD/..:$PWD/..:rw,Z --tmpfs /tmp ghcr.io/siemens/kas/kas:4.0 build meta-theobroma-systems-bsp/kas-theobroma.yml
+ apt-get install -y kas
+
+or via pip:
+
+ python3 -m pip install kas
+
+The image can then be built with:
+
+ KAS_IMAGE_VERSION="4.0" kas-container build kas-theobroma.yml
Once the build has finished, the artifacts will be available in
-../build/tmp/deploy/images/puma-haikou/ directory.
+build/tmp/deploy/images/puma-haikou/ directory.
One can directly flash the .wic image on an SD card with the following command: