Inhalt der Doku
github-workflows · Doku
Dockhand Update
Action, die einen Docker-Container über die Dockhand-API mit einem neuen Image aktualisiert und neu startet.
dockhand-update aktualisiert
einen Container über die API von Dockhand. Der Workflow
Node.js Docker CI/CD nutzt sie im Job deploy; du kannst sie auch einzeln einsetzen.
Ablauf
- Lädt alle Umgebungen von
<host>/api/environments. - Sucht die Umgebung nach ihrem Namen, ohne auf Groß- und Kleinschreibung zu achten.
- Ruft
POST /api/containers/<name>/updateauf: Das Image wird neu gezogen und der Container danach gestartet.
Jede Anfrage hat ein Zeitlimit von zwei Minuten. Antwortet Dockhand mit einem Fehler, bricht die Action mit Status und den ersten 500 Zeichen der Antwort ab.
Aufruf
- uses: DasRed/github-workflows/.github/actions/dockhand-update@v1
with:
host: ${{ secrets.DOCKHAND_HOST }}
token: ${{ secrets.DOCKHAND_TOKEN }}
environment: production
container_name: my-container
image: ghcr.io/owner/repo:latestInputs
| Name | Pflicht | Beschreibung |
|---|---|---|
host |
ja | URL des Dockhand-Servers |
token |
ja | API-Token für Dockhand |
environment |
ja | Name der Dockhand-Umgebung |
container_name |
ja | Name des Docker-Containers |
image |
ja | Vollständige Image-Referenz mit Tag |
Hinweis
Die Inputs dieser Action schreiben sich mit Unterstrich (container_name), die des Workflows mit Bindestrich
(container-name).