The toml configuration can be provided by a file, via consul k/v store or via vault.
You can also generate a configuration file template with the following command.
$ $PATH_TO_CDS/engine config new > my_conf_file.toml
Edit this file.
Check your configuration file with
$ $PATH_TO_CDS/engine config check my_conf_file.toml
Reading configuration file my_new_file.toml
Configuration file OK
Create your database relations
$ $PATH_TO_CDS/engine database upgrade --db-host <host> --db-port <port> --db-user <user> --db-password <password> --db-name <database> --db-schema=public --migrate-dir $PATH_TO_CDS/engine/sql/api --limit 0
$ PGPASSWORD=<password> psql -h <host> -p <port> -U <user> -d <database> -c "CREATE SCHEMA IF NOT EXISTS cdn AUTHORIZATION <user>;"
$ $PATH_TO_CDS/engine database upgrade --db-host <host> --db-port <port> --db-user <user> --db-password <password> --db-name <database> --db-schema=cdn --migrate-dir $PATH_TO_CDS/engine/sql/cdn --limit 0
Download workers binaries
$ $PATH_TO_CDS/engine download workers --config my_conf_file.toml
Reading configuration file my_conf_file.toml
Downloading worker for os windows and arch amd64 into /tmp/cds/download...
Downloading worker for os windows and arch 386 into /tmp/cds/download...
...
Run CDS
$ $PATH_TO_CDS/engine start api --config my_conf_file.toml
Reading configuration file my_new_file.toml
2017/04/04 16:33:17 [NOTICE] Starting CDS server...
...
Upload your toml configuration to consul
$ consul kv put cds/config.api.toml -
<PASTE YOUR CONFIGURATION>
<ENDS WITH CTRL-D>
Success! Data written to: cds/config.api.toml
Run CDS
$ $PATH_TO_CDS/engine start api --remote-config localhost:8500 --remote-config-key cds/config.api.toml
Reading configuration from localhost:8500
2017/04/04 16:11:25 [NOTICE] Starting CDS server...
...
You have to put your configuration in a TOML format like above with good values into a secret named /secret/cds/conf in your vault.
For example if you use the vault CLI:
$ myConfig=`cat conf.toml`
$ vault write secret/cds/conf data=$myConfig
$ $PATH_TO_CDS/engine start api --vault-addr=http://myvault.com --vault-token=XXXX
Reading configuration from vault @http://myvault.com
2017/04/04 16:33:17 [NOTICE] Starting CDS server...