README
¶
alpinepass
A tool for managing system environments.
$ alpinepass -h
usage: alpinepass [options...]
Options:
-f [filter|key:value] Apply a filter. The falg can be used multiple to allow advanced filtering.
-h Display this help message.
-i [filepath] Define the input file. The file content must be YAML.
-o [filepath] Specify the output file. The file content will be JSON.
-p Include passwords in the output.
-r Format the output for better readability.
-s Show the output in the console. An output file will not be written.
-v Print the application's version.
Installation
Download the latest version from the release page and add the executable to your PATH.
Development setup
- install Go
- set the
$GOPATH - clone the repository into
{$GOPATH}/src/github.com/appPlant/alpinepass cdinto the repository- run
go get -v - build the application with
go build - execute the application with
./alpinepass
Manual
Overview
alpinepass is an application for managing information about computer system environments. It transforms information defined in a YAML file into different output formats like JSON and KeePass files. Filters allow creating output which matches certain creteria like information about databases or test systems only.
Basic usage
Executing the application without any options reads the file input.yaml and creates the file output.json. The input file must exist in the same directory as the application, the output file is created in the same directory. The output does not contain any system passwords. No filters are applied to the input.
$ alpinepass
Create a JSON output containing all information including passwords:
$ alpinepass -p
Create a JSON output containing production databases only:
$ alpinepass -f=type:db;environment:prod
Create a YAML output file /home/admin/endor_test.yml containing all test systems located on Endor:
$ alpinepass -t=/home/admin -n=endor_test -o=yaml -f=location:Endor;environment:test
Dependencies
License
The code is available as open source under the terms of the Apache 2.0 License.
Made with ❤ and ☕ in Leipzig!
© 2017 appPlant GmbH
Directories