Containerisering med Docker

Docker hjälper dig att paketera dina applikationer och alla deras beroenden i standardiserade enheter som kallas containrar. Se det som en lättviktig virtuell maskin, men mycket effektivare!

För Clojure-utvecklare ser Docker till att applikationen körs på exakt samma sätt på din dator, en kollegas dator eller i molnet. Slut på problemen med att ”det fungerar på min dator”!

Docker bygger på två centrala begrepp:

• Avbildningar: Det här är skrivskyddade mallar, ungefär som en ritning för applikationen. De innehåller din kod, dina bibliotek och din körmiljö.
• Containrar: Det här är körbara instanser av en avbildning. Du kan starta, stoppa, flytta eller ta bort en container utan att påverka avbildningen.

En Dockerfile är ett skript som talar om för Docker hur en avbildning ska byggas.

Alla Dockerfiles börjar med instruktionen FROM. Den anger den basavbildning som applikationen ska byggas vidare på. För Clojure är en OpenJDK-avbildning (Java Development Kit) ett utmärkt val.

Instruktionen WORKDIR anger standardkatalogen för efterföljande kommandon i avbildningen.

Vår Clojure-webbapp behöver ett bibliotek för att hantera HTTP-anrop. Vi använder Rings Jetty-adapter. Detta beroende deklareras i filen deps.edn, som Clojure använder för beroendehantering.

Vi definierar en map där nycklarna är biblioteksnamn och värdena anger deras version. Det talar om för Clojure hur den ska hitta och hämta den kod som behövs.

Nu ska vi skriva en minimal Clojure-webbserver. Den här filen, src/server.clj, blir startpunkten för vår applikation. Den startar en Jetty-server som lyssnar på port 3000 och svarar med "Hello from Docker!".

Försök köra den lokalt först (när ni har konfigurerat deps.edn och kört clojure -P):

Nu kopierar vi deps.edn och källkoden till containern. Det är god praxis att kopiera deps.edn först och köra clojure -P. Om deps.edn inte ändras kan Docker återanvända det här lagret, vilket gör byggen snabbare.

Sedan kopierar vi resten av projektfilerna.

För en webbapp behöver vi tala om för Docker vilken port applikationen lyssnar på. Instruktionen EXPOSE dokumenterar detta. Sedan anger CMD vilket kommando som ska köras när containern startar och startar vår Clojure-app.

Vår Clojure-app kör funktionen -main i namnrymden server.

När Dockerfile och Clojure-projektet är klara kan vi bygga Docker-avbildningen. Gå till projektets rotkatalog (där Dockerfile, deps.edn och src finns) och kör det här kommandot:

• -t märker avbildningen med ett namn och en valfri version.
• . anger att Docker ska leta efter Dockerfile i den aktuella katalogen.

När avbildningen har byggts kan ni köra den som en container. Vi använder flaggan -p för att mappa en port på värddatorn (till exempel 8080) till porten inuti containern (3000, som vår app exponerar).

Öppna http://localhost:8080 i webbläsaren efter starten för att se Clojure-appen!

Att köra era Clojure-applikationer i containrar har många fördelar:

• Enhetlighet: Appen körs likadant överallt.
• Isolering: Containrar isolerar appen från andra appar och värdsystemet.
• Portabilitet: Flytta enkelt appen mellan olika miljöer.
• Skalbarhet: Starta snabbt flera instanser av appen.

Det gör driftsättning och hantering mycket enklare för Clojure-tjänster.

Ni har lärt er hur Docker hjälper till att paketera Clojure-applikationer för enhetlig driftsättning. Vi gick igenom:

• Grundbegreppen avbildningar och containrar.
• Att skriva en Dockerfile med viktiga instruktioner som FROM, WORKDIR, COPY, RUN, EXPOSE och CMD.
• Att bygga en Docker-avbildning och köra den som en container.

Den här kunskapen är avgörande för att driftsätta robusta Clojure-mikrotjänster!