1Docker Setup to Build OpenXPKI for Debian
2#########################################
3
4This directory provides a docker setup to build and sign packages for debian.
5
6Step 1 - Container
7------------------
8
9Call `make build` or `make build-nocache` to create the docker container.
10
11Step 2 - CPAN Deps
12------------------
13
14Create the directory `deps` and but any requried extra build dependancy
15packages there, this is required to build e.g. the perl packages for
16LibSCEP (`make Crypt__LibSCEP`).
17
18Now call `make cpan` to build the packages for the CPAN modules.
19The packages will end up in the directory `packages` (will be created if
20not already present).
21
22Step 3 - OpenXPKI Packages
23--------------------------
24
25The full OpenXPKI release consists of three packages, `core`, `i18n`
26and `cgi-session-driver`, the target `openxpki` builds then all.
27
28This does **not** require the CPAN packages to be build or present, the
29packages will also end up in the `packages` directory.
30
31Step 4 - Create Repo
32--------------------
33
34Run `make repo` builds a debian repository structure and writes it to
35the directory `repository`. The files from the `reprepro` folder will
36be used as defaults if `reprepro/conf` does not exist.
37
38All packages from the `package` directory will be included, you can feed
39extra packages (e.g. libscep) from the `extra` folder.
40
41If you want to sign the packages, place the required keys into the
42directory `secret`, you will be prompted for the passwords.
43
44Step 5 - Run Test
45-----------------
46
47Run `make test` to execute a minimal testset using the packages from a
48previous build in the `packages` directory.
49
50