michaelschiemer/deployment/gitea-runner/BUILD_ON_PRODUCTION.md

CI Image auf Produktionsserver bauen

Problem

Der Gitea Runner auf dem Produktionsserver versucht, das php-ci:latest Image zu pullen, aber es existiert nicht in der Registry oder lokal. Der Fehler lautet:

Error response from daemon: pull access denied for php-ci, repository does not exist or may require 'docker login'

Lösung: Image direkt auf dem Produktionsserver bauen

Schritt 1: Auf den Produktionsserver verbinden

ssh user@production-server

Schritt 2: Zum Projektverzeichnis wechseln

cd /path/to/michaelschiemer

Schritt 3: CI Image bauen

cd deployment/gitea-runner
./build-ci-image-production.sh

Das Script:

• Baut das php-ci:latest Image
• Baut das docker-build:latest Image
• Lädt beide Images in den gitea-runner-dind Container

Schritt 4: Verifikation

1. Prüfe ob Images gebaut wurden:

   docker images | grep -E "php-ci|docker-build"
   

2. Prüfe ob Images in docker-dind geladen wurden:

   docker exec gitea-runner-dind docker images | grep -E "php-ci|docker-build"
   

3. Prüfe Runner Labels in Gitea UI:

   • Gehe zu: https://git.michaelschiemer.de/admin/actions/runners
   • Der Runner sollte das php-ci Label zeigen

4. Teste einen Workflow:

   • Ein Workflow mit runs-on: php-ci sollte jetzt funktionieren

Alternative: Ansible Playbook verwenden

Falls Ansible auf dem Produktionsserver verfügbar ist:

cd deployment/ansible
ansible-playbook -i inventory/production.yml \
  playbooks/setup-gitea-runner-ci.yml \
  -e "project_root=/path/to/michaelschiemer"

Troubleshooting

Image wird nicht in docker-dind gefunden:

• Stelle sicher, dass gitea-runner-dind läuft: docker ps | grep docker-dind
• Lade das Image manuell: docker save php-ci:latest | docker exec -i gitea-runner-dind docker load

Runner zeigt php-ci Label nicht:

• Labels können nur bei der Registration geändert werden
• Runner neu registrieren:

  cd deployment/gitea-runner
  ./unregister.sh
  ./register.sh
  

Build schlägt fehl:

• Prüfe Docker-Logs: docker logs gitea-runner-dind
• Stelle sicher, dass genug Speicherplatz vorhanden ist: df -h
• Prüfe Docker-Daemon: docker info

Hinweise

• Das Image ist ca. 1.85GB groß - der Build kann einige Minuten dauern
• Stelle sicher, dass genug Speicherplatz auf dem Server vorhanden ist
• Das Image wird lokal gebaut und muss nicht in die Registry gepusht werden (wird direkt in docker-dind geladen)

Workflow test - deployment path change