JarCasting
JarCasting JarCasting

ScaleCube VaultEnv

ScaleCube VaultEnv is an utility to read static secrets from Vault server.

License

License
GroupId

GroupId

io.scalecube
ArtifactId

ArtifactId

scalecube-vaultenv
Last Version

Last Version

0.1.2
Release Date

Release Date
Type

Type

jar
Description

Description

ScaleCube VaultEnv
ScaleCube VaultEnv is an utility to read static secrets from Vault server.
Project URL

Project URL

https://github.com/scalecube/scalecube-vaultenv
Source Code Management

Source Code Management

https://github.com/scalecube/scalecube-vaultenv

Download scalecube-vaultenv

Filename Size
scalecube-vaultenv-0.1.2.pom
scalecube-vaultenv-0.1.2.jar 17 KB
scalecube-vaultenv-0.1.2-sources.jar 9 KB
scalecube-vaultenv-0.1.2-shaded.jar 1 MB
scalecube-vaultenv-0.1.2-javadoc.jar 414 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/io.scalecube/scalecube-vaultenv/ -->
<dependency>
    <groupId>io.scalecube</groupId>
    <artifactId>scalecube-vaultenv</artifactId>
    <version>0.1.2</version>
</dependency>
// https://jarcasting.com/artifacts/io.scalecube/scalecube-vaultenv/
implementation 'io.scalecube:scalecube-vaultenv:0.1.2'
// https://jarcasting.com/artifacts/io.scalecube/scalecube-vaultenv/
implementation ("io.scalecube:scalecube-vaultenv:0.1.2")
'io.scalecube:scalecube-vaultenv:jar:0.1.2'
<dependency org="io.scalecube" name="scalecube-vaultenv" rev="0.1.2">
  <artifact name="scalecube-vaultenv" type="jar" />
</dependency>
@Grapes(
@Grab(group='io.scalecube', module='scalecube-vaultenv', version='0.1.2')
)
libraryDependencies += "io.scalecube" % "scalecube-vaultenv" % "0.1.2"
[io.scalecube/scalecube-vaultenv "0.1.2"]

Dependencies

compile (4)

Group / Artifact Type Version
com.bettercloud : vault-java-driver jar 5.0.0
org.slf4j : slf4j-api jar 1.7.25
org.apache.logging.log4j : log4j-slf4j-impl jar 2.9.1
org.slf4j : jul-to-slf4j jar 1.7.25

test (6)

Group / Artifact Type Version
org.testcontainers : vault jar 1.12.3
org.junit.jupiter : junit-jupiter-engine jar 5.1.1
org.junit.jupiter : junit-jupiter-params jar 5.1.1
org.mockito : mockito-junit-jupiter jar 2.27.0
org.hamcrest : hamcrest-all jar 1.3
org.hamcrest : hamcrest-core jar 1.3

Project Modules

There are no modules declared in this project.

Scalecube VaultEnvironment

Scalecube VaultEnvironment is an utility for reading static secrets from Vault server and running with them a command or a script.

Usage

  • Get a binary scalecube-vaultenv-VERSION-shaded.jar
  • Install Java (11+)
  • Export configuration environment variables (see below)
  • Execute in terminal: java -jar scalecube-vaultenv-x.y.z-shaded.jar "[CMD]" [RUNNING_MODE].

CMD -- command to run, can be for example npm start or python ./start_app.py, and must come with double quotes.

RUNNING_MODE -- there're two running modes: --input (vaultenv shall pass secrets to stdin of the CMD process) and --env (vaultenv shall pass secrets as environment variables of the CMD process). **NOTE: the latter approach is not recommended on prod environments (finding env variables in kubernetes, show env variables on linux).

Child process

Given in program arguments CMD will be executed in separate process with following semantic:

  • Output(both stdout and stderr) of the forked child process will be redirected to the console and maintained by parent scalecube-vaultenv java process.
  • If scalecube-vaultenv java exits then forked child process exits as well (by SIGINT or SIGTERM).**NOTE: on windows you have to have taskkill installed for proper child process destroy.
  • An opposite is also true, if forked child process exits then scalecube-vaultenv java exits as well.
  • Forked CMD process inherits working directory and environment variables of the parent scalecube-vaultenv java runner.

Config

Environment variables to run a jar:

  • VAULT_ADDR -- vault server address (required)
  • VAULT_SECRETS_PATH -- vault secrets path (required)
  • VAULT_ENGINE_VERSION -- vault KV engine version, by default 1 (being set globally)
  • VAULT_TOKEN -- vault token for token-auth backend (optional, if VAULT_ROLE is set)
  • VAULT_ROLE -- vault role for lubernetes-auth backend (optional, if VAULT_TOKEN is set)

Running in container

To run scalecube-vaultenv in container you have to have image with java (11+), this is the only requirement. For example, this is how to integrate it to a nodejs:

FROM timbru31/java-node:11-jre

...
RUN wget -O ./scalecube-vaultenv.jar https://oss.sonatype.org/service/local/repositories/releases/content/io/scalecube/scalecube-vaultenv/0.1.1/scalecube-vaultenv-0.1.1-shaded.jar
...
CMD ["java","-jar", "./scalecube-vaultenv.jar", "npm run-script robokit-start", "--input"]

Maven

Binaries and dependency information for Maven can be found at http://search.maven.org.

Maven dependency:

<dependency>
  <groupId>io.scalecube</groupId>
  <artifactId>scalecube-vaultenv</artifactId>
  <version>x.y.z</version>
</dependency>

Bugs and Feedback

For bugs, questions and discussions please use the GitHub Issues.

License

Apache License, Version 2.0

io.scalecube

SCΛLΞ CUBΞ

⚛ High-Speed ⚛ Cloud-Native ⚛ Reactive Microservices ⚛

Versions

Version
0.1.2
0.1.1
0.1.0