parampiper

parampiper is a tool for manage parameters across between systems/environments.

What parampiper brings

• 🌍 Single Source of Truth (SSOT). All your parameters in one place.
• 📄 Works on a simple JSON file.
• 🔄 Support several backends (local file, Azure Blob).

Installation

MacOS

brew install cdalar/tap/parampiper

Linux

curl -sLS https://www.p8r.dev/get.sh | sh 
sudo install p8r /usr/local/bin/

Windows

• download windows binary from releases page
• unzip and copy p8r.exe to a location in PATH

Usage

$ p8r
a tool to manage parameters cross different environments

Usage:
  p8r [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  get         Get Parameter Value by Name
  help        Help about any command
  import      Import Parameters
  init        create a .p8r directory with the default configuration files
  ls          List Parameters
  out         Output Parameters
  rm          Delete Parameter
  set         Add/Update Parameter
  version     Print the version number of onctl

Flags:
  -c, --config string   Configuration file (default ".p8r/parampiper.yaml")
  -h, --help            help for p8r

Use "p8r [command] --help" for more information about a command.

Initial Configuration

Create the default configuration under .p8r/parampiper.yaml

$ p8r init
p8r environment initialized

Default configuration file is follows:

local_file:
  FilePath: parampiper.json
azure_blob:
  StorageAccountName: stparampiper
  ContainerName: abc
  BlobName: parampiper.json

Set which backend provider you like to use

• local_file
• azure_blob

Set Environment Variables PP_DATA to one of the above.

export PP_DATA=local_file

Adding/Updating Parameters

p8r set -n key1 -v value1

will add key1 key with value value1.

Delete Parameters

p8r rm -n key1

will delete the parameter named key1

List Parameters

p8r ls 
NAME   TYPE    VALUE    ATTRIBUTES   INFO
key1   basic   value1   0

Output

Different ways to output parameters

Environment Variables

p8r out -oexport > export.sh
cat export.sh
export KEY1="value1"

Exporting as Terraform tfvars file

p8r out -otfvars > parameters.auto.tfvars

by exporting it as *auto.tfvars (tfvars files) you can directly use it inside your terraform code.