Wizetorus

Project to set, retrieve and populate environment variables using a Vault Server For the moment, this project only works with the version 2 of the KV engine API.

How to use it

1. Install wizetorus globally

    $ npm install -g wizetorus
   

2. Inside your project, create a file called .wizetorus.json with the following information:

    {
      "endpoint": "https://localhost:8200",
      "engine": "kv2",
      "project": "org/myProject"
      "environment": "develop"
    }
   

The full path to the secret file inside the vault server will correspond to endpoint/engine/project/<environment>. The environment attribute is optional and you can define it as a path. If you want to retrieve variables for other environment you can use the -e flag, for example wizetorus view -e devManuel. You can use environment variables previously defined inside the .wizetorus file, using the syntax <%= env('ENV_VAR') %> where ENV_VAR is the name of the variable. For example:

    {
      "endpoint": "<%= env('VAULT_ENDPOINT') %>",
      "engine": "kv2",
      "project": "org/myProject"
      "environment": "<%= env('STAGE') %>"
    }

3. Login into the VaultServer to return the vaultToken:

    $ wizetorus login -m userpass -u username
   

4. Copy the client_token attribute returned by the previous command.

5. Export the following environment variable:

    $ export VAULT_TOKEN=client_token
   

If you do not want to export this variable, you can define it in the .wizetorus file under the vaultToken attribute.

6. To set a new environment variable run:

    $ wizetorus set key=value
   

You can also pass a path to a valid json file:

    $ wizetorus set ./vars.json

7. To see the environment variables run:

    $ wizetorus view
   

8. See all the options for wizetorus:

    $wizetorus --help