Continuous Integration with Docker Compose (CIDC)

Components

• User management/LDAP: OpenDJ | Docker Image
• Single Sign On: Keycloak | Docker Image
  • Postgresql DB | Docker Image
  • PGAdmin4 | Docker Image
• Documentation site: MkDocs, MKDocs Material
• Repository manager: Nexus 3 | Docker Image
• CI/Build Server: Jenkins | Docker Image
• Code Quality: SonarQube | Docker Image
• Docker UI: Portainer | Docker Image

How to use

Pull & Build

./build.sh

warning

• for some images you will require either a proxy or access to the internet
• enable wifi worksquare-guest
• rerun ./build.sh
• then you will fail on the q-nexus-3 prefix, so return to worksquare network
• repeate until you have all the images downloaded and build
• yes this is cumbersome, but is a one-time process

Start

Make sure you have this repository checked out.

./start.sh

That should build and start all the containers.

Once this finishes, you can now login into SonarQube via keycloak:

• Go to Jenkins
• Click login (top right) and select OpenID as login provider
• Username: barbossa
• Password: jack
• This should redirect you as a logged in user!

Stop

./stop.sh

Clean up all resources

If you want to clean up all the resources related to this docker compose stack, you can do so with docker-compose down.

Though experience shows this doesn't always remove all resources, so there's a convenience script.

./clean-all.sh

How to access the services

For figuring out where the services can be accessed, take a look at the portainer UI at localhost:9000.

Go to "Containers", filter on "running" only and you should see several containers with the "cidc" prefix. On the right you can see their ports and click on them to be opened.

Jenkins runs on /jenkins SonarQube runs on /sonar

Or, you can run the utility application and open its webpage in a browser at localhost:8087/.

cicd-sandbox-util.exe -action serve

Single Sign On (with Keycloak)

We use Keycloak for Single Sign On.

The default credentials for Keycloak is admin admin.

For more information: localhost:8282 or go to the raw docs