Manual
Common tasks
How to...
- Create a Local Transaction
- Deploy an emergency banner
- Deploy non-emergency global banner
- Post a message on the status page
- Purge a page from cache
- Query Kibana (includes useful queries)
- Reboot a machine
- Run a rake task
Learn
- Node classes without redundancy
- Responsibilities of a Tech Lead
- What is GOV.UK Notify Emergency Alerts?
2nd line
How to...
- Add an HMRC Manual
- Change in-hours time period for daylight savings
- How to flush the ARP cache
- Identify an EC2 instance in AWS
- Incorrect postcode data
- Raise issues with Reliability Engineering
- SmartSurvey scheduled maintenance
- Update popular links
Learn
- 2nd line
- 2nd line drills
- Access to Licensify for Third Parties
- Licensify - supporting licensing
- Out of hours support (on-call)
- PagerDuty
- Rules for getting production access
- Scale unicorn workers
- Subject Access Request (SAR)
- Zendesk
A/B testing
How to...
Learn
Accounts
How to...
- Access apps on the shared Heroku account
- Create a GPG key
- Get access to Jenkins
- Give a content designer access to GitHub
- Manage Signon user/API accounts and access tokens
- Remove a user from Puppet
Applications
How to...
- Add authentication to an application
- Application ownership
- Create a Local Transaction
- Name a new application or gem
- Retire a gem
- Retire an application
- Set up a new Rails application
Learn
- Architectural deep-dive of GOV.UK
- Architectural summary of GOV.UK
- Architecture overview of GOV.UK applications
- Configure linting
- Conventions for Rails applications
- Node classes without redundancy
Assets
How to...
Learn
AWS
How to...
Learn
- AWS IAM Key Rotation
- Common AWS tasks for Technical 2nd Line
- How to raise a support ticket with AWS
- Migration to AWS
Backups
How to...
- Backup and restore databases in AWS RDS
- Backup and restore Elasticsearch indices
- Fix out-of-date search indices
- Restore an Individual Postgres Production Database in AWS RDS
Learn
CDN & Caching
How to...
Learn
Cookies
Learn
data.gov.uk
How to...
- Common 2nd line support tasks for data.gov.uk and CKAN
- Deployments for data.gov.uk
- Operation of data.gov.uk
Learn
Databases
How to...
Dependencies
How to...
Learn
Deployment
How to...
- Deploy Puppet
- Deploy Static
- Deploy Terraform
- Deploy when GitHub is unavailable
- Deployment dashboards
- Fall back to AWS CloudFront
- GOV.UK CDN static mirrors
- Handle encrypted hieradata
- Publish special routes
- Restart an application
- Run a rake task
- Set up Heroku review apps for pull requests
- Switch an app off temporarily
Learn
Docker
Learn
Documentation
How to...
Learn
Emails
How to...
Learn
Frontend
How to...
- Deploy a banner to certain pages
- How to remove jQuery from JavaScript
- How to test with Assistiv Labs
- Track frontend performance with SpeedCurve
Learn
- Analytics on GOV.UK
- Find a rails template based on a GOV.UK URL or vice verca
- Frontend architecture
- Google Tag Manager change process
- Guidance and tools for digital accessibility
- Local frontend development
- The component system
- Which browsers we support
GitHub
How to...
- Configure a GitHub repo
- How to switch a Git default branch from master to main
- Make a GitHub repo private
- Merge a Pull Request
Learn
GOV.UK Account
Learn
Incidents
How to...
Learn
Infrastructure
How to...
- Add a new Ruby version
- Databases on GOV.UK
- Generate a Certificate Signing Request (CSR) for GOV.UK
- Manage AmazonMQ
- Manage RabbitMQ
- Manually resize ASGs (auto scaling groups)
- Manually resize EBSs (elastic block store)
- Move apps between servers
- Patch Jenkins
- Provision machines for data science research
- Reboot a machine
- Remove a machine
- Renew a TLS certificate for GOV.UK
- Reprovision a machine
- Unable to SSH into a machine
Learn
- Domain Name System (DNS) records
- GOV.UK and Virtual Private Networks (VPNs)
- GOV.UK's environments (integration, staging, production)
- Load Testing
- New instances fail to provision
- Rate Limiting
- Rollback Puppet if Jenkins is broken
- Upgrade Terraform
Learning GOV.UK
How to...
Learn
- Dictionary of concepts on GOV.UK
- How to be a good buddy
- Responsibilities of a Tech Lead
- Where to find what documentation
Logging
How to...
Learn
Monitoring
How to...
- Add an Icinga passive check to a Jenkins job
- Debug Nagios NRPE connection failures
- Debug underperforming search
- How we handle errors
- Pingdom
- Use Nagstamon for monitoring Icinga
Learn
- Environment data sync
- Grafana
- Graphite and deployment dashboards
- Icinga
- Metrics
- Pingdom Bouncer canary check
- Screens that we have in the office
- Sentry
- Sidekiq
- Tools: Icinga, Grafana and Graphite, Kibana and friends
- Uptime Metrics
Notify Emergency Alerts
How to...
Learn
PaaS
How to...
Packaging
How to...
Publishing
How to...
- Add a new document type
- Add an organisation's brand colour
- Add Historical Accounts
- Add support for a new translation in Whitehall
- Change a slug and create redirect in Whitehall
- Change a specialist document base path
- Content that doesn't show up correctly in search or list pages
- Debug published documents with incorrect links
- Deploy an emergency banner
- Deploy non-emergency global banner
- Find hardcoded markup in GovSpeak
- Help with publishing content
- If documents aren't live after being published
- Make a new document type available to search
- Modify a change note in Publishing API, Content Publisher or Whitehall
- Redirect an HTML attachment's URL in Whitehall
- Reindex an Elasticsearch index
- Remove a change note
- Remove invalid WorldwideOrganisation draft CorporateInformationPages
- Rename a country
- Republish content
- Support government changes
- Upload HMRC PAYE files
Learn
- How the draft stack works
- How the topic taxonomy works
- How the world taxonomy works
- Related links
- What data we expose as schema.org structured data
Routing
How to...
- Change an organisation's slug
- Check for a 'gone' route
- Edit an existing route in the Router
- Redirect a route
Security
How to...
- Block access to arbitrary URLs in the GOV.UK estate
- Content Security Policy on GOV.UK
- Pentests
- Web Application Firewall (WAF) configuration
Services
How to...
Team tools
Learn
Testing
How to...
- Test & build a project on Jenkins CI
- Test & build a project with GitHub Actions
- Troubleshoot CI Jenkins Performance