{"data":{"markdownRemark":{"html":"

Building via Docker

\n

Before you begin make sure your model is added inside org.models package, and registered inside the main class. You should also confirm being able to run locally before deploying.

\n

Building using Maven

\n

The first step is to make a few changes to your pom.xml (if not pulling from the quickstart repo). Make sure you add the jodatime and junit versions to your properties section.

\n

pom.xml

\n
<properties>\n  <maven.compiler.source>1.8</maven.compiler.source>\n  <maven.compiler.target>1.8</maven.compiler.target>\n  <jodatime.version>2.10.1</jodatime.version>\n  <junit.version>5.3.2</junit.version>\n</properties>
\n

You will then want to add the jodatime and junit dependencies to the section starting with ''

\n
\nprevious dependency used junit, this has been replace with the junit-jupiter-api.\n
\n

pom.xml

\n
<dependency>\n      <groupId>org.junit.jupiter</groupId>\n      <artifactId>junit-jupiter-api</artifactId>\n      <version>${junit.version}</version>\n      <scope>test</scope>\n    </dependency>\n    <dependency>\n      <groupId>joda-time</groupId>\n      <artifactId>joda-time</artifactId>\n      <version>${jodatime.version}</version>\n</dependency>
\n

Finally you will add the plugins for assembling and dockerize-ing the project.

\n

pom.xml

\n
<plugin>\n  <groupId>org.apache.maven.plugins</groupId>\n  <artifactId>maven-shade-plugin</artifactId>\n  <version>3.2.1</version>\n  <executions>\n    <execution>\n    <phase>package</phase>\n    <goals>\n      <goal>shade</goal>\n    </goals>\n    <configuration>\n      <shadedArtifactAttached>true</shadedArtifactAttached>\n      <shadedClassifierName>allinone</shadedClassifierName>\n      <artifactSet>\n        <includes>\n          <include>*:*</include>\n        </includes>\n      </artifactSet>\n      <transformers>\n        <transformer implementation=\"org.apache.maven.plugins.shade.resource.AppendingTransformer\">\n          <resource>reference.conf</resource>\n        </transformer>\n        <transformer implementation=\"org.apache.maven.plugins.shade.resource.ManifestResourceTransformer\">\n          <main-Class>Main</main-Class>\n        </transformer>\n      </transformers>\n    </configuration>\n    </execution>\n  </executions>\n</plugin>\n<plugin>\n  <groupId>com.spotify</groupId>\n  <artifactId>docker-maven-plugin</artifactId>\n  <version>1.0.0</version>\n  <configuration>\n    <imageName>simudyne-maven-docker</imageName>\n    <baseImage>simudyne/scala-sbt:2.11.12.1.0.4</baseImage>\n    <entryPoint>[\"java\", \"-jar\", \"/${project.build.finalName}-allinone.jar\"]</entryPoint>\n    <!-- copy the service's jar file from target into the root directory of the image -->\n    <resources>\n      <resource>\n        <targetPath>/</targetPath>\n        <directory>${project.build.directory}</directory>\n        <include>${project.build.finalName}-allinone.jar</include>\n      </resource>\n      <resource>\n        <targetPath>/root</targetPath>\n        <directory>.</directory>\n        <include>licenseKey</include>\n      </resource>\n      <resource>\n        <targetPath>/</targetPath>\n        <directory>.</directory>\n        <include>simudyneSDK.properties</include>\n      </resource>\n    </resources>\n  </configuration>\n</plugin>
\n
\n

License file

\nThe pom.xml above expect the license file to be named licenseKey and to be present in the root of the project directory, as simudyneSDK.properties. You need to update these path if you use a different location to ensure the license file is added to the docker image. If not, an error will be thrown at runtime as the license will not be present.\n
\n
\n

Properties File

\nIf you are using the default 'simudyneSDK.properties' file you can proceed. If however, you are using multiple '.properties' files (such as a different setting for working with Spark) you will need to change a few things:\n
    \n
  1. \n Change the name of the targeted property file (default to `simudyneSDK.properties`)with the name and location of your own.\n
    2. \n
  2. \n Edit the entryPoint field to add the '-DsimudyneConfigFile' and '-DsimudyneConfigDir' as you would normally do for running.\n
    3. \n
\n
\n

Building the image

\n

Build the image by running 'mvn clean package docker:build -s settings.xml' inside the project's folder. This will create a docker image using the dockerfile generated by mvn in the way defined inside 'pom.xml'.

\n
\n

Pushing to Docker Hub

\n

You will now push the docker image you have created to the Docker hub. You will want to replace the following things.

\n\n

An example of this would be simudyne/simu-repo:demos

\n
sudo docker tag [build] [account]/[repo-name]:[tag]\nsudo docker push [account]/[repo-name]
\n

You should be able to navigate to the Docker hub and confirm your image has been updated.

\n
\n

Logging into Docker

\n

You must first run 'docker login' before you can push or pull to a repo. This will automatically ask for your account and password.

\n
\n

Deployment on Server

\n

You must first log into the VM or server which you are deploying on. Please make sure the appropriate firewall and ports are made available based on either your public or intranet settings.

\n

Pull the image using the details you specified above.

\n
sudo docker pull [account]/[repo-name]:[tag]
\n

You will likely already be running a container if not please skip to the next step. However, if you are you need to stop the existing container.

\n
sudo docker ps #to identify the container ID\nsudo docker stop <containerID>
\n

You will then look for the exact image name, and then run it with the following configuration options.

\n\n

An example of this would be 'docker run -p 80:80 f3c0fa608b22 0.0.0.0 80'

\n
sudo docker images # to have a look at the available images and get ImageID\nsudo docker run -p <port>:<port> <ImageID> <ip> <port>
\n
\nIf you get a connection reset error, or if your log displays only accessible locally you need to update your property file. Set nexus-server.hostname = 0.0.0.0. If you use the default property file (simudyneSDK.properties), simply remove the # that comment the line.\n
\n

Once completed you should be able to go to the IP or DNS address of the server you've deployed on (mind the port) and see the console as you would locally.

","headings":[{"value":"Building via Docker","depth":2},{"value":"Building using Maven","depth":3},{"value":"Pushing to Docker Hub","depth":2},{"value":"Deployment on Server","depth":2}],"frontmatter":{"title":"Deploying via Docker","toc":null,"experimental":null}},"site":{"siteMetadata":{"title":"Simudyne Docs","latestVersion":"2.6"}}},"pageContext":{"absolutePath":"/home/vsts/work/1/s/content/2.2/reference/deployment/docker.md","versioned":true,"version":"2.2","kind":"reference","pagePath":"/reference/deployment/docker","chronology":{"prev":{"name":"Deployment","path":"/reference/deployment"},"next":{"name":"Run mode","path":"/reference/run_mode"}},"lastUpdated":"2026-04-21T13:56:54.836Z"}}