An importer utility for adding parameters to cloudtruth.

docker pull cloudtruth/importer

docker rmi --force cloudtruth/importer

To get the cli usage for the importer:

docker run cloudtruth/importer --help

and then run it for real like:

docker run -v $(pwd):/data -e CLOUDTRUTH_API_KEY=xyz cloudtruth/importer --dry-run /data/some/file.yaml

It scans the given directories and files (or stdin), parsing those that are a form of structured data (json/yaml/dotenv/properties). The structured data is then passed into a transformation template in order to generate parameter definitions that are used to drive the cloudtruth cli to create the actual parameters.

The transformation template is processed using the Liquid template language. The context supplied to each rendering of the template will contain the variables:

The default transformation template treats the data passed in as a simple HashMap, using its keys/value to be the parameter keys and values. It looks like:

{% for entry in data %}
- environment: "{{ environment }}"
  project: "{{ project }}"
  key: "{{ entry[0] }}"
  value: "{{ entry[1] }}"
{% endfor %}

To handle other data structures, your template should produce a yaml document that is a list of parameter definitions of the form:

 - environment: someEnvironment,  # The environment to set the value for
   environment_parent: someParentEnv,  # The environment's parent if using --create-environments
   project: someProject, # The project to create the parameter in
   project_parent: someParentProj,  # The project's parent if using --create-projects
   key: aKey, # The key name of the parameter
   value: aValue, # The value for the parameter.  Don't set this if using FQN+JMES
   secret: false, # (optional) Indicate that the parameter should be created as a secret
   fqn: myFQN, # (optional) Set the parameter value to come from the given FQN (with optional JMES) 
   jmes: myJmesPath # (optional) Set the parameter value to come from the given FQN+JMES

cat somefile.yaml | docker run -i -e CLOUDTRUTH_API_KEY=xyz cloudtruth/importer --dry-run --stdin yaml

After checking out the repo, run docker build -t cloudtruth/importer . to build the image.

Run docker run -it --entrypoint "" cloudtruth/importer bundle exec rspec to run the tests.

Run docker run -it --entrypoint "" cloudtruth/importer bundle exec bin/console to get an interactive console.

Bug reports and pull requests are welcome on GitHub at https://github.com/cloudtruth/importer.