Docker build for chips-app image
This build extends the chips-domain image (https://github.com/companieshouse/chips-domain) and adds the chips and chips-rest-interfaces application files, along with further configuration that allows the CHIPS application to fully function.
In order to use the image, a number of environment properties need to be defined in a file, held locally to where the docker command is being run - for example, chips.properties
| Property | Description | Example |
|---|---|---|
| ADMIN_PASSWORD | The password to set for the weblogic user. Needs to be at least 8 chars and include a number. | secret123 |
| DOMAIN_CREDENTIAL | A random string to override and reset the default credential already present in the image. | kjsdgf5464fdva |
| LDAP_CREDENTIAL | A random string to override and reset the default credential already present in the image. | ldap01234 |
| DB_URL_CHIPSDS | Full JDBC connection string of CHIPS database | jdbc:oracle:thin:@chips.blahblah.eu-west-2.rds.amazonaws.com:1521:chips |
| DB_USER_CHIPSDS | Database username for CHIPS database | CHIPSDBUSER |
| DB_PASSWORD_CHIPSDS | Database password for CHIPS database | chipsdbpassword |
| DB_URL_STAFFSDS | Full JDBC connection string of CHIPS Staffware database | jdbc:oracle:thin:@chipssw.blahblah.eu-west-2.rds.amazonaws.com:1521:chipssw |
| DB_USER_STAFFDS | Database username for CHIPS Staffware database | CHIPSSWDBUSER |
| DB_PASSWORD_STAFFDS | Database password for CHIPS Staffware database | chipsswdbpassword |
| START_ARGS | Any startup JVM arguments that should be used when starting the managed server | -Dmyarg=true -Dmyotherarg=false |
| USER_MEM_ARGS | JVM arguments for setting the GC and memory settings for the managed server. These will be included at the start of the arguments to the JVM | -XX:+UseG1GC -verbose:gc -XX:+PrintGCDetails -XX:+PrintGCDateStamps -Xms712m -Xmx712m |
| ADMIN_MEM_ARGS | JVM arguments for setting the GC and memory settings for the admin server. These will be included at the start of the arguments to the JVM | -Djava.security.egd=file:/dev/./urandom -Xms32m -Xmx512m |
| AD_HOST | The hostname or ip of the Active Directory server against which to authenticate users | ldap99.domain.ch |
| AD_PORT | The port to use for a SSL connection | 636 |
| AD_PRINCIPAL | The user in AD for connecting in order to authenticate other user logins | CN=myldpauser, OU=AD Groups, OU=MySection, OU=MyOrg, DC=MyDepartment, DC=local |
| AD_CREDENTIAL | The password of the user in AD for connecting in order to authenticate other user logins | password |
| AD_USER_BASE_DN | The base location under which users can be found via a subtree search | OU=MySection, OU=MyOrg, DC=MyDepartment, DC=local |
| AD_GROUP_BASE_DN | The base location under which groups can be found via a subtree search | OU=MySection, OU=MyOrg, DC=MyDepartment, DC=local |
| AUTO_START_NODES | A list of managed server names to auto start when the container is launched | wlserver1,wlserver2,wlserver3,wlserver4 |
| TZ | The timezone to use when running WebLogic | Europe/London |
| APPLICATION_CONFIGURATOR_OVERRIDE_# | Override a property in the ApplicationConfigurator.properties file. E.g. APPLICATION_CONFIGURATOR_OVERRIDE_#="property=value". Multiple overrides can be used as long as each has a unique suffix (normally a number) | APPLICATION_CONFIGURATOR_OVERRIDE_1="staffware.ip.override.value=COBWEBUNIX2" |
In addition to these properties which are required for the use of the Docker image, there are also a large number of existing environment properties that are needed to run the CHIPS application. These are described in https://github.com/companieshouse/chips/blob/develop/ENVIRONMENT_PROPERTIES_README.md and are also listed in this repository https://github.com/companieshouse/chips-app/blob/main/chipsconfig/jms.properties.template
To build the image, from the root of this repo, run:
docker build -t chips-app .