Skip to content

Create redirect app for prototype kit training site #1275

Closed
@lfdebrux

Description

@lfdebrux

What

Create a simple web page that lives at https://prototype-kit-training.cloudapps.digital and directs users to https://govuk-prototype-kit.herokuapp.com/docs/tutorials-and-examples.

Why

We have migrated the content from the prototype-kit-training app to the main prototype kit docs site, and we want to be able to archive the code that creates and deploys that app (#1175), but to be able to do that we need to tell users who may have bookmarked the training URL what happened to the content they used to have access to.

We could do this with a simple 301 Moved Permanently redirect, but after discussing with @joelanman we agreed that a sentence or paragraph explaining to users what has happened might be more useful to them.

Who needs to do this

  • Developer to make redirect app
  • Content designer and developer to pair on content

Who needs to review this

  • PM

Done when

Activity

added
🕔 HoursA well understood issue which we expect to take less than a day to resolve.
on Apr 1, 2022
lfdebrux

lfdebrux commented on Apr 1, 2022

@lfdebrux
MemberAuthor

We can use the govuk-design-system-redirect app as a starting point for the app code; I've already made a start on this at https://github.com/alphagov/prototype-kit-training-redirect, it just needs the redirect directive in the nginx config to be replaced with a reference to a HTML file with the desired content.

That content may or may not be styled with GOV.UK Frontend styles (I'd argue for not, because it makes maintenance much easier), but either way should be a single HTML file in the app root.

We can probably just deploy once to PaaS by hand, and then forget about it, as the use of the nginx buildpack makes the security of the site mostly their problem 😅

lfdebrux

lfdebrux commented on May 4, 2022

@lfdebrux
MemberAuthor
lfdebrux

lfdebrux commented on May 9, 2022

@lfdebrux
MemberAuthor

I've just deployed alphagov/prototype-kit-training-redirect to PaaS, at the URL https://prototype-kit-training.cloudapps.digital.

I did this by logging in with the prototype-kit-docs account, and running the following commands in the repo:

cf push -f manifest.yaml -i 1
cf map-route prototype-kit-training-redirect cloudapps.digital --hostname prototype-kit-training
cf stop prototype-kit-training

This means that the redirect app has replaced the documentation app, and all future requests will be served by the redirect app. Deleting the documentation app will be done as part of #1175.

If for some reason the redirect app needs to be updated in future, a simple cf push will be all that is needed (as long as the app is not deleted).

lfdebrux

lfdebrux commented on May 9, 2022

@lfdebrux
MemberAuthor

I'm putting a note in the credentials repo linking back to this issue, so any devs wondering about this app might find there way here and to my notes.

lfdebrux

lfdebrux commented on May 9, 2022

@lfdebrux
MemberAuthor

Calling this done.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

🕔 HoursA well understood issue which we expect to take less than a day to resolve.

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions

    Create redirect app for prototype kit training site · Issue #1275 · alphagov/govuk-prototype-kit