Natuurlijk, ik help je graag met het implementeren van een versiebeheersysteem voor je Docker-afbeeldingen. Hier zijn de stappen en aanbevelingen om een efficiënte en consistente workflow te creëren: 1. Gebruik een CI/CD-pipeline: - Automatiseer het build- en deploymentproces met een Continuous Integration/Continuous Deployment (CI/CD) tool zoals GitHub Actions, GitLab CI, Jenkins, of Travis CI. 2. Versie-tagging automatiseren: - Configureer je pipeline zodat deze automatisch tags toewijst aan Docker-afbeeldingen op basis van commit-berichten. - Bijvoorbeeld, als je commit-bericht bevat "versie 1.2.0" of "release 1.2.0", wordt deze als tag gebruikt. - Je kunt hiervoor scripts schrijven die het commit-bericht parseren en de juiste tag genereren. 3. Implementatievoorbeeld: - In je CI/CD-configuratie voeg je een stap toe die: - Het commit-bericht ophaalt. - Op zoek gaat naar versie-informatie (bijvoorbeeld via regex). - Vervolgens Docker build uitvoert. - Daarna de afbeelding tagged met die versie en gepusht naar Docker Hub. Voorbeeld in een bash-script: ```bash # Haal het laatste commit-bericht op COMMIT_MSG=$(git log -1 --pretty=%B) # Zoek naar versie in het bericht, bijvoorbeeld 'release 1.2.0' if [[ "$COMMIT_MSG" =~ release[[:space:]]([0-9]+\.[0-9]+\.[0-9]+) ]]; then VERSION="${BASH_REMATCH[1]}" else # fallback of automatische incrementele versie VERSION=$(date +%Y%m%d%H%M%S) fi # Bouw de Docker afbeelding docker build -t jouwgebruikersnaam/jouwimage:$VERSION . # Push naar Docker Hub docker push jouwgebruikersnaam/jouwimage:$VERSION ``` 4. Consistentie over omgevingen: - Gebruik dezelfde tags voor development, staging en productie door in je pipeline verschillende stappen of branches te gebruiken. - Overweeg het gebruik van 'latest' voor de meest recente stabiele build, naast specifieke versies. 5. Versiebeheer en documentatie: - Houd een changelog bij dat gekoppeld is aan je commit-berichten. - Zorg dat je pipeline duidelijk en reproduceerbaar is. 6. Authenticatie en beveiliging: - Zorg dat je CI/CD pipeline toegang heeft tot je Docker Hub credentials via veilige secret management. Door deze aanpak te volgen, krijg je een geautomatiseerd, consistent en traceerbaar systeem voor versiebeheer van je Docker-afbeeldingen, gebaseerd op je commit-berichten.

Hier is een praktische implementatiegids voor Docker image versiebeheer op basis van uw vereisten: ## 1. Semantic Versioning Strategie ```bash # Versieformaat: major.minor.patch MAJOR - breaking changes MINOR - nieuwe features (geen breaking changes) PATCH - bugfixes ``` ## 2. Automatische Tagging op Commit Berichten Maak een script (`tagging-script.sh`): ```bash #!/bin/bash COMMIT_MSG=$(git log -1 --pretty=%B) if [[ $COMMIT_MSG == *"BREAKING CHANGE"* ]] || [[ $COMMIT_MSG == *"major:"* ]]; then VERSION_TYPE="major" elif [[ $COMMIT_MSG == *"feat:"* ]] || [[ $COMMIT_MSG == *"feature:"* ]]; then VERSION_TYPE="minor" else VERSION_TYPE="patch" fi # Haal huidige versie op en verhoog CURRENT_VERSION=$(git describe --tags --abbrev=0 2>/dev/null || echo "0.0.0") NEW_VERSION=$(echo $CURRENT_VERSION | awk -F. -v type=$VERSION_TYPE '{ if (type == "major") {printf "%d.0.0", $1+1} else if (type == "minor") {printf "%d.%d.0", $1, $2+1} else if (type == "patch") {printf "%d.%d.%d", $1, $2, $3+1} }') # Tag de commit git tag -a "v${NEW_VERSION}" -m "Version ${NEW_VERSION}" git push origin "v${NEW_VERSION}" ``` ## 3. CI/CD Integratie (GitHub Actions voorbeeld) ```yaml name: Build and Tag Docker Image on: push: tags: ['v*'] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: Extract version from tag id: version run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT - name: Build and push Docker image uses: docker/build-push-action@v4 with: push: true tags: | yourusername/your-app:${{ steps.version.outputs.VERSION }} yourusername/your-app:latest ``` ## 4. Dockerfile Optimalisatie ```dockerfile FROM node:18-alpine as builder WORKDIR /app COPY package*.json ./ RUN npm ci --only=production FROM node:18-alpine WORKDIR /app COPY --from=builder /app/node_modules ./node_modules COPY . . # Metadata labels voor traceerbaarheid LABEL org.label-schema.version="$VERSION" LABEL org.label-schema.vcs-ref="$COMMIT_SHA" LABEL org.label-schema.build-date="$BUILD_DATE" CMD ["node", "server.js"] ``` ## 5. Multi-stage Tagging Strategie ```bash # Gebruik meerdere tags per build docker build -t your-app:$VERSION \ -t your-app:latest \ -t your-app:$(git rev-parse --short HEAD) . ``` ## 6. Versiebeheer Best Practices ### Commit Message Conventies: ``` feat: nieuwe functionaliteit → MINOR versie fix: bug reparatie → PATCH versie BREAKING CHANGE: → MAJOR versie docs: documentatie wijzigingen → geen versie verhoging ``` ### Environment-specifieke tags: ```yaml # docker-compose.yml voorbeeld services: app: image: yourusername/your-app:${APP_VERSION:-stable} environment: - APP_VERSION=${APP_VERSION:-stable} ``` ## 7. Implementatie Checklist - [ ] Semantic versioning beleid definiëren - [ ] Commit message conventies teambreed implementeren - [ ] CI/CD pipeline configureren voor automatische tagging - [ ] Docker Hub repository permissions instellen - [ ] Rollback strategie documenteren - [ ] Environment promotion workflow opzetten (dev → staging → prod) Deze aanpak garandeert consistente versiebeheer across alle omgevingen en maakt effectieve tracking van wijzigingen mogelijk via geautomatiseerde tagging op basis van commit messages.