14-override-default-configuration.md

Overriding default configuration

Tired of pointing your facia.stage at CODE? Have you ever longed to change the content.api.host you use for development? Need to change some switches in DEV? Look no further!

How-to

1. Create a file at ~/.gu/frontend.conf

2. Add your configuration with the following syntax:

    devOverrides {
      key1.name=value1
      key2.name=value2
    }
   

   E.g.

    devOverrides {
      switches.key=DEV/config/switches-yournamehere.properties
      facia.stage=CODE
    }
   

3. If overriding switches, control what you want turned on in file switches-yournamehere.properties then upload your file to the S3 frontend store bucket (<bucket>/DEV/config).

• An easy way to do this using the AWS CLI is to download the CODE switches JSON:

  aws s3 cp s3://<bucket>/CODE/config/switches.properties switches-yournamehere.properties --profile frontend

  then amend the values you need, and upload back to the DEV section in S3:

  aws s3 cp switches-yournamehere.properties s3://<bucket>/DEV/config/switches-yournamehere.properties --profile frontend

4. Restart the app you're working on

Notes

• You can see all configuration keys by looking at the GuardianConfiguration class