blob: b4c39a5dffa21b38294e29b8e58f6e8d740616c2 [file] [log] [blame] [view]
# Apache Accumulo Docker Image
## Obtain the Docker image
To obtain the docker image created by this project, you can either pull it from DockerHub at
`apache/accumulo` or build it yourself. To pull the image from DockerHub, run the command below:
docker pull apache/accumulo
While it is easier to pull from DockerHub, the image will default to the software versions below:
| Software | Version |
|-------------|---------------|
| [Accumulo] | 1.9.3 |
| [Hadoop] | 2.8.5 |
| [Zookeeper] | 3.4.13 |
If these versions do not match what is running on your cluster, you should consider building
your own image with matching versions. However, Accumulo must be 2.0.0+. Below are instructions for
building an image:
1. Clone the Accumulo docker repo
git clone git@github.com:apache/accumulo-docker.git
2. Build the default Accumulo docker image using the command below.
cd /path/to/accumulo-docker
docker build -t accumulo .
Or build the Accumulo docker image with specific released versions of Hadoop, Zookeeper, etc that will downloaded from Apache using the command below:
docker build --build-arg ZOOKEEPER_VERSION=3.4.8 --build-arg HADOOP_VERSION=2.7.0 -t accumulo .
Or build with an Accumulo tarball (located in same directory as DockerFile) using the command below:
docker build --build-arg ACCUMULO_VERSION=1.9.3-SNAPSHOT --build-arg ACCUMULO_FILE=accumulo-1.9.3-SNAPSHOT-bin.tar.gz -t accumulo .
## Image basics
The entrypoint for the Accumulo docker image is the `accumulo` script. While the primary use
case for this image is to start Accumulo processes (i.e tserver, master, etc), you can run other
commands in the `accumulo` script to test out the image:
```bash
# No arguments prints Accumulo command usage
docker run accumulo
# Print Accumulo version
docker run accumulo version
# Print Accumulo classpath
docker run accumulo classpath
```
[Accumulo]: https://accumulo.apache.org/
[Hadoop]: https://hadoop.apache.org/
[Zookeeper]: https://zookeeper.apache.org/