NOTE: This project is alpha stage. Flags, configuration, behavior and design may change significantly in following releases.
The jsonnet-bundler is a package manager for Jsonnet.
go install -a github.com/jsonnet-bundler/jsonnet-bundler/cmd/jb@latest
NOTE: please use a recent Go version to do this, ideally Go 1.13 or greater.
This will put jb in $(go env GOPATH)/bin. If you encounter the error
jb: command not found after installation then you may need to add that directory to your $PATH as shown in their docs.
- Arch Linux AUR
- Mac OS X via Homebrew:
brew install jsonnet-bundler - Fedora (>= 32):
sudo dnf install golang-github-jsonnet-bundler
- Fetches transitive dependencies
- Can vendor subtrees, as opposed to whole repositories
- Always downloads entire dependent repositories, even when updating
- If two dependencies depend on the same package (diamond problem), they must require the same version
Initialize your project:
mkdir myproject
cd myproject
jb initThe existence of the jsonnetfile.json file means your directory is now a
jsonnet-bundler package that can define dependencies.
To depend on another package (another Github repository):
Note that your dependency need not be initialized with a jsonnetfile.json.
If it is not, it is assumed it has no transitive dependencies.
jb install https://github.com/anguslees/kustomize-libsonnetNow write myconfig.jsonnet, which can import a file from that package.
Remember to use -J vendor when running Jsonnet to include the vendor tree.
local kustomize = import 'kustomize-libsonnet/kustomize.libsonnet';
local my_resource = {
metadata: {
name: 'my-resource',
},
};
kustomize.namePrefix('staging-')(my_resource)To depend on a package that is in a subtree of a Github repo (this package also happens to bring in a transitive dependency):
jb install https://github.com/prometheus-operator/prometheus-operator/jsonnet/prometheus-operatorNote that if you are copy pasting from the Github website's address bar,
remove the tree/master from the path.
If pushed to Github, your project can now be referenced from other packages in the same way, with its dependencies fetched automatically.
$ jb -h
usage: jb [<flags>] <command> [<args> ...]
A jsonnet package manager
Flags:
-h, --help Show context-sensitive help (also try --help-long and
--help-man).
--version Show application version.
--jsonnetpkg-home="vendor"
The directory used to cache packages in.
-q, --quiet Suppress any output from git command.
Commands:
help [<command>...]
Show help.
init
Initialize a new empty jsonnetfile
install [<flags>] [<uris>...]
Install new dependencies. Existing ones are silently skipped
update [<uris>...]
Update all or specific dependencies.
rewrite
Automatically rewrite legacy imports to absolute ones
This is an implemention of the design specified in this document: https://docs.google.com/document/d/1czRScSvvOiAJaIjwf3CogOULgQxhY9MkiBKOQI1yR14/edit#heading=h.upn4d5pcxy4c
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent