Files
markusgraf_ch/openspec/changes/archive/2025-10-30-simple-deployment/proposal.md
T
gurixandClaude adbee2c655 chore: archive completed OpenSpec changes
Archive all 6 deployed changes following OpenSpec workflow:
- add-minimal-hugo-site → hugo-site spec
- add-multilingual-support → internationalization spec
- migrate-site-content → content-migration + image-assets specs
- add-custom-bootstrap-styling → styling spec
- add-cv-page → content-management spec
- simple-deployment → deployment spec

All changes moved to archive/ with 2025-10-30 date prefix.
Created 7 capability specs reflecting deployed functionality.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-30 17:22:03 +01:00

1.1 KiB

Change Proposal: simple-deployment

Why

Currently there is no automated way to deploy the built Hugo site to the production server. Manual file transfers are error-prone and time-consuming. This change adds a deployment script to automate uploads via rsync over SSH, properly mirroring content (including deletions).

What Changes

  • Add deployment script scripts/deploy.sh that syncs public/ directory via rsync
  • Use environment variables SSH_USER, SSH_HOST, SSH_PORT, and REMOTE_ROOT for configuration
  • Implement mirror behavior with --delete flag to remove remote files not present locally
  • Implement prerequisite checks (public/ exists, rsync installed, credentials set)
  • Add error handling and progress reporting
  • Update documentation with deployment instructions

Impact

  • Affected specs: New deployment capability
  • Affected code: New file scripts/deploy.sh
  • Dependencies: Requires rsync to be installed
  • Configuration: User must set SSH_USER and SSH_HOST environment variables
    • SSH_PORT defaults to 22
    • REMOTE_ROOT defaults to /httpsdocs
  • No changes to existing Hugo templates, content, or build process