Skip to content

Via onderstaande methode, kun je bestaande docker containers draaien op Oege.

Manually deploying your app with Oege

It’s time to deploy your app! Oege provides you access to a linux environment where you can deploy your docker application to. This in a few simple steps.

Establishing an SSH connection

Oege provides you SSH access. SSH access is a secure way to connect to the Oege server and execute commands in a Linux environment. We need this SSH connection to install Docker and start a Docker container. To be able to establish this connection you might need to install some software. Please read this knowledgebase article. On Windows I recommend PuTTy and on MacOS use the build in ssh in the terminal.

Make sure you connect to host oege.ie.hva.nl on port 22.

On windows with putty

alt text

On MacOS

ssh your_username@oege.ie.hva.nl (enter)
your_password

If this is the first time you connect to Oege, you will be asked to accept a key. Accept this key. Log in with your HvA-Id (but not your HvA-id password), use the password that was send to your e-mail.

Installing Docker

Once the connection is established, you need to install Docker. Read the welcome message for the correct instruction. Copy-paste this instruction and press enter.

alt text

Deploying to Oege

  1. Download the image you deployed to the Docker-hub using the pull command.
docker pull <your-docker-hub-user><your-fe-app-name>

For example, docker pull mfknr/ewa-front-end is a valid command.

  1. Start a Docker container.

In the Dockerfile you already exposed some ports using the EXPOSE instruction. On Oege you may not be able to use the port you selected. The ports higher than 1000 are available for use, however, these ports are shared with everyone else. If the port in your Dockerfile is already in use, you can reroute to another port using the -p argument. Ports 8000 to 10000 are special; they are also accessible from the internet.

loginctl enable-linger $(whoami)
systemctl --user enable docker 

docker run -d --restart=always --name <myContainerName> -p 0.0.0.0:<Oege port>:<exposed port> <your-docker-hub-user><your-fe-app-name>

For example, docker run -d --restart=always --name myBackendApp -p 0.0.0.0:8321:8080 mfknr/ewa-front-end is a valid command.

  1. Test your docker container

You can go to http://oege.ie.hva.nl:port/ to test if your docker image is hosted on Oege.

For example, http://oege.ie.hva.nl:8080/ is a valid address.

By default your application will probably run over an unsecure connection. This means you need to use a http-connection (without the ‘s’) to connect to Oege. If you get an error about certificates in your browser, try to select your address-bar in the browser and delete the ‘s’ behind http and press enter.

Best practice would be to enable a secure connections. To do this you should find out how to implement a HTTPS connection in your framework.

  1. Or use the webserver on Oege as proxy. see step 1 - 7

  2. Next Step: Configuring a database for your application

  3. Previous Step: Preparing the containers
  4. Home