Application: transition

Managing redirects for sites moving to GOV.UK.

• GitHub: transition
• Ownership: #govuk-content-apis owns the repo. #govuk-content-apis-system-alerts receives automated alerts for this repo.
• Category: Transition apps
• Links:
  • transition.publishing.service.gov.uk
  • Sentry (error tracking)
  • App dashboard: request rates, errors, durations
  • Kibana App Logs (Production, last 3 hours)
  • Kibana Worker Logs (Production, last 3 hours)
  • Argo CD (transition)

Relevant manual pages

• Configure transition mappings for a site
• Request Fastly TLS certificate
• Transition a site to GOV.UK
• Transition architecture

README

Rails app for managing the transition of websites to GOV.UK. Specifically, it’s for adding and deleting sites, hostnames, and mappings for use with Bouncer.

Technical documentation

This is a Ruby on Rails app, and should follow our Rails app conventions.

You can use the GOV.UK Docker environment to run the application and its tests with all the necessary dependencies. Follow the usage instructions to get started.

Use GOV.UK Docker to run any commands that follow.

Relationship with Bouncer

Bouncer and Transition currently share a database. As a result, we aim to keep a few of their dependencies in sync (on the same version), namely:

• rails (Transition) and activerecord (Bouncer)
• optic14n

Running the tests

bundle exec rake

Running the worker

bundle exec sidekiq -C config/sidekiq.yml

Style guide

Available at /style, the guide documents how transition is using bootstrap, where the app has diverged from default styles and any custom styles needed to fill in the gaps.

Adding a new site

Follow the instructions in the GOV.UK Developer docs

Example application URLs

• https://transition.staging.publishing.service.gov.uk/
• https://transition.staging.publishing.service.gov.uk/organisations/air-accidents-investigation-branch
• https://transition.staging.publishing.service.gov.uk/sites/aaib
• https://transition.staging.publishing.service.gov.uk/sites/aaib/mappings/939694/edit
• https://transition.staging.publishing.service.gov.uk/sites/aaib/mappings/bulk_add_batches/new
• https://transition.staging.publishing.service.gov.uk/sites/aaib/mappings/import_batches/new
• https://transition.staging.publishing.service.gov.uk/sites/aaib/hits/summary

Glossary of terms

A glossary of the terms used can be found in this blog post.

Licence

MIT License