How this site is deployed

The guide is the app apps/guide. Pages are Markdown. VitePress builds static files, and nginx serves them in the cluster.

Address: https://guide.progspace.ru.

Locally

From the repository root:

nx serve guide

Dev server: http://127.0.0.1:9040

Build:

nx build guide

Output: apps/guide/.vitepress/dist. apps/guide is not in the root yarn workspaces. Its dependencies are installed with npm ci inside the folder.

A new page

1. Add a Markdown file under apps/guide.
2. Add a sidebar link in apps/guide/.vitepress/config.mts. If it is an app in the catalog, add a row to apps/guide/apps/index.md.
3. Answer three questions: what it is, what it is for, and how to use it. Copy button labels from the app screen.

Production

Image	$CI_REGISTRY_IMAGE/guide
Build	GitLab job build:docker:guide
Deploy	GitLab job deploy:production:guide (manual)
Deployment	guide-app in namespace angular-app
Service	guide-service:80
Ingress	guide.progspace.ru
Certificate	angular-tls-apps, name guide.progspace.ru

The first deploy adds the name to the certificate angular-tls-apps. cert-manager orders a certificate and replaces the Secret only after it is issued. Until then, the current certificate for learn, legato, and games stays in place.

DNS: guide.progspace.ru must point at the same entry as the other subdomains. If the zone is covered by *.progspace.ru, no extra record is needed.