Skip to main content

Repository: govuk-synthetic-test-app

Synthetic test app used to run Ginkgo tests to test aspects of the GOV.UK infrastructure

Ownership
#govuk-platform-engineering owns the repo. #govuk-platform-support receives automated alerts for this repo.
Category
Utilities

README

This is a synthetic test app used to run Ginkgo tests to test aspects of the GOV.UK infrastructure.

Deploying the tests on EKS

To deploy the tests you will need to merge in your changes to the main branch and then update the image tag in the govuk-helm-charts repo to the latest release.

NOTE - the image will not appear in ECR until the image_tag is updated in govuk-helm-charts and the synthetic test cronjob pulls the image when it runs.

Running Ginkgo tests locally

NOTE - at the moment the tests only work when deployed on to an EKS cluster as it is using the synthetic-test-assumer role.

The image tag in the manifest is the most recent build generated by a merge into main or a manual trigger of the build-runner workflow in github actions. You can set it to latest to always use the latest build or target a specific release from the list of packages available.

The following commands target integration, replace integration with staging / production to target those environments.

  • Before running the tests please ensure that the correct kubectl context is set, eg

kubectl config use-context govuk-integration

  • To get the tests running you will need to apply this manifest

gds aws govuk-integration-platformengineer -- kubectl apply -f ./govuk-synthetic-test-app.yaml -n apps

  • To see the results of the tests you can run this kubectl command

gds aws govuk-integration-platformengineer -- kubectl logs govuk-synthetic-test-app-runner -n apps

  • To delete the pod after the tests have completed run this kubectl command

gds aws govuk-integration-platformengineer -- kubectl delete -f ./govuk-synthetic-test-app.yaml -n apps