GOV.UK
Manual
Common tasks
- Deploy an application to GOV.UK
- Deploy emergency publishing banners
- Purge a page from cache
- Reboot a machine
- Run a rake task
- Useful Kibana queries
2nd line
- Before you start on 2nd line
- Incident management guidance
- Raising issues with Reliability Engineering
- Removing a user from Puppet
- So, you're having an incident
- Welcome to 2nd line
- Working on 2nd line
- Write an incident report
Assets
- Assets: how they work
- Redirect a Whitehall asset URL
- Remove an asset
- Rescan an "infected" file in Whitehall
- Upload an asset to asset-manager
- Upload an asset to whitehall
AWS
- Backup and restore databases in AWS RDS
- Deploying Terraform
- GOV.UK in AWS
- Seeing things in the AWS Console
- SSH into AWS machines
- Stacks in AWS
- User Management in AWS
Backups
- Attachment backups
- Backup and restore Elasticsearch indices
- MongoDB backups
- MySQL backups
- PostgreSQL backups
- Replaying traffic to correct an out-of-sync search index
- Restore from offsite backups
- Rotate offsite backup GPG keys
Basics
CDN & Caching
- Cookies and sessions in GOV.UK frontend apps
- Our content delivery network (CDN)
- Purge a page from cache
data.gov.uk
- Architecture of data.gov.uk
- Deployments for data.gov.uk
- Monitoring for data.gov.uk
- Operation of data.gov.uk
- Supporting CKAN
Databases
- Clone a MySQL instance from one slave to another
- Resync a MongoDB database
- Resync a PostgreSQL standby
- Upgrade MySQL in production and staging
- Use database GUI tools
Dependencies
Deployment
- Block apps from being deployed
- Deploy an application to GOV.UK
- Deploy fixes for a security vulnerability
- Deploy Puppet
- Deploy when GitHub is unavailable
- Fall back to the static mirrors
- Handle encrypted hieradata
- Monitor your app during deployment
- Restart an application
- Run a rake task
- Set up Heroku review apps for pull requests
- Switch an app off
Development & Reviews
Development VM
- Can't connect to Elasticsearch in VM
- Can't connect to Mongo in VM
- Content store times out in VM
- Fix issues with vagrant-dns
- Fix low disk space in development
- Fix NFS errors in VM
- Increase RAM on the VM
- Problems fetching packages in VM
- Replicate application data locally for development
- Run an application in the VM
- Send a test email via Notify
- SSH into GOV.UK servers from the VM
- SSH into your VM directly
- Unable to mount VirtualBox shared folders
- Using `bowl` fails with bundler error
DNS
Emails
- Email notifications: how they work
- Manage email subscribers (change email, unsubscribe, move lists)
- Receiving emails from Email Alert API in integration and staging
- Stop all email subscription sending
- Test email sending
Environments
- Add a disk to a vCloud machine
- Create a new environment for GOV.UK
- Generate a Certificate Signing Request (CSR) for GOV.UK
- GOV.UK's environments (integration, staging, production)
- Move apps between servers
- Reboot a machine
- Remove a machine
- Reprovision a machine in vCloud Director
- Set up a new mirror for GOV.UK
- Update Pingdom IP ranges
Frontend
Logging
- How logging works on GOV.UK
- How to use Logit for GOV.UK
- Set up request tracing
- Useful Kibana queries
Manual
- Documentation style guide
- Monitor docs traffic
- Review a page in this manual
- Where to find what documentation
Monitoring
- Add an Icinga passive check to a Jenkins job
- Add sidekiq-monitoring to your application
- Error reporting with Sentry
- GOV.UK and Virtual Private Networks (VPNs)
- How to deal with errors
- Metrics
- Monitor Sidekiq queues for your application
- Nagios NRPE connection failures
- Pingdom Bouncer canary check
- Uptime Metrics
Packaging
- Add a deployment dashboard for an application
- Create a new open source project for ops
- Debian packaging
- Name a new application or gem
- Packer Vagrant Dev VM / Image Creation
- Publish to Puppet Forge
- Retire an application
- Set up a new Rails app
- Upgrade Rails to a new version
Patterns & Style Guides
- Lint your Ruby code with govuk-lint
- Publish a Ruby gem
- READMEs for GOV.UK applications
- Test Ruby projects
Publishing
- Content that doesn't show up correctly in search or list pages
- Deploy emergency publishing banners
- Fix blank options in finder filters
- How the draft stack works
- Make a new document type available to search
- Reindex an Elasticsearch index
- Rename a country
- Topic Taxonomy
- Upload HMRC PAYE files
Routing
- Change an organisation's slug
- Check for a `gone` route
- Edit an existing route in the Router
- Redirect a route
Support
- Create a GPG key
- Manage product support tickets (Zendesk)
- Manage Signon accounts
- Out of hours support (on-call)
- Who do I ask for support?
Testing
- End to end testing publishing apps
- Get access to CI (Jenkins)
- Jenkins CI infrastructure
- Patch Jenkins
- Smoke testing with smokey
- Test & build a project on Jenkins CI
- Troubleshooting CI Jenkins Performance
Tools
- Access apps on the shared Heroku account
- Add a new document type
- Add a new Ruby version
- Configure a GitHub repo
- GitHub Enterprise
- Give a content designer access to GitHub
- Graphite and deployment dashboards
- How we use GitHub
- Monitoring screens
- Pact Broker
- RabbitMQ
- Run an A/B or multivariate test
- Sidekiq
- SSH Configuration
- Tools: Icinga, Grafana and Graphite, Kibana and Fabric
- Update Hubot (Slack bot)
Transition
- Transition a site to GOV.UK
- Transition architecture
- Use the side-by-side browser
- Whitelist site to allow redirection away from GOV.UK