NiFi

Docker image for Apache NiFi.

Created from NiFi base image to minimize traffic and deployment time in case of changes should be applied on top of NiFi

Why base image is required?

DockerHub does not cache image layers while compilation. Thus creation of base image (with pure NiFi) mitigates this issue and let us to experiment/play with NiFi settings w/o downloading full NiFi archive (more than 800MB) each time when we change smth. in configuration (or libs, add-ons, etc.) and recompile docker image. Only our changes will be pulled out from Docker Hub instead of full image.

                    ##         .
              ## ## ##        ==
           ## ## ## ## ##    ===
       /"""""""""""""""""\___/ ===
  ~~~ {~~ ~~~~ ~~~ ~~~~ ~~~ ~ /  ===- ~~~
       \______ o   NiFi    __/
         \    \   1.0.0 __/
          \____\_______/

Overview

🔵 Dockerized and parametrized single- and multi-host NiFi.
🔵 Site-to-site communication is switched on.
🔵 Scalability is supported.
🔴 SSL implementation sholud be the next step.

Deployment options:

Standalone NiFi node (by default built directly from image)
Single-host NiFi cluster (within sigle docker-machine)
Multi-host NiFi cluster (within several physical hosts and/or several docker-machines)

Migration from 0.x version

All required information can be found here

Used ports (all of them are configurable)

2883 - 0.x only NiFi Cluster Manager/unicast manager protocol port
2881 - NiFi site to site communication port
2882 - NiFi cluster node protocol port
2181 - Zookeeper client port
2888 - Zookeeper port for monitoring NiFi nodes availability
3888 - Zookeeper port for NiFi Cluster Coordinator election

Exposed ports

8080 - NiFi web application port
8443 - NiFi web application secure port
8081 - NiFi ListenHTTP processor port

Volumes

All below volumes can be mounted to docker host machine folders or shared folders to easy maintain data inside them.

NiFi-specific:

/opt/nifi/logs
/opt/nifi/flowfile_repository
/opt/nifi/database_repository
/opt/nifi/content_repository
/opt/nifi/provenance_repository

User-specific:

/opt/datafiles
/opt/scriptfiles
/opt/certfiles

Additional environment properties

To add more flexibility in configuration there are some environment variables have been added to the image.

BANNER_TEXT - NiFi instance banner text to be able to easily recognize instance from first look on UI
S2S_PORT - NiFi Site-to-site communication port. If empty, following value will be used: 2881

Official Apache NiFi Documentation and Guides

ListenHTTP Processor

The standard library has a built-in processor for an HTTP endpoint listener. That processor is named ListenHTTP. You should set the Listening Port of the instantiated processor to 8081 if you follow the instructions from above.

Usage

This image can either be used as a image for building on top of NiFi or just to experiment with. I personally have not attempted to use this in a production use case.

Pre-Requisites

Ensure the following pre-requisites are met (due to some blocker bugs in earlier versions). As of today, the latest Docker Toolbox and Homebrew are fine.

Docker 1.10+
Docker Compose 1.6.1+
Docker Machine 0.6.0+

(all downloadable as a single Docker Toolbox package as well)

How to use from Kitematic

Start Kitematic
Enter xemuliam in serach box
Choose nifi image
Click Create button

Kitematic will assign all ports and you'll be able to run NiFi web-interface directly from Kitematic.

How to use from Docker CLI

Start Docker Quickstart Terminal
Run command docker run -d -p 8080:8080 -p 8081:8081 -p 8443:8443 xemuliam/nifi
Check Docker machine IP docker-machine ls
Use IP from previous step in address bar of your favorite browser, e.g. http://192.168.99.100:8080/nifi

How to use NiFi in cluster mode

Please read explanation.

Klarrio / docker-nifi