Multi-publication Support

The prompts displayed by setup do not offer the option of creating more than one publication. CUE Front, however, is designed to support multiple publications. Once you have used the setup utility to get up and running with a single publication, you can switch to a multi-publication configuration by simply editing a few files (assuming that your Content Engine hosts more than one publication).

When you create a CUE Front configuration using the setup add command, the prompts displayed by the setup utility are read from a file called setup/defaults/blueprint.yaml. The configuration that is generated by the command is stored in a folder called setup/configs/config, where config is the name of your configuration. The configuration consists of a blueprint.yaml file, which contains your responses to the prompts displayed by setup add, and a set of program-specific configuration files: cook-config.yaml, fridge-config.yaml, cleaver-config.yaml, docker-compose.yml and waiter-config.yaml. These configuration files are created by copying a set of default files from the setup/defaults folder and using the responses in blueprint.yaml to override selected settings.

Since setup add cannot prompt for multiple publications and blueprint.yaml cannot store settings for multiple publications, the recommended way to add extra publications to your setup is as follows:

  1. Add the multiple publication settings to setup/defaults/waiter-config.yaml by manually editing the file.

  2. Remove the publication prompt definitions from setup/defaults/blueprint.yaml by manually editing the file.

  3. Run setup add to generate a new configuration containing the multiple publication definitions.

  4. Add information about your new publications to the nginx configuration file, waiter/docker/nginx.conf.

  5. Restart the Waiter and nginx.

  6. Commit the changes you made in steps 1, 2 and 4 to your repository to make them available for other users.