This repository aims to provide easy-to-use containers with minimal dependencies to run instances of Hyperledger Indy Node. The primary goal is to support stewards joining an existing Network, but of course the containers can also be used in a stand alone (local/test/...) network. The initial contributions stem from the Container Working Group of ID Union. The repository was contributed to Hyperledger in 2022-02.
Primary artifact are the container images for
- Indy Node
- and the Indy Node Controller which are build from the files in the build folder.
We also provide a few utility scripts, including a docker-compose file to help setting up a run time environment for the containers. See here for instructions how to setup and run the indy node images from this repository.
Currently we are providing the following stable indy node images. All those images use the latest Indy Node 1.12 version. The images differ by base image and are tagged accordingly:
Additionally, we build an experimental image for Indy node 1.13 RC testing:
See here for instructions how to setup and run the images.
To build the node image you can use docker
from the project root like
docker build -f "build/Dockerfile.ubuntu20" -t indy-node-container/indy_node:ubuntu20 ./build
or you can use make
which provides some shortcuts
# make [bullseye|ubuntu20|all|controller] (default is ubuntu20), e.g.
make ubuntu20
# make clean removes images
# make [clean|clean_bullseye|clean_ubuntu20|clean_controller], e.g. this removes all images
make clean
Please note that make
generates different tags than the Github action (see packages vs. Makefile).
If you have trivy installed, you can use the make check_* targets to run a trivy check against the local images:
#make [check_bullseye|check_ubuntu20|check_controller], e.g.
make check_ubuntu20
Trivy HTML reports are created in ./trivy-reports
.
Any contribution is welcome, e.g. documentation, bug reports, feature request, issues, blog posts, tutorials, feature implementations, etc. You can contribute code or documentation through the standard GitHub pull request model.
Please have a look at CONTRIBUTING.md for details, in particular how and why you need to sign off commits.
Be excellent to each other!
See CODE_OF_CONDUCT.md for details.
Copyright 2020-2022 by all parties listed in the NOTICE file
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.