Skip to content

Commit

Permalink
Add a how to guide for how to publish content from Whitehall using GO…
Browse files Browse the repository at this point in the history
…V.UK Docker

This is very similar to the guide for testing finders on GOV.UK Docker, but with some of the steps removed.
  • Loading branch information
ryanb-gds committed Aug 21, 2024
1 parent f6a6c2d commit ea063fb
Showing 1 changed file with 19 additions and 0 deletions.
19 changes: 19 additions & 0 deletions docs/how-tos/publishing-content-on-whitehall.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Publishing Content from Whitehall for Developing Government Frontend

This guide explains how to use GOV.UK Docker to develop features for government frontend, and how to publish content to test your
work with locally. The instructions below assume that you have "made" all of the relevant projects before starting.

1. Start the Whitehall app: `govuk-docker up whitehall-app`
2. Start the government-frontend app: `govuk-docker up government-frontend-app`
3. Create a router backend for government frontend: `curl http://router-api.dev.gov.uk/backends/government-frontend -X PUT \
-H 'Content-type: application/json' \
-d '{"backend": {"backend_url": "http://government-frontend.dev.gov.uk/"}}'`
4. Create a router backend for frontend (this is needed to serve the root taxon created in step 7): `curl http://router-api.dev.gov.uk/backends/frontend -X PUT \
-H 'Content-type: application/json' \
-d '{"backend": {"backend_url": "http://frontend.dev.gov.uk/"}}'`
5. Create a router backend for collections (this is needed to serve the test taxon created in step 8): `curl http://router-api.dev.gov.uk/backends/collections -X PUT \
-H 'Content-type: application/json' \
-d '{"backend": {"backend_url": "http://collections.dev.gov.uk/"}}'`
7. Publish the homepage and root taxon for GOV.UK: `govuk-docker run special-route-publisher-lite rake publish_homepage`
8. Publish a test taxon so that we can tag Whitehall content with it: `govuk-docker run whitehall-app-lite rails taxonomy:populate_end_to_end_test_data`, then `govuk-docker run whitehall-lite rails taxonomy:rebuild_cache`
9. Publish a document. You should be able to access it at `http://government-frontend.dev.gov.uk/{{your_base_path_here}}`

0 comments on commit ea063fb

Please sign in to comment.