Add SSH deployment support with release management

[Soner (shyim)]

Summary

This PR adds comprehensive SSH-based deployment capabilities to the CLI, enabling users to deploy Shopware projects to remote servers using a releases/shared directory layout with atomic symlink switching, similar to Deployer (deployer.org).

Key Changes

New Deployment Infrastructure

• internal/deployment/ - New package providing deployment abstraction:
  • deployment.go - Core Deployer interface and types (Release, HostReleases, Options)
  • ssh_deployer.go - SSH-based deployer implementing releases/shared/current symlink pattern
  • ssh_connection.go - SSH connection wrapper using system ssh client
  • connection.go - Connection interface for testability
  • archive.go - Project archiving with configurable exclusions
  • Comprehensive test coverage for all deployment scenarios

SSH Command Building

• internal/sshcmd/ - New package for SSH client command construction:
  • sshcmd.go - Builds SSH arguments from environment config with ControlMaster multiplexing support
  • Handles authentication (keys, passwords, SSH agent), host key verification, and connection pooling
  • Shares multiplexed connections between deployments and remote command execution

Remote Command Execution

• internal/executor/ssh.go - New SSH executor for running commands on deployed releases:
  • Executes console, composer, PHP, and npm commands on the remote current symlink
  • Supports TTY allocation for interactive commands
  • Integrates with SSH multiplexing for efficient connection reuse

Configuration Schema

• internal/shop/config.go - Extended EnvironmentConfig with:
  • EnvironmentSSH - SSH connection settings (host, port, user, authentication, known_hosts, ControlMaster control)
  • EnvironmentDeployment - Deployment configuration (path, keep_releases, shared files/dirs, hooks)
  • EnvironmentDeploymentHooks - Build, pre-switch, and post-switch hooks
  • Multi-host support for deployments across multiple servers

CLI Commands

• cmd/project/project_deploy.go - Main deploy command
• cmd/project/project_deploy_releases.go - List releases on target
• cmd/project/project_deploy_rollback.go - Rollback to previous release
• cmd/project/project_console.go - Enhanced to support SSH environments with flag stripping

Utilities

• internal/shell/quote.go - POSIX shell quoting for safe command construction
• internal/executor/factory.go - Extended to support SSH executor type

Notable Implementation Details

• Atomic Symlink Switching: Uses ln -sfn + mv -fT for atomic current symlink updates, preventing partial deployments
• Shared Path Management: Automatically seeds shared directories/files from first release, then maintains symlinks across deployments
• Multi-Host Deployments: Uploads happen in parallel, but hooks and symlink switching are sequential to prevent concurrent database operations
• Connection Multiplexing: All SSH operations share one ControlMaster connection per host for efficiency
• Deployment Helper Integration: Auto-detects and runs shopware-deployment-helper when present and no pre-switch hooks are configured
• Release Cleanup: Configurable retention (default 5 releases) with automatic cleanup of old releases
• Bad Release Marking: Rollbacks mark the previous release as "bad" to skip it in future rollbacks
• Graceful Degradation: Cleanup failures are logged as warnings but don't abort deployments

Configuration Example

environments:
  production:
    type: ssh
    ssh:
      host: shop.example.com
      port: 2222
      user: deploy
      identity_file: ~/.ssh/id_ed25519
    deployment:
      path: /var/www/shopware
      keep_releases: 3
      hooks:
        build:
          - shopware-cli project ci .
        pre_switch:
          - vendor/bin/shopware-deployment-helper run
        post

https://claude.ai/code/session_01Ev2G1VYZ3kkAzJ3cCeGZtZ