Ich habe bisher Projekte, aus denen ein Webdienst wurde immer von Hand auf den entsprechenden Docker-Server deployt. Das musste anders werden, daher habe ich mich entschieden, eine entsprechende CI/CD-Pipeline in Gitlab zu bauen, die das für mich erledigt.

Das musste ich natürlich nicht selbst erfinden - ich konnte mich wieder einmal auf die Schultern von Riesen stellen, die das bereits im Internet dokumentiert hatten. Bei mir kam lediglich die Besonderheit dazu, dass ich immer noch den gitlab-runner benutze. Die entsprechenden Links, die mir dabei geholfen, haben gibt es wie gewohnt am Ende dieses Artikels.

Zum Test habe ich mir ein kleinstmögliches Projekt hergenommen und dieses um CI/CD ergänzt. Im Prinzip ist dafür nur ein Skript nötig, das alles Notwendige per SSH auf dem Ziel-Dockerserver ausführt:

#!/bin/bash

SSH_USERNAME=deploy
SSH_HOSTNAME=dockerhost.docker.lab
REPO_URL=https://gitlab.fritz.box/elbosso/
SSH_PROJECT_FOLDER=docker-sample-nginx

DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"

(
  cd "$DIR/.." # Go to project dir.

  ssh $SSH_USERNAME@$SSH_HOSTNAME -o StrictHostKeyChecking=no <<-EOF
    if [ ! -d "$SSH_PROJECT_FOLDER" ]; then
      git clone "$REPO_URL/${SSH_PROJECT_FOLDER}.git"
    fi
    cd $SSH_PROJECT_FOLDER
    git pull
    docker-compose down
    docker-compose -f docker-compose.yml up --build -d
EOF
)

In meinem Fall musste ich auf dem Dockerserver noch dafür sorgen, dass git von meinen selbst erstellten Zertifikaten nicht verschreckt wurde. Um die Sicherheit des Dockerservers nicht allzusehr zu kompromittieren legte ich dafür ein eigenes Nutzerkonto an, dem ich das Recht einräumte, die Docker-API nutzen zu können - dadurch konnte dieses Konto auch docker-compose ausführen.

Die minimale .gitlab-ci.yml Datei sieht wie folgt aus:

stages:
    - deploy

docker-compose:
  stage: deploy
  script:
    - /bin/bash ci/deploy.sh

Man kann die Variablen natürlich aus dem Bash-Skript herausnehmen und hier deklarieren - das ist Geschmackssache.

Und hier nun die versprochenen Links:

Links