GOV.UK Connect
This is a command line tool to help you connect to GOV.UK's infrastructure e.g.
govuk-connect ssh -e integration frontend
Installation
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 rbenv rehash
With RubyGems:
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.
Usage
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.
Releases
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:
brew bump-formula-pr govuk-connect --url=https://rubygems.org/downloads/govuk-connect-<version>.gem --no-fork
If you have problems with this, note that the password Git asks for to push the changes to GitHub is in fact a Personal Access Token. If you get in a real mess, run
brew update-reset
, and trybrew bump-formula-pr
again. If you really can't do it, consider reopening a previous PR on this topic.