This is a command line tool to help you connect to GOV.UK’s infrastructure e.g.
govuk-connect ssh -e integration frontend
With Homebrew on macOS or Linux:
brew tap alphagov/gds # This will exist if you use the gds-cli
brew install govuk-connect
Note: If you previously installed govuk-connect via RubyGems, but
switched to using Homebrew, you may have to do the following to get
it to work:
sudo gem uninstall govuk-connect
sudo gem install govuk-connect
If you use a Ruby version manager like rbenv, you may find this only installs govuk-connect for a particular version of Ruby. Try installing outside of an rbenv-managed directory to fix this e.g. your home directory.
If you have the gds-cli installed (you should do!), you can use this tool within it. This means you only have to use one tool to do AWS and SSH.
gds govuk connect --help
It can be shortened to gds govuk c.
Whichever installation method you choose, you can use the above method or the standalone govuk-connect binary.
1. Release the gem
When you’ve merged the PR that bumps the version (change value in lib/govuk_connect/version.rb),
publish a release tag and the gem to RubyGems from the main branch.
The gem push step is done automatically by the GitHub Action, when you
update the version.rb file.
# Note: You shouldn't need to do this manually. This is done by a GitHub Action
gem build govuk-connect
gem push govuk-connect-<version>.gem # Credentials are in govuk-secrets/pass under packages/rubygems
git tag <version> # eg 0.0.3
git push origin <version>
2. Update Homebrew
To raise a PR to bump the Homebrew formula version, run: