源文件:06-test-site-node.v4.sohophp.app.md

# 06. Test Site: node.v4.sohophp.app

This document records the live reference site used to validate the toolkit.

# Site identity

  • domain: node.v4.sohophp.app
  • Node version: 22
  • selected port: 22101
  • repo: /srv/git/node.v4.sohophp.app
  • site root: /var/www/node22/node.v4.sohophp.app
  • service: node-site@node.v4.sohophp.app.service

# Files

  • env metadata: /etc/node-sites/node.v4.sohophp.app.env
  • nginx vhost: /etc/nginx/conf.d/node.v4.sohophp.app.conf
  • shared env: /var/www/node22/node.v4.sohophp.app/shared/.env.local
  • certificate live path: /etc/letsencrypt/live/node.v4.sohophp.app/

# Verified behavior

The site has been verified to return:

  • Node version v22.22.3
  • release cwd under releases/<timestamp>
  • shared env value SITE_GREETING=hello-from-shared-env-v1
  • APP_URL=https://node.v4.sohophp.app

# Example local checks


curl -fsS http://127.0.0.1:22101/healthz


curl -fsS https://node.v4.sohophp.app/healthz


systemctl status node-site@node.v4.sohophp.app.service --no-pager


# Example deploy command used successfully


sudo -u cicd sudo -n /usr/local/bin/cicd-deploy-node-site \


  --domain node.v4.sohophp.app \


  --healthcheck-expect 'hello-from-shared-env-v1'


# Example env initialization used successfully


sudo /usr/local/bin/init-node-shared-env \


  --domain node.v4.sohophp.app \


  --file .env.local \


  --force \


  --set SITE_GREETING=hello-from-shared-env-v1 \


  --set FEATURE_FLAG=enabled


# Why this site matters

It proves the following chain works end-to-end:

  • repo checkout
  • release deploy
  • shared env linking
  • build env loading
  • runtime env loading
  • fnm version selection
  • systemd startup
  • Nginx reverse proxy
  • HTTPS
  • cicd-triggered deployment