Skip to content
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Dev Servers

Dev Servers is a Docker Compose asset to setup server tools for CI / CD. It setups the following tools with Docker and makes them available immediately.

  • Souce Code Management : GitBucket
  • Continuous Integration : Jenkins
  • Static Code Analysis : SonarQube
  • Issue Tracking System : Redmine
  • Artifact Repository Manager : Artifactory

Each server tool is configured as a service of Docker Compose. Each service has the following settings necessary for team development.

  • LDAP Authentication
    • You can log in to all tools with the same user ID / password.
  • Proxy Server
    • It can be accessed via the same proxy server.
  • Self Service Password
    • Users can change passwords and send reminders.
  • E-mail
    • You can set the connection information of the SMTP server of each service in one place.
    • The e-mail address of the LDAP user account is used as the mail transmission destination.

Quick Start

  1. Install Docker.
  1. Set the memory allocation of Docker to 4 GB or more.
  • Windows 10 Pro
    • Settings > Advanced > Memory
  • Mac
    • Preferences > Advanced > Memory
  1. Get the resource of SIT-DS and execute each Docker Compose Service with the following command.
git clone https://github.com/sitoolkit/sit-ds.git
cd sit-ds
docker-compose up -d

The endpoint URL to each service and the connection information of the admin user are as follows.

Server Endpoint URL (*1) UserId / Password
GitBucket http://localhost/gitbucket root / root
Jenkins http://localhost/jenkins admin / admin
SonarQube http://localhost/sonarqube admin / admin
Redmine http://localhost/redmine admin / admin
Artifactory http://localhost/artifactory admin / password
PostgreSQL jdbc:postgresql://localhost:5432/postgres postgres / postgres
Self Service Password http://localhost/passchg admin / admin
phpLDAPAdmin https://localhost:17443 cn=admin,dc=example,dc=org / admin
  • *1 For Docker Toolbox, it is an IP address that can be confirmed with docker-machine ls command instead of localhost.

How To Add Users

  1. Create new ldif file and add the user information you want to add.
  • add-users.ldif
dn: cn=user001,dc=example,dc=org
changetype: add
cn: user001
sn: User
givenName: 001
mail: user001@exapmle.org
objectClass: inetOrgPerson
objectClass: person
objectClass: top
userPassword: password
  1. Execute the following command.
docker cp add-users.ldif sit-ds_work_1:/tmp
docker-compose exec work ldapmod add-users.ldif

Then you can log in to all services with the following user ID / password.

  • user001 / password

End to End Test

The following command confirms that the user added above can log in to each service by the automated test.

docker-compose exec e2etest ./mvnw verify -DuserId=user001 -Dpassword=password

See e2etest/evidence/evidence_yyyymmddhhmmss/report/failsafe-report.html for the results of the automated test.

This automated test is implemented by Web Tester.

Backup

  1. Execute backup.sh specifing the directory you want to save backup files.
    1. All services will be stopped.
    2. All named volumes in docker-compose.yml will be backuped to backup/{timestamp} directory.
    3. 8th and subsequent directories in order of age will be deleted.
    4. All services will be started.
./backup.sh /path/to/backup/directory
/path/to/backup/directory
  - yyyymmdd_hhmmss
    - ci_data.tar
    - dbms_data.tar
      :

Restore

  1. Execute restore.sh specifying the path of the directory that contains the backup file you want to restore. Read and restore tar file of "sit-ds_" prefix of specified directory.
git clone https://github.com/sitoolkit/sit-ds.git
cd sit-ds
./restore.sh /path/to/backup/directory/yyyymmdd_hhmmss
docker-compose up -d