{"id":27594441,"url":"https://github.com/apache/accumulo-docker","last_synced_at":"2025-04-22T10:34:33.936Z","repository":{"id":49816907,"uuid":"108306709","full_name":"apache/accumulo-docker","owner":"apache","description":"Apache Accumulo Docker","archived":false,"fork":false,"pushed_at":"2023-09-22T19:54:32.000Z","size":39,"stargazers_count":17,"open_issues_count":1,"forks_count":26,"subscribers_count":20,"default_branch":"main","last_synced_at":"2025-04-10T11:58:26.500Z","etag":null,"topics":["accumulo","big-data","docker","hacktoberfest"],"latest_commit_sha":null,"homepage":"https://accumulo.apache.org","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apache.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-10-25T18:05:09.000Z","updated_at":"2024-12-11T22:07:48.000Z","dependencies_parsed_at":"2022-09-15T18:12:34.889Z","dependency_job_id":null,"html_url":"https://github.com/apache/accumulo-docker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Faccumulo-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Faccumulo-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Faccumulo-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Faccumulo-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apache","download_url":"https://codeload.github.com/apache/accumulo-docker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249348098,"owners_count":21255224,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["accumulo","big-data","docker","hacktoberfest"],"created_at":"2025-04-22T10:32:14.252Z","updated_at":"2025-04-22T10:34:33.902Z","avatar_url":"https://github.com/apache.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Apache Accumulo Docker Image\n\nThis is the first release of this project. Eventually, this project will create an `apache/accumulo` image at DockerHub.\nUntil then, you will need to build your own image. The main branch of this repo creates a Docker image for\nAccumulo 2.0+. If you want to create a Docker image for Accumulo 1.9, there is a\n[1.9 branch](https://github.com/apache/accumulo-docker/tree/1.9) for that.\n\n## Obtain the Docker image\n\nTo obtain the docker image created by this project, you can either pull it from DockerHub at\n`apache/accumulo` or build it yourself. To pull the image from DockerHub, run the command below:\n\n    docker pull apache/accumulo\n\nWhile it is easier to pull from DockerHub, the image will default to the software versions below:\n\n| Software    | Version       |\n|-------------|---------------|\n| [Accumulo]  | 2.1.2         |\n| [Hadoop]    | 3.3.6         |\n| [ZooKeeper] | 3.8.2         |\n\nIf these versions do not match what is running on your cluster, you should consider building\nyour own image with matching versions. However, Accumulo must be 2.0.0+. Below are instructions for\nbuilding an image:\n\n1. Clone the Accumulo docker repo\n\n        git clone git@github.com:apache/accumulo-docker.git\n\n2. Build the default Accumulo docker image using the command below.\n\n        cd /path/to/accumulo-docker\n        docker build -t accumulo .\n\n   Or build the Accumulo docker image with specific released versions of Hadoop, Zookeeper, etc that will downloaded from Apache using the command below:\n\n        docker build --build-arg ZOOKEEPER_VERSION=3.4.8 --build-arg HADOOP_VERSION=2.7.0 -t accumulo .\n\n   Or build with an Accumulo tarball (located in same directory as DockerFile) using the command below:\n\n        docker build --build-arg ACCUMULO_FILE=accumulo-\u003cversion\u003e-bin.tar.gz -t accumulo .\n\n## Image basics\n\nThe entrypoint for the Accumulo docker image is the `accumulo` script. While the primary use\ncase for this image is to start Accumulo processes (i.e tserver, master, etc), you can run other\ncommands in the `accumulo` script to test out the image:\n\n```bash\n# No arguments prints Accumulo command usage\ndocker run accumulo\n# Print Accumulo version\ndocker run accumulo version\n# Print Accumulo classpath\ndocker run accumulo classpath\n```\n\n# Run Accumulo using Docker\n\nBefore you can run Accumulo services in Docker, you will need to install Accumulo, configure `accumulo.properties`,\nand initialize your instance with `--upload-accumulo-props`. This will upload configuration to Zookeeper and limit\nhow much configuration needs to be set on the command line.\n\n```bash\n$ accumulo init --upload-accumulo-props\n...\nUploading properties in accumulo.properties to Zookeeper. Properties that cannot be set in Zookeeper will be skipped:\nSkipped - instance.secret = \u003chidden\u003e\nSkipped - instance.volumes = hdfs://localhost:8020/accumulo\nSkipped - instance.zookeeper.host = localhost:2181\nUploaded - table.durability = flush\nUploaded - tserver.memory.maps.native.enabled = false\nUploaded - tserver.readahead.concurrent.max = 64\nUploaded - tserver.server.threads.minimum = 64\nUploaded - tserver.walog.max.size = 512M\n```\n\nAny configuration that is skipped above will need to be passed in as a command line option to Accumulo services running\nin Docker containers. These options can be set in an environment variable which is used in later commands.\n\n```\nexport ACCUMULO_CL_OPTS=\"-o instance.secret=mysecret -o instance.volumes=hdfs://localhost:8020/accumulo -o instance.zookeeper.host=localhost:2181\"\n```\n\nThe Accumulo docker image expects that the HDFS path set by `instance.volumes` is owned by the `accumulo` user. This\ncan be accomplished by running the command below (replace the HDFS path with yours):\n\n```bash\nhdfs dfs -chown -R accumulo hdfs://localhost:8020/accumulo\n```\n\n## Docker engine\n\nUse the `docker` command to start local docker containers. The commands below will start a local Accumulo cluster\nwith two tablet servers.\n\n```\ndocker run -d --network=\"host\" accumulo monitor $ACCUMULO_CL_OPTS\ndocker run -d --network=\"host\" accumulo tserver $ACCUMULO_CL_OPTS\ndocker run -d --network=\"host\" accumulo tserver $ACCUMULO_CL_OPTS\ndocker run -d --network=\"host\" accumulo master $ACCUMULO_CL_OPTS\ndocker run -d --network=\"host\" accumulo gc $ACCUMULO_CL_OPTS\n```\n\nIf you would like to set Java heap size inside the Docker container, start the local docker container using the\ncommand below:\n\n```\ndocker run -e ACCUMULO_JAVA_OPTS='-Xmx1g' -d --network=\"host\" accumulo tserver $ACCUMULO_CL_OPTS\n```\n\n## Marathon\n\nUsing the Marathon UI, you can start Accumulo services using the following\nJSON configuration template.  The template is configured to start an Accumulo\nmonitor but it can be modified to start other Accumulo services such as\n`master`, `tserver` and `gc`. For tablet servers, set `instances` to the number\nof tablet servers that you want to run.\n\n```json\n{\n  \"id\": \"accumulo-monitor\",\n  \"cmd\": \"accumulo monitor -o instance.secret=mysecret -o instance.volumes=hdfs://localhost:8020/accumulo -o instance.zookeeper.host=localhost:2181\",\n  \"cpus\": 1,\n  \"mem\": 512,\n  \"disk\": 0,\n  \"instances\": 1,\n  \"container\": {\n    \"docker\": {\n      \"image\": \"apache/accumulo\",\n      \"network\": \"HOST\"\n    },\n    \"type\": \"DOCKER\"\n  }\n}\n```\n\n[Accumulo]: https://accumulo.apache.org/\n[Hadoop]: https://hadoop.apache.org/\n[ZooKeeper]: https://zookeeper.apache.org/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Faccumulo-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapache%2Faccumulo-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Faccumulo-docker/lists"}