Skip to content

Docker op Oege

Oege is een dienst van HvA HBO-ICT en bied je toegang tot een Linux-omgeving waar je Docker-applicaties kunt deployen. Dit kan al in een paar eenvoudige stappen!

Info over Oege en Docker

Docker is een veel gebruikt programma om van software handige pakketjes te maken die je overal kunt draaien. Je kunt hier meer info over Docker vinden.

Stap 1: Account aanmaken op Oege

Volg de instructies op de Oege pagina om een account aan te maken.

Stap 2: Een SSH-verbinding opzetten

Oege biedt SSH-toegang. SSH is een veilige manier om verbinding te maken met de Oege-server en commando’s uit te voeren in een Linux-omgeving.

Je hebt deze SSH-verbinding nodig om Docker te installeren en een Docker-container te starten. Lees dit artikel over het realiseren van een SSH-verbinding.

Om deze verbinding te kunnen maken, moet je (mogelijk) extra software installeren:

  • Werk je met Windows? gebruik dan PuTTy.
  • Werk je met MacOS? Gebruik dan OpenSSL.

Zorg ervoor dat je verbinding maakt met de host oege.ie.hva.nl op port 22.

Voorbeeld van Putty

Als dit de eerste keer is dat je verbinding maakt met Oege, krijg je de vraag om een sleutel te accepteren. Accepteer deze sleutel. Log in met je HvA-ID en gebruik het wachtwoord dat naar je e-mail is gestuurd. Je logt dus niet in met het gebruikelijke wachtwoord van je HvA account!

Stap 3: Docker installeren

Zodra de verbinding is opgezet, moet je Docker installeren. Lees het welkomstbericht voor de juiste instructie. Kopieer en plak deze instructie en druk op Enter.

Oege welkomstbericht over Docker

Stap 4: Deployen naar Oege

  1. Download een image die naar een Docker Hub is gedeployed met het pull-commando:

    docker pull <your-docker-hub-user><your-fe-app-name>

    Bijvoorbeeld, docker pull mfknr/ewa-front-end is een geldig commando.

    • De discount code service is te vinden onder bbolierhva/discount-code
    • De product price service is te vinden onder bbolierhva/product-price

  2. Start een Docker container:

    In een Docker-file worden poorten geopend. Op Oege kun je mogelijk niet de poort gebruiken die je hebt gekozen. De poorten 8000 tot 10000 zijn beschikbaar, maar deze worden gedeeld met alle andere gebruikers. Als de poort in je Dockerfile al in gebruik is, kun je deze omleiden naar een andere poort met het -p argument.

    docker run -d --name <my-container-name> -p <Oege port>:<exposed port> <your-docker-hub-user><your-fe-app-name>

    Bijvoorbeeld, docker run -d --name myBackendApp -p 8321:8080 mfknr/ewa-front-end is een geldig commando.

    Daarnaast wil je dat de applicatie blijft draaien als je uitlogd. Daarvoor kan je linger gebruiken.

    loginctl enable-linger $(whoami)

    Gebruik van linger

    Eens per week wordt de Oege server herstart en moet je jouw docker container opnieuw opstarten als je die wilt blijven gebruiken. Het gebruik van linger verandert hier niets aan!

  3. Test de Docker container

    Ga naar http://oege.ie.hva.nl:<jouw poort>/ om te testen of je Docker-image wordt gehost op Oege, bijvoorbeeld http://oege.ie.hva.nl:8080/.

    Standaard draait je applicatie waarschijnlijk over een onbeveiligde verbinding. Dit betekent dat je een http-verbinding (zonder ‘s’) moet gebruiken om verbinding te maken met Oege. Krijg je een foutmelding over certificaten in je browser? Probeer dan in de adresbalk de ‘s’ achter http te verwijderen en druk op enter.

    Uiteraard is een beveiligde verbinding het best! Onderzoek daarom hoe je een HTTPS-verbinding zou kunnen implementeren.