Skip to content

Document SSH connection multiplexing for production access#115

Merged
jasperf merged 1 commit into
mainfrom
add/ssh-connection-multiplexing
Jul 4, 2026
Merged

Document SSH connection multiplexing for production access#115
jasperf merged 1 commit into
mainfrom
add/ssh-connection-multiplexing

Conversation

@jasperf

@jasperf jasperf commented Jul 4, 2026

Copy link
Copy Markdown
Contributor

This documentation update introduces SSH connection multiplexing guidance to speed up repeated SSH and Ansible operations against production servers within Trellis workflows. It adds a new section to trellis/provision/PROJECT-SETUP.md explaining how to configure ControlMaster/ControlPersist settings in ~/.ssh/config so that subsequent connections reuse an existing authenticated session instead of renegotiating the SSH handshake each time. The CHANGELOG.md is updated to record this documentation addition. This change is purely additive documentation with no impact on existing scripts, playbooks, or automation behavior.

Documentation and Developer Guidance:

  • Added a new SSH connection multiplexing section to PROJECT-SETUP.md, describing the ControlMaster auto, ControlPath, and ControlPersist SSH config directives and their effect on connection reuse.
  • Explained the practical benefit for Trellis operators: faster repeated trellis commands and Ansible playbook runs against production hosts by avoiding redundant SSH handshakes.
  • Updated CHANGELOG.md to reflect the new documentation entry, keeping the change log aligned with recent additions to the provisioning guide.

Files Changed:

Repeat SSH sessions to production (log checks, WP-CLI, fail2ban
lookups) were paying full handshake cost each time. ControlMaster/
ControlPersist reuses an authenticated socket per remote user instead.
@jasperf jasperf merged commit 02a2187 into main Jul 4, 2026
@jasperf jasperf deleted the add/ssh-connection-multiplexing branch July 8, 2026 04:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant