Skip to content
HCSTech Docs

GitLab-to-Docker deployment

HCSTech Docs uses GitLab as the source of truth. Its CI/CD runner builds the static Starlight site and transfers the output to a Docker host over SSH.

Architecture

Section titled “Architecture”
Text | Deployment flow
GitLab repository
    ↓
GitLab Runner (Node.js build)
    ↓  SSH upload, no stored CI artifacts
Webhost VM (/opt/webhost/docs)
    ↓
Docker container: docs-site (Nginx)
    ↓
Nginx Proxy Manager
    ↓
https://docs.hcstech.se

Important choices

Section titled “Important choices”
Component Purpose
package-lock.json Reproducible dependencies
npm ci Deterministic clean installs
GitLab CI/CD variables SSH deployment credentials
docs-site container Serves static pages
webhost-proxy Shared Docker network used by NPM
nuke-production Manual docs-only removal

Recovery

Section titled “Recovery”

A new compatible webhost can be provisioned using the Git repository, Docker/Compose, the shared network, and the documented SSH/NPM/DNS configuration. Previous build outputs are not required.