This guide contains instructions for building artifacts contained in this repository.
This spec includes several Go packages, and a command line tool considered to be a reference implementation of the OCI image specification.
- Go >=1.5
The following make targets are relevant for any work involving the Go packages.
The included Go source code is being examined for any linting violations not included in the standard Go compiler. Linting is done using gometalinter.
$ make lint
This target executes all Go based tests.
$ make test $ make validate-examples
Virtual schema http/FileSystem
schema validator uses a virtual http/FileSystem to load the JSON schema files for validating OCI images and/or manifests.
The virtual file system is generated using the
esc tool and compiled into consumers of the
schema package so the JSON schema files don't have to be distributed along with and consumer binaries.
Whenever changes are being done in any of the
schema/*.json files, one must refresh the generated virtual file system.
Otherwise schema changes will not be visible inside
$ make schema-fs
JSON schema formatting
This target auto-formats all JSON files in the
schema directory using the
- jq >=1.5
$ make fmt
OCI image specification PDF/HTML documentation files
This target generates a PDF/HTML version of the OCI image specification.
$ make docs
License header check
This target checks if the source code includes necessary headers.
$ make check-license
Update vendored dependencies
This target updates all vendored dependencies to their newest available versions. The
glide tools is being used for the actual management and
glide-vc tool is being used for stripping down the vendor directory size.
$ make update-deps
Clean build artifacts
This target cleans all generated/compiled artifacts.
$ make clean
Create PNG images from dot files
This target generates PNG image files from DOT source files in the
$ make img/media-types.png