Deploying Fastly VCL Snippets
We have the ability to add Fastly regular VCL snippets in code at https://github.com/guardian/support-frontend/tree/main/support-frontend/conf/fastly-snippets, and deploy via a Github action.
The action is named "Deploy Fastly Snippets". Note: There are 2 actions named "Deploy Fastly Snippets", one is deprecated and has been manually deployed, the active one can be accessed here.
The action's process is the standard Fastly process that we currently do via the Fastly console:
- Find the service's active version
- Clone this version
- Copy the snippet to that version
- Active that version
- Lock that version
- Commit your VCL snippets to a branch.
- Open the Deploy Fastly Snippets Github Action.
- Select the "Run worklflow" drop down, this will open a dialog. In this dialog you should be able to select your branch and the environment you wish to deploy to.
- There are 2 checkboxes in this dialog, we recommend you select both, however they can be unchecked if desired:
- Delete all Fastly snippets before deploying: Checking this ensures all snippets used are present in the repo, any snippet not in the repo will be removed if this is checked.
- Lock and activate the service version after snippets are deployed: Checking this will create a new version of the Fastly config and deploy it, leave this unchecked if you want to create a draft version in Fastly so you can check the draft before deployment.
- Click the "Run workflow" button, refresh the page to see your workflow run at the top of the page. Once complete your change should be ready to test.