Posts

Showing posts with the label gitlab

How to build a documentation portal with MkDocs and GitLab Pages

I wrote detailed documentation for the popular openvpn-install script — covering everything from quick start to script internals. Here's how I built the documentation portal using MkDocs Material, GitLab Pages, and CI/CD with pinned dependencies. The result is a fast, versioned, searchable documentation site with dark mode, code highlighting, Mermaid diagrams, and zero backend. Every push to main triggers an automatic build and deploy.

GitLab Runner: Cache adapter could not be initialized: missing S3 configuration

Sometimes GitLab Runner cache stops working after upgrading. Example here with gitlab-runner 12.0.1 .