The CI Platform: Overview

Prerequest

• A working OpenLDAP server ( Optional )

Required environment variables

• PROXY_HOST the fqdn/ip of proxy
• LDAP_URI the fqdn/ip of ldap server ( Optional )
• LDAP_USER_BASEDN the ldap searching base DN of your ldap server
• CI_INIT_ADMIN/CI_INIT_PASSWORD/CI_INIT_EMAIL administrator's uid/password/email for Gerrit and Jenkins which must be existed in your OpenLDAP server.
• VOLUME_DRIVER must be changed to "local" if rbd-docker-plugin is unavailable.

Quickstart Instructions

1. Specify required variables in the env.config file.
2. Run: ./ci.sh -f ldap-compose.yml up -d
3. Access http://PROXY_HOST:LAM_PORT/lam/ and login with password specified in LDAP_PWD.
4. Create or import the admin entry according to CI_INIT_ADMIN and CI_INIT_PASSWORD and CI_INIT_EMAIL.
5. Run: ./ci.sh -f ldap-compose.yml -f docker-compose.yml up -d
6. Access http://PROXY_HOST in your browser.

General Getting Started Instructions

To run with Docker Swarm

1. Specify PROXY_NODE to the docker node name on your PROXY_HOST.
2. Specify DOCKER_SWARM_URI to the URI of your swarm manager node.

Start up a smtp relay service

1. Specify RELAY_MYDOMAIN and RELAY_HOST in env.config for smtp-relay service.
2. Run: ./ci.sh -f mail-compose.yml up -d
3. Run: ./ci.sh -f mail-compose.yml exec smtp-relay /bin/sh to get into the container.
4. Exec: /saslpasswd.sh -u example.com -c admin then exit container.
5. Specify *Email section in env.config and set NOTIFY_ON_CHANGE=true for ldap-ssp.

Scale up Jenkins Swarm Agent nodes

• Run: ./ci.sh scale jenkins-agent=2

Import demo projects

cd demo ./import-demo.sh