Build configuration

Env files

Usually we have the following env files:

  • env.default for the c2cgeoportal default configuration.

  • env.project for the project configuration.

  • env.<organization> in a multi-organization project these files will contain organization-specific configurations.

  • env.(dev|int|prod) environment specific settings, for example one for development, one for integration and one for production, not needed for projects managed in an OpenShift platform.

The usage of env file should be configured in the project.yaml file, in the env section.

Project env configuration:

  • files: the env files interpreted with the build env arguments.

  • required_args: the number of required build env arguments.

  • help: the message displayed on wrong build env arguments number.

For an OpenShift project you can use (default):

env:
  files:
    - env.default
    - env.project
  required_args: 0
  help: No arguments needed.

For a non OpenShift project you can use:

env:
  files:
    - env.default
    - env.project
    - env.{0}
  required_args: 1
  help: You should use `./build <env>` where <env> can be dev, int or prod.

For a non OpenShift multi town project you can use:

env:
  files:
    - env.default
    - env.project
    - env.{0}
    - env.{1}
  required_args: 2
  help: You should use `./build <town> <env>` where <env> can be dev, int or prod.

Vars files

The project variables are set in the geoportal/vars.yaml file, which extends the default geoportal/CONST_vars.yaml.

To make such variables available to the python code, for instance using

request.registry.settings.get('some_config_var')

they must be listed in the makefile as well using CONFIG_VARS (see below).

To be able to use a variable from the makefile in the vars file, you should export your variable as follows:

export MY_VAR ?= my_value

And in your yaml vars file, add:

vars:
   ...
   my_var: MY_VAR
interpreted:
   ...
   environment:
   - ...
   - my_var

For more information, see the c2c.template documentation.

Dockefile config variables

The following variables may be set in the Dockerfile:

  • CONFIG_VARS: The list of parameters read from the project YAML configuration file.

Makefile config variables

Note

This is not possible in the simple application mode

The following variables may be set in the makefiles:

  • DISABLE_BUILD_RULES: List of rules we want to disable, default is empty.

  • LANGUAGES: List of available languages, default is en fr de.

  • NGEO_INTERFACES: List of ngeo interfaces, default is mobile desktop.

Custom rules

Note

This is not possible in the simple application mode

In the geoportal/Makefile file, you can create custom rules. Here is an example:

MY_FILE ?= <file>

build: $(MY_FILE)

$(MY_FILE): <source_file>
    cp <source_file> $(MY_FILE)
    # Short version:
    # cp $< $@

clean: project-clean
.PHONY: project-clean
project-clean:
    rm -f $(MY_FILE)

Upstream make documentation.