⚠️ We're no longer maintaining this image.
This repo will contain docker images with GOSS.
Current versions available:
.
├── 0
│ └── alpine
│ └── Dockerfile
Images can be found on https://hub.docker.com/r/philipssoftware/goss/.
Make sure that a goss.yaml
file is located in the repository root folder.
When running locally. This file should be located in the working directory of the container (e.g mount volume).
Example of such file:
file:
/app/service.jar:
exists: true
/app/start.sh:
exists: true
You can configure the tool with parameters or environment variables.
Param | Env Variable | Description | Required | Default |
---|---|---|---|---|
-i | DOCKER_IMAGE | The name of the image that needs to be tested | true | |
-t | DOCKER_TAG | The tag of the image (e.g latest) | true | |
-r | DOCKER_REGISTRY | The location of the docker repository | false | registry.hub.docker.com |
-u | DOCKER_USERNAME | Username of docker repository | false | gitlab-ci-token |
-p | DOCKER_PASSWORD | Password of docker repository | false | $CI_BUILD_TOKEN |
$docker run -it -v $(pwd):/goss -v /var/run/docker.sock:/var/run/docker.sock:ro -e "DOCKER_IMAGE=nginx" -e "DOCKER_TAG=1.11.10" -e "GOSS_FILES_PATH=/goss" philipssoftware/goss:latest ./test.sh
The images obviously contain goss, but also two other files:
REPO
TAGS
This file has a url to the REPO with specific commit-sha of the build. Example:
$ docker run -it --rm philipssoftware/goss:0.3.7 cat REPO
https://github.com/philips-software/docker-goss/tree/36ea34634d022e26d87d3e6b3e0f0d2841327e00
This contains all the similar tags at the point of creation.
$ docker run -it --rm philipssoftware/goss:0.3.7 cat TAGS
goss goss:0.3 goss:0.3.7 goss:0.3.7-alpine
You can use this to pin down a version of the container from an existing development build for production. When using goss:0.3.6
for development. This ensures that you've got all security updates in your build. If you want to pin the version of your image down for production, you can use this file inside of the container to look for the most specific tag, the last one.
goss
,goss:0.3
,goss:0.3.7
,goss:0.3.7-alpine
0.3.7/alpine/Dockerfile
Why do we have our own docker image definitions?
We often need goss to test our containers. There is no official docker image, so let's make a version for our build pipelines.
- If you have an issue: report it on the issue tracker
- Jeroen Knoops jeroen.knoops@philips.com
- Heijden, Remco van der remco.van.der.heijden@philips.com
License is MIT. See LICENSE file
This module is part of the Philips Forest.
___ _
/ __\__ _ __ ___ ___| |_
/ _\/ _ \| '__/ _ \/ __| __|
/ / | (_) | | | __/\__ \ |_
\/ \___/|_| \___||___/\__|
Infrastructure
Talk to the forestkeepers in the docker-images
-channel on Slack.