Guides on docker images and travis.

viniciusam · viniciusam · commit 4586625f8d22 · 2017-04-01T14:03:11.000-03:00
diff --git a/docs/about/CONTRIBUTING.md b/docs/about/CONTRIBUTING.md
@@ -25,6 +25,7 @@ Changes are welcome from all members of the Community.
 
 **Note:** Getting changes from others requires [Syncing your Local repository](https://help.github.com/articles/syncing-a-fork) with Master utPLSQL repository.    This can happen at any time.
 
+
 ## Coding Standards ##
 
 * Snake case will be used.   This separates keywords in names with underscores.  `execute_test`
@@ -39,7 +40,48 @@ Changes are welcome from all members of the Community.
 	* Nested Tables start with `tt_`
 * varchar2 lengths are set in characters not bytes 
 
- 
+
+## Testing Environment ##
+
+We are using docker images to test utPLSQL on our Travis CI builds. The following versions of Oracle Database are being used.
+
+* 11g XE R2
+* 12c SE R1
+* 12c SE R2
+
+These images are based on the official dockerfiles released by Oracle, but due to licensing restrictions, we can't make the images public. You can build your own and use it locally, or push to a private docker repository.
+
+The build steps are simple if you already have some experience using Docker. You can find detailed information about how to build your own image with a running database in: [example of creating an image with pre-built DB](https://github.com/oracle/docker-images/blob/master/OracleDatabase/samples/prebuiltdb/README.md)
+
+> You can find more info about the official Oracle images on the [Oracle Database on Docker](https://github.com/oracle/docker-images/tree/master/OracleDatabase) GitHub page.
+
+> If you are new to Docker, you can start by reading the [Getting Started With Docker](https://docs.docker.com/engine/getstarted/) docs.
+
+### Build Notes ###
+* You may not forget to comment out the VOLUME line. This step is required, because VOLUMES are not saved using `docker commit` command.
+
+* When the build proccess is complete, you will run the container to install the database. Once everything is set up and you see the message "DATABASE IS READY!", you may change the password and stop the running container. After the container is stopped, you can safely commit the container.
+
+* You can use the --squash experimental docker tag to reduce the image size. Example:
+```
+docker build --force-rm --no-cache --squash -t oracle/db-prebuilt .
+```
+
+Travis will use your Docker Hub credentials to pull the private images, and the following secure environment variables must be defined.
+
+Variable | Description
+---------|------------
+**DOCKER_USER** **DOCKER_PASSWORD** | _Your Docker Hub website credentials. They will be used to pull the private database images._
+
+### SQLCL ###
+
+Our build configurarion uses SQLCL to run the scripts, and you need to configure a few additional secure environment variables. After the first build, the downloaded file will be cached.
+
+Variable | Description
+---------|------------
+**ORACLE_OTN_USER ORACLE_OTN_PASSWORD** | _Your Oracle website credentials. They will be used to download SQLCL._
+
+
 ## New to GIT ##
 
 If you are new to GIT here are some links to help you with understanding how it works.    
