Skip to content
This repository has been archived by the owner on Jul 13, 2022. It is now read-only.

philips-software/docker-goss

Repository files navigation

Build Status

⚠️ We're no longer maintaining this image.

Docker images

This repo will contain docker images with GOSS.

Current versions available:

.
├── 0
│   └── alpine
│       └── Dockerfile

Usage

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

Content

The images obviously contain goss, but also two other files:

  • REPO
  • TAGS

REPO

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

TAGS

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.

Simple Tags

goss

Why

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.

Issues

Author

License

License is MIT. See LICENSE file

Philips Forest

This module is part of the Philips Forest.

                                                     ___                   _
                                                    / __\__  _ __ ___  ___| |_
                                                   / _\/ _ \| '__/ _ \/ __| __|
                                                  / / | (_) | | |  __/\__ \ |_
                                                  \/   \___/|_|  \___||___/\__|  

                                                                 Infrastructure

Talk to the forestkeepers in the docker-images-channel on Slack.

Slack