Building

Building source

Perspective is using Maven to build its source so to build the entire project type the following:

$ mvn clean install

To skip tests type:

$ mvn clean install -DskipTests=true

Building Docker containers

To build the source and then create Docker containers just enable a profile called docker:

$ mvn clean install -Pdocker

You should have Docker installed on your build machine for this operation to complete successfully. When the build is finished your containers are accessible for usual Docker commands:

$ docker images
REPOSITORY                      TAG                 IMAGE ID            CREATED              SIZE
meridor/perspective-shell       1.3.2-SNAPSHOT      23bbd32fa779        About a minute ago   132.1 MB
perspective-shell               1.3.2-SNAPSHOT      23bbd32fa779        About a minute ago   132.1 MB
meridor/perspective-docker      1.3.2-SNAPSHOT      103da0e11736        2 minutes ago        136.6 MB
perspective-docker              1.3.2-SNAPSHOT      103da0e11736        2 minutes ago        136.6 MB
meridor/perspective-openstack   1.3.2-SNAPSHOT      d6ea7a47cc67        2 minutes ago        132.5 MB
perspective-openstack           1.3.2-SNAPSHOT      d6ea7a47cc67        2 minutes ago        132.5 MB
meridor/perspective-rest        1.3.2-SNAPSHOT      b9ca85f36a4d        3 minutes ago        131.2 MB

Notice that images are also tagged for Docker Hub deployment. To build containers and deploy them to Docker Hub type:

$ mvn clean deploy -Pdocker

To successfully authenticate to remote Docker registry you need to do one time:

$ docker login --username <your-username> --password <your-password>

This will save your credentials to a file which will be then read by Maven.