Platform.sh User Documentation

Ibexa DXP with Fastly

Upsun Beta

Access our newest offering - Upsun!

Get your free trial by clicking the link below.

Get your Upsun free trial

Ibexa DXP is a “commercial extended” version of Ibexa OSS that includes, among other things, support for push-based purging on the Fastly CDN.

Remove Varnish configuration Anchor to this heading

In Ibexa DXP, Varnish is enabled by default when deploying on Platform.sh To use Fastly, Varnish must be disabled:

 "https://{default}/":
     type: upstream
-     upstream: "varnish:http"
+     upstream: "app:http"

Setting up Ibexa DXP to use Fastly Anchor to this heading

Ibexa DXP’s documentation includes instructions on how to configure Ibexa DXP for Fastly. Follow the steps there to prepare Ibexa DXP for Fastly.

Set credentials Anchor to this heading

The best way to provide the Fastly credentials and configuration to Ibexa DXP on Platform.sh is via environment variables. That way private credentials are never stored in Git.

Using the CLI, run the following commands to set the configuration on your production environment (assumed to be main below, but change it to fit your setup). (Note that they inherit to all other environments by default unless overridden.)

platform variable:create -e main --level environment env:HTTPCACHE_PURGE_TYPE --value 'fastly'
platform variable:create -e main --level environment env:FASTLY_SERVICE_ID --value 'YOUR_ID_HERE'
platform variable:create -e main --level environment env:FASTLY_KEY --value 'YOUR_ID_HERE'

Replacing YOUR_ID_HERE with the Fastly Service ID and Key obtained from Fastly.

Note: On a Dedicated Gen 2 cluster, set those values on the production branch:

platform variable:set -e production env:HTTPCACHE_PURGE_TYPE fastly
platform variable:set -e production env:FASTLY_SERVICE_ID YOUR_ID_HERE
platform variable:set -e production env:FASTLY_KEY YOUR_ID_HERE

Setup the correct VCL files Anchor to this heading

There are two VCL files provided as starting points for using Fastly with Ibexa DXP; you can find them in vendor/ibexa/fastly/fastly/ez_*.vcl. A VCL snippet can be found in vendor/ibexa/fastly/fastly/snippet_re_enable_shielding.vcl. They handle varying cache by user context hash (permissions) as well as several other needs by Ibexa DXP and it’s underlying HttpCache system.

Configure Fastly Anchor to this heading

See the alternate Go-live process for Fastly on Platform.sh. This process is the same for any application.

Is this page helpful?