1
0
mirror of https://github.com/gopasspw/gopass.git synced 2020-06-03 16:52:30 +00:00
gopass/docs/summon-provider.md
Jean Jordaan 393dd0391d Editing while reading (#890)
* Editing while reading

Signed-off-by: Jean Jordaan <jean.jordaan@gmail.com>

* Hyphenate sub-store

Signed-off-by: Jean Jordaan <jean.jordaan@gmail.com>

* Markup literals

Signed-off-by: Jean Jordaan <jean.jordaan@gmail.com>

* "it's" is "it is", "its" is possessive.

Signed-off-by: Jean Jordaan <jean.jordaan@gmail.com>

* Make clear that it's the .config in $HOME

Signed-off-by: Jean Jordaan <jean.jordaan@gmail.com>

* Use commas for phrasing

Signed-off-by: Jean Jordaan <jean.jordaan@gmail.com>

* Hyphenate sub-command

Signed-off-by: Jean Jordaan <jean.jordaan@gmail.com>

* Mark bash blocks as bash

Signed-off-by: Jean Jordaan <jean.jordaan@gmail.com>

* Add some semantic linebreaks; fix code block quoting

Signed-off-by: Jean Jordaan <jean.jordaan@gmail.com>

* Improve phrasing

Signed-off-by: Jean Jordaan <jean.jordaan@gmail.com>

* Markup, commas ..

Signed-off-by: Jean Jordaan <jean.jordaan@gmail.com>

* gopass is consistently lowercase

Signed-off-by: Jean Jordaan <jean.jordaan@gmail.com>

* Add some linebreaks, improve phrasing

Signed-off-by: Jean Jordaan <jean.jordaan@gmail.com>
2018-08-11 07:17:35 +02:00

1.0 KiB

Using gopass as summon provider

What is summon?

Summon is a command-line tool to inject secrets as environment variables. It is used to execute a process and inject secrets from a separate store. Using gopass can be useful in (local) development

Summon Provider

gopass can be used as summon provider out of the box, since it fulfills the summon provider contract.

To make use of gopass to retrieve the test/db-password secret, you can call summon with full provider path

summon -p /usr/local/bin/gopass --yaml 'DBPASS: !var test/db-password' bash -c 'echo $DBPASS'

or link gopass to /usr/local/lib/summon/gopass and just use gopass

summon -p gopass --yaml 'DBPASS: !var test/db-password' bash -c 'echo $DBPASS'

or export SUMMON_PROVIDER=gopass as default provider

summon --yaml 'DBPASS: !var test/db-password' bash -c 'echo $DBPASS'

With the appropriate secrets.yml, it's as easy as running

summon ./my-command-to-run