Skip to content

Commit e42a64a

Browse files
committed
docs: Update devguide to latest changes on container images
Document the new build process and the reproducibility check. Signed-off-by: Jan Kiszka <[email protected]>
1 parent c4e4bf3 commit e42a64a

File tree

1 file changed

+15
-11
lines changed

1 file changed

+15
-11
lines changed

docs/devguide.rst

+15-11
Original file line numberDiff line numberDiff line change
@@ -13,23 +13,27 @@ That will install a backlink ~/.local/bin/kas to this project. Now you are
1313
able to call it from anywhere.
1414

1515

16-
Docker image build
17-
------------------
18-
19-
For the Yocto/OE build image, just run::
16+
Container image build
17+
---------------------
2018

21-
$ docker build -t <kas_image_name> .
19+
To build the container images kas provides, there is a script provided for
20+
your convenience. It uses docker buildx and requires BuildKit 0.13.0 or newer.
21+
To start the build both container variants, invoke::
2222

23-
For the Yocto/OE build image, use::
23+
$ scripts/build-container.sh
2424

25-
$ docker build --target kas-isar -t <kas-isar_image_name> .
25+
You can limit the target type to either Yocto/OE (``kas``) or isar
26+
(``kas-isar``) via the ``--target`` options. See the script help for more
27+
options.
2628

27-
When you need a proxy to access the internet, add::
29+
Since release 4.3, the containers officially provided via ghcr.io are fully
30+
reproducible. To test this, you can use the following script, e.g. to validate
31+
that release::
2832

29-
--build-arg http_proxy=<http_proxy> --build-arg https_proxy=<https_proxy>
30-
--build-arg ftp_proxy=<ftp_proxy> --build-arg no_proxy=<no_proxy>
33+
$ scripts/reproduce-container.sh kas:4.3
3134

32-
to the call.
35+
Both scripts also support building/checking of the arm64 container images. See
36+
the help of both scripts for more details.
3337

3438

3539
Measure code coverage

0 commit comments

Comments
 (0)