Containerisatie met Docker

Met Docker kun je je toepassingen en al hun afhankelijkheden verpakken in gestandaardiseerde eenheden die containers worden genoemd. Zie het als een lichtgewicht virtuele machine, maar dan veel efficiënter!

Voor Clojure-ontwikkelaars zorgt Docker ervoor dat je toepassing op jouw computer, op de computer van een teamgenoot of in de cloud precies hetzelfde draait. Geen problemen meer met "het werkt op mijn computer"!

De kern van Docker bestaat uit twee belangrijke concepten:

• Images: dit zijn alleen-lezen-sjablonen, vergelijkbaar met een bouwtekening voor je toepassing. Ze bevatten je code, bibliotheken en runtime.
• Containers: dit zijn uitvoerbare instanties van een image. Je kunt een container starten, stoppen, verplaatsen of verwijderen zonder het image te beïnvloeden.

Een Dockerfile is een script dat Docker vertelt hoe het een image moet bouwen.

Elke Dockerfile begint met een FROM-instructie. Deze specificeert het basisimage waarop je toepassing wordt gebouwd. Voor Clojure is een OpenJDK-image (Java Development Kit) een uitstekende keuze.

De WORKDIR-instructie stelt de standaardmap in voor volgende opdrachten in het image.

Onze Clojure-webapp heeft een bibliotheek nodig om HTTP-verzoeken af te handelen. We gebruiken de Jetty-adapter van Ring. Deze afhankelijkheid staat in je deps.edn-bestand, dat Clojure gebruikt voor afhankelijkheidsbeheer.

We definiëren een kaart waarin de sleutels bibliotheeknamen zijn en de waarden hun versie aangeven. Zo weet Clojure hoe het de benodigde code kan vinden en downloaden.

Laten we nu een minimale Clojure-webserver schrijven. Dit bestand, src/server.clj, wordt het startpunt van onze applicatie. Het start een Jetty-server die naar poort 3000 luistert en reageert met "Hello from Docker!".

Probeer deze eerst lokaal uit te voeren (nadat je deps.edn hebt ingesteld en clojure -P hebt uitgevoerd):

Vervolgens kopiëren we deps.edn en de broncode naar de container. Het is een goede gewoonte om eerst deps.edn te kopiëren en clojure -P uit te voeren. Als deps.edn niet verandert, kan Docker deze laag opnieuw gebruiken, waardoor builds sneller worden.

Daarna kopiëren we de overige projectbestanden.

Voor een webapp moeten we Docker vertellen naar welke poort onze applicatie luistert. De instructie EXPOSE documenteert dit. Vervolgens geeft CMD aan welke opdracht moet worden uitgevoerd wanneer de container start, zodat onze Clojure-applicatie wordt gestart.

Onze Clojure-applicatie voert de functie -main uit in de namespace server.

Nu de Dockerfile en ons Clojure-project klaar zijn, kunnen we de Docker-image bouwen. Ga naar de hoofdmap van je project (waar Dockerfile, deps.edn en src staan) en voer deze opdracht uit:

• -t voorziet je image van een naam en optioneel een versienummer.
• . vertelt Docker dat het de Dockerfile in de huidige map moet zoeken.

Nadat de image is gebouwd, kun je deze als container uitvoeren. We gebruiken de optie -p om een poort op je hostcomputer (bijvoorbeeld 8080) te koppelen aan de poort in de container (3000, zoals die door onze applicatie wordt blootgesteld).

Open na het uitvoeren je browser op http://localhost:8080 om je Clojure-applicatie te bekijken!

Het containeriseren van je Clojure-applicaties biedt veel voordelen:

• Consistentie: Je app werkt overal hetzelfde.
• Isolatie: Containers isoleren je app van andere apps en het hostsysteem.
• Draagbaarheid: Verplaats je app eenvoudig tussen verschillende omgevingen.
• Schaalbaarheid: Start snel meerdere instanties van je app.

Dit maakt de implementatie en het beheer van Clojure-services veel eenvoudiger.

Je hebt geleerd hoe Docker helpt om Clojure-applicaties te verpakken voor een consistente implementatie. We hebben het volgende behandeld:

• De basisbegrippen Images en Containers.
• Het schrijven van een Dockerfile met belangrijke instructies zoals FROM, WORKDIR, COPY, RUN, EXPOSE en CMD.
• Het bouwen van een Docker-image en deze uitvoeren als container.

Deze kennis is essentieel voor het implementeren van robuuste Clojure-microservices!