File: ci.md

package info (click to toggle)
jss 5.5.0-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 8,204 kB
  • sloc: java: 73,154; ansic: 24,874; cpp: 4,414; sh: 873; xml: 402; python: 345; makefile: 28
file content (34 lines) | stat: -rw-r--r-- 1,168 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# Containers and Continuous Integration

JSS uses [Travis CI](https://travis-ci.org/dogtagpki/jss) for PR gating. We use
Linux containers to ensure a consistent build environment and to allow us
to test locally and in Travis on various platforms.


## Running CI Locally

The Docker images are built in Travis using the Dockerfiles in
`tools/Dockerfiles`; they are not pushed to DockerHub or similar platforms
at this time. To test locally, we recommend using the provided container
tool, `tools/run_container.sh`.

For a brief example:

```bash
cd /path/to/sandbox/jss
./tools/run_container.sh fedora_28
```

Note that this requires either Buildah and Podman or Docker to be installed.

For more extensive documentation, please refer to the
[Buildah](https://github.com/containers/buildah/blob/master/docs/) and
[Podman docs](https://github.com/containers/libpod/tree/master/docs) and
the code in the `tools/run_container.sh` script.


## Skipping CI

To skip running CI for a given commit (e.g., for updating documentation),
append `[skip ci]` to the commit summary. Note that the `ubuntu_jdk8` image
does not affect build status; it is included for reference only.