A Python alternative to git2consul
https://python-poetry.org/docs/#installation
poetry shell
poetry install
gitzconsul --helpgitcommand- python >= 3.8
- python3
requestsandclickmodules (seepyproject.toml)
Usage: gitzconsul [OPTIONS]
Register kv values into consul based on git repository content
Options:
-r, --root TEXT root directory to read files from, relative
to directory [default: ]
-d, --directory TEXT directory of the repository, will be created
if needed [required]
-g, --git-url TEXT git repository remote url
-R, --git-ref TEXT git repository remote ref [default:
refs/heads/master]
-k, --consul-key TEXT add keys under this key [required]
-u, --consul-url TEXT consul url [default: http://localhost:8500]
-i, --interval INTEGER interval in seconds between syncs [default:
15]
-a, --consul-datacenter TEXT consul datacenter
-t, --consul-token TEXT consul token
-T, --consul-token-file TEXT path to file containing consul token
-f, --logfile TEXT log file path
-l, --loglevel [CRITICAL|ERROR|WARNING|INFO|DEBUG]
log level [default: INFO]
-G, --debug output extra debug info
--help Show this message and exit.
Typical directory structure will be:
topdir/
├── dir1
│ ├── file2.json
│ └── subdir1
│ ├── file1.json
│ └── ignored.txt
└── dir2
└── somestuff
Typical file1.json (and file2.json for this example) would contain something like:
{
"key1": "foo",
"key2": {
"key3": "bar"
}
}gitzconsul --directory topdir/ --root dir1 --consul-key mytopkeycurl http://localhost:8500/v1/kv/mytopkey?keys[
"mytopkey/file2.json/key1",
"mytopkey/file2.json/key2/key3",
"mytopkey/subdir1/file1.json/key1",
"mytopkey/subdir1/file1.json/key2/key3"
]- Files not ending with
.jsonor unparseable json files are ignored. - Directory specified by
--rootisn't prepended to keys and any content outside of it is ignored. - JSON file names are used as keys (it keeps the extension)
- If a previously parsed json file becomes unparseable, keys related to it are left untouched.
Official docker images are available from Docker Hub
docker pull metabrainz/gitzconsullatest: the latest released imagevA.B.C: released versionned imageedge: the last build, upon last commit of the main github branch
docker build . -t gitzconsulIt will look for ssh files in /tmp/.ssh and copy them over proper user's home with proper perms:
/tmp/.ssh/id_rsa_shared
/tmp/.ssh/config
/tmp/.ssh/known_hosts
See entrypoint.sh
docker run --rm gitzconsul --helpIf git repository isn't public, you'll need to setup a deploy key, and pass it to the container.
ssh-keygen -t ed25519 -C 'gitzconsul' -P '' -f ./id_rsa_sharedAlso to access consul, you may want to use network host mode (depending on your setup): --net host
Example of docker run command:
TOPKEY=mytopkey
DIRROOT=dir1
[email protected]:domain/project.git
docker run \
--name gitzconsul \
--volume $(pwd)/id_rsa_shared:/tmp/.ssh/id_rsa_shared:ro \
--detach \
--net host \
gitzconsul \
--root $DIRROOT \
--consul-key $TOPKEY \
--git-url $GITREPO \
--directory /home/gitzconsul/repo
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent