Docker-images bouwen met Actions

Een Dockerfile is een tekstbestand met alle opdrachten om een Docker-image samen te stellen. Het is net een recept.

Hier zie je een heel eenvoudig Dockerfile-voorbeeld:

Laten we die eenvoudige Dockerfile stap voor stap bekijken:

• FROM alpine:latest: Hiermee geef je de basisimage op. We beginnen met een kleine Linux-distributie met de naam Alpine.
• WORKDIR /app: Hiermee stel je de werkmap in de image in.
• COPY . .: Hiermee kopieer je alle bestanden uit je projectmap naar de map /app in de image.
• CMD ["echo", "Hello from Docker!"]: Dit is de opdracht die wordt uitgevoerd wanneer vanuit deze image een container start.

Dit bestand staat in de hoofdmap van je project.

Om Docker-images te bouwen met GitHub Actions maak je een YAML-bestand (bijv. .github/workflows/docker-build.yml) in je repository.

Dit bestand definieert je werkstroom, een reeks geautomatiseerde stappen.

Een basiswerkstroom voor het bouwen van een image bevat doorgaans:

1. Je code ophalen.
2. De Docker-bouwomgeving instellen.
3. De Docker-image bouwen.

De eerste stap in bijna elke GitHub Actions-werkstroom is het ophalen van de code uit je repository. Dit doe je met de actions/checkout-actie.

Deze kloont je repository naar de runner, zodat je Dockerfile en applicatiecode beschikbaar zijn voor het bouwproces.

Zo ziet dit eruit in je werkstroombestand:

Vervolgens moeten we de Docker-bouwomgeving instellen. De docker/setup-buildx-action wordt sterk aanbevolen.

Buildx is een Docker-component die de bouwmogelijkheden van Docker uitbreidt en geavanceerde functies zoals bouwen voor meerdere platforms ondersteunt.

Voeg deze stap toe aan je werkstroom:

Nu komt het belangrijkste onderdeel: de image bouwen! Hiervoor gebruiken we de docker/build-push-action.

Belangrijke opties:

• context: .: Hiermee geef je de bouwcontext op (meestal de hoofdmap van je repository).
• push: false: Voorlopig bouwen we alleen, zonder naar een register te pushen. In een latere les behandelen we het pushen.
• tags: my-app:latest: Hiermee geef je je image een naam en tag.

Hier zie je de volledige GitHub Actions-werkstroom voor het bouwen van een Docker-image. Denk eraan: deze YAML komt in .github/workflows/docker-build.yml.

Deze werkstroom wordt bij elke push naar je repository gestart.

Goed gedaan! Je hebt de basis geleerd van het automatiseren van Docker-imagebouw met GitHub Actions.

We hebben behandeld:

• Wat Docker-images zijn en waarom ze belangrijk zijn.
• De rol van een Dockerfile als blauwdruk voor de image.
• Het instellen van een basiswerkstroom voor GitHub Actions.
• Het gebruiken van essentiële acties zoals actions/checkout, docker/setup-buildx-action en docker/build-push-action.

In de volgende les leer je hoe je deze gebouwde images naar een containerregister pusht!