Files
markusgraf_ch/openspec/changes/simple-deployment/proposal.md
T
gurixandClaude 6af745f579 refactor: rename deployment change to simple-deployment
Rename the OpenSpec change from add-ftps-deployment to simple-deployment
to better reflect the current implementation using rsync over SSH.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-28 16:03:37 +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