jomonjohnn / easy-genivigo

Easily deploy a Go.CD infrastructure via docker-compose

easy-genivigo

Easily deploy a Go.CD infrastructure using docker-machine and docker-compose.

Please see CHANGELOG for main changes since previous release.

This project may be useful to develop and test new pipelines, agents, features, etc. locally before deploying them to https://go.genivi.org/.

TL;DR

$ git clone https://github.com/gmacario/easy-genivigo
$ cd easy-genivigo
$ ./runme.sh

If the script executes successfully it will display a message like the following:

INFO: Browse the following URL to access the Go.CD dashboard:
INFO: http://192.168.99.100:8153

To access the Go.CD dashboard, browse ${GOCD_URL} as shown in the console (example: http://192.168.99.100:8153) using a recent Internet browser.

You will also be reminded to use the following command

INFO: Run the following command to configure your shell:
INFO: eval $(docker-machine env easy-genivigo)

in order to setup the environment variables so that docker-compose and docker will interact with the correct Docker engine.

Note 1: On a clean installation it may take a few minutes before the Go.CD server begins serving requests from your web client. You may check the startup progress with the following command:

$ eval $(docker-machine env easy-genivigo)
$ docker-compose logs

Note 2: The behavior of the runme.sh script may be customized using environment variables - please refer to the comments inside the script for details.

System Requirements

In order to run easy-genivigo you need a recent 64-bit x86 host with:

1. Minimum HW requirements: a dual-core CPU, 8 GB RAM, 100 GB disk space
2. Docker tools (see Note 1)
   • Docker Engine version 1.10.0 or later (see Note 2)
   • Docker Compose version 1.6.0 or later
   • Docker Machine version 0.6.0 or later
3. A recent Internet browser (i.e. Google Chrome)
4. A fast Internet connection

Note 1: By installing Docker Toolbox (either on OS X or MS Windows) you will get all the Docker tools (i.e. docker, docker-compose, docker-machine, etc.) required by easy-jenkins.

Note 2: Thanks to docker-machine you can configure easy-jenkins to deploy and run the containers on a remote Docker engine, for instance:

1. A fast, multi-core server on your local network
2. An instance on a public cloud, such as Amazon EC2, DigitalOcean, etc.

Architecture Overview

This section provides an architecture overview of easy-genivigo. Please refer to docker-compose.yml and the Dockerfile of each service for details.

Service goserver

This is a default Go.CD server deployed inside a Docker container.

Service goagent-docker

Service goagent-docker instantiates a new Go.CD agent inside a Docker container. This agent includes the docker and docker-compose commands to interact with the Docker engine used to run the Go.CD server and its agents.

To connect to a different Docker engine, the agent should be customized by properly configuring the DOCKER_HOST environment variable. See https://docs.docker.com/machine/reference/env for details.

Service goagent-yocto-genivi

Service goagent-docker instantiates another Go.CD agent running inside a container based on public Docker image gmacario/build-yocto-genivi. See https://github.com/gmacario/easy-build for details.

License and Copyright

easy-genivigo is licensed under the MIT License - for details please see the LICENSE file.

Copyright 2016, Gianpaolo Macario