janus

README

Janus is a tool for versioning and deploying builds to Google Cloud Provider (GCP) Storage from the CI environment.

Install

CI System Requirements:

• JSON GCP Service Account Key, with access to GCP Storage enabled.
• CI environment variable GCP_PASSWD to be set if the key is encrypted.
• openssl is required for key decryption. This is standard on Travis. AppVeyor may require that you add some extra things to your PATH, but you may not have to install anything extra.
• gpg is required to verify the Janus binary. This is standard on Travis and AppVeyor.

Install Janus:

Travis

- curl -sL https://raw.githubusercontent.com/ethereumproject/janus/master/get.sh | bash
- export PATH=./janusbin:$PATH

AppVeyor

- set PATH=C:\msys64\mingw64\bin;C:\msys64\usr\bin\;%PATH%
- curl -sL https://raw.githubusercontent.com/ethereumproject/janus/master/get-windows.sh | bash
- set PATH=./janusbin;%PATH%

Usage

Janus has two subcommands: deploy and version.

Deploy

Janus can use an encrypted or decrypted .json GCP service key file. In case of an encrypted JSON key file, Janus will attempt to decrypt it using openssl, and depends on an environment variable GCP_PASSWD to be set. After successfully decrypting the key and deploying the files, Janus will automatically destroy (rm) the decrypted key from the CI.

flag	example	description
-to	builds.etcdevteam.com/go-ethereum/v3.5.x/	bucket, followed by 'directory' in which to hold the uploaded archive
-files	./dist/*.zip	file(s) to upload, can use relative or absolute path and/or wildcard globbing
-key	./gcloud-travis.enc.json	encrypted or decrypted JSON GCP service key file

$ janus deploy -to builds.etcdevteam.com/go-ethereum/v3.5.x/ -files ./dist/*.zip -key gcloud-service-encrypted-or-decrypted.json
> Deploying...

Version

version uses some variant of git describe or git rev-list to produce a version number, as defined by -format

$ janus version -format v%M.%m.%P+%C-%S
> v3.5.0+55-asdf123

-format=value takes the interpolated forms:

%M, _M - major version
%m, _m - minor version
%P, _P - patch version
%C, _C - commit count since last tag
%S, _S - HEAD sha1 (first 7 characters)

Note: you may use either %M or _M syntax to interpolate version variables, since escaping % in batch scripts is rather tricky.

So this:

sed output (.txt)	format syntax
version-base.txt	--format v%M.%m.x
version-app.txt	--format v%M.%m.%P+%C-%S

replaces this:

- git describe --tags --always > version.txt
- sed -E 's/v([[:digit:]]+\.[[:digit:]]+)\.[[:digit:]]-([[:digit:]]+)-g([a-f0-9]+)/v\1.\2+\3/' version.txt > version-app.txt
- sed -E 's/v([[:digit:]]+\.[[:digit:]]+)\.[[:digit:]]-([[:digit:]]+).+/v\1.\2/' version.txt > version-only.txt
- sed -E 's/v([[:digit:]]+\.[[:digit:]]+)\.[[:digit:]]-([[:digit:]]+).+/v\1.x/' version.txt > version-base.txt

Examples

Please visit the /examples directory to find example Travis and AppVeyor configuration files, deploy script, and service key.

---

In ancient Roman religion and myth, Janus (/ˈdʒeɪnəs/; Latin: Iānus, pronounced [ˈjaː.nus]) is the god of beginnings, gates, transitions, time, duality, doorways,[1] passages, and endings.

• https://en.wikipedia.org/wiki/Janus