agturley/nifi

Apache NiFi (RHEL 版本) 镜像文档

目录

• 镜像概述
• 核心功能与特性
• 使用场景与适用范围
• 镜像标签说明
• 使用方法与配置说明
• 环境变量详解
• 卷挂载说明
• 部署示例
• 注意事项

镜像概述

本镜像基于 RHEL 8 构建，包含 Apache NiFi 及 OpenJDK11 或 OpenJDK8 运行环境，支持 OpenShift 平台部署。该镜像提供扩展的环境变量集，可配置 LDAPS 认证/授权及集群功能，配置方法与官方镜像兼容。

核心功能与特性

• 基于 RHEL 8 稳定系统构建，提供可靠运行环境
• 支持 OpenJDK8 和 OpenJDK11 两种版本选择
• 内置 LDAPS 认证/授权机制，满足企业级安全需求
• 完整支持 NiFi 集群部署，包含 Zookeeper 集成
• 提供丰富的环境变量配置选项，简化部署流程
• 兼容 OpenShift 平台部署要求

使用场景与适用范围

• 企业级 ETL 数据处理与流转
• 需要 LDAP 认证的安全数据管道
• 多节点高可用 NiFi 集群部署
• OpenShift 容器平台上的 NiFi 部署
• 对稳定性和安全性有高要求的生产环境

镜像标签说明

使用方法与配置说明

基础使用

bash
docker run --name nifi -p 8080:8080 -d agturley/nifi:latest

环境变量详解

JVM 配置

网络配置

ZooKeeper 配置

安全配置

LDAP 配置

LDAP 同步配置

身份映射配置

卷挂载说明

部署示例

Docker Run 基础示例

bash
docker run --name nifi \
  -p 8443:8443 \
  -e NIFI_JVM_HEAP_INIT=1g \
  -e NIFI_JVM_HEAP_MAX=1g \
  -e NIFI_WEB_HTTPS_PORT=8443 \
  -v /opt/cooltest/nifi/certs:/opt/nifi/nifi-current/certs \
  -v /opt/cooltest/nifi/conf:/opt/nifi/nifi-current/conf \
  -v /opt/cooltest/nifi/logs:/opt/nifi/nifi-current/logs \
  -d agturley/nifi:latest

Docker Compose 集群配置示例

yaml
version: '3'
services:
  nifi:
    image: agturley/nifi:latest
    container_name: nifi-node
    ports:
      - "8443:8443"
      - "1055:1055"
    environment:
      - NIFI_JVM_HEAP_INIT=1g
      - NIFI_JVM_HEAP_MAX=1g
      - NIFI_WEB_HTTPS_PORT=8443
      - NIFI_CLUSTER_IS_NODE=true
      - NIFI_CLUSTER_NODE_PROTOCOL_PORT=1055
      - NIFI_CLUSTER_PROTOCOL_IS_SECURE=true
      - NIFI_ZK_CONNECT_STRING=zookeeper1:2181,zookeeper2:2181,zookeeper3:2181
      - NIFI_ELECTION_MAX_WAIT=2 min
      - NIFI_ELECTION_MAX_CANDIDATES=3
      - NIFI_WEB_HTTPS_HOST=nifidev01-nifi
      - NIFI_WEB_PROXY_HOST=nifidev01-nifi1:8443,nifidev02-nifi1:8443,nifidev03-nifi1:8443,nifidev01.test.local:8443,nifidev02.test.local:8443,nifidev03.test.local:8443
      - INITIAL_ADMIN_IDENTITY=testUser
      - NODE_IDENTITY=CN=servername-nifi1, OU=NIFI
      - KEYSTORE_PATH=/opt/nifi/nifi-current/certs/keystore.jks
      - KEYSTORE_TYPE=jks
      - KEYSTORE_PASSWORD=testpassword
      - TRUSTSTORE_PATH=/opt/nifi/nifi-current/certs/truststore.jks
      - TRUSTSTORE_TYPE=jks
      - TRUSTSTORE_PASSWORD=testpassword
      - AUTH=ldap
      - LDAP_AUTHENTICATION_STRATEGY=LDAPS
      - LDAP_MANAGER_DN=CN=svc_nifi,CN=Users,DC=test,DC=local
      - LDAP_MANAGER_PASSWORD=somepassword
      - LDAP_USER_SEARCH_BASE=OU=Sample-Users,DC=test,DC=local
      - LDAP_USER_SEARCH_FILTER=(sAMAccountName={0})
      - LDAP_IDENTITY_STRATEGY=USE_USERNAME
      - LDAP_URL=ldaps://dc01.test.local:636
      - LDAP_TLS_KEYSTORE=/opt/nifi/nifi-current/certs/adsldapts.jks
      - LDAP_TLS_KEYSTORE_PASSWORD=somepassword
      - LDAP_TLS_KEYSTORE_TYPE=jks
      - LDAP_TLS_TRUSTSTORE=/opt/nifi/nifi-current/certs/adsldapts.jks
      - LDAP_TLS_TRUSTSTORE_PASSWORD=somepassword
      - LDAP_TLS_TRUSTSTORE_TYPE=jks
      - LDAP_TLS_PROTOCOL=TLS
    volumes:
      - /opt/cooltest/nifi/certs:/opt/nifi/nifi-current/certs
      - /opt/cooltest/nifi/config/node_identity_list.xml:/opt/nifi/nifi-current/node_identity_list.xml
      - /opt/cooltest/nifi/config/user_identity_list.xml:/opt/nifi/nifi-current/user_identity_list.xml
      - /opt/cooltest/nifi/conf:/opt/nifi/nifi-current/conf
      - /opt/cooltest/nifi/logs:/opt/nifi/nifi-current/logs
      - /data/nifi/content_repository:/opt/nifi/nifi-current/content_repository
      - /data/nifi/database_repository:/opt/nifi/nifi-current/database_repository
      - /data/nifi/flowfile_repository:/opt/nifi/nifi-current/flowfile_repository
      - /data/nifi/provenance_repository:/opt/nifi/nifi-current/provenance_repository
    restart: always

注意事项

1. 配置目录挂载：当挂载整个 conf 目录时，如果宿主机目录为空，容器会自动生成一套全新的 NiFi 配置文件。此操作仅在宿主机目录完全为空时执行。

2. 集群安全配置：创建安全集群时，必须提供以下两个文件以自定义 authorizers.xml：

   • node_identity_list.xml：

   xml
   <property name="Node Identity 1">CN=nifidev01-nifi, OU=NIFI</property>
   <property name="Node Identity 2">CN=nifidev02-nifi, OU=NIFI</property>
   <property name="Node Identity 3">CN=nifidev03-nifi, OU=NIFI</property>
   

   • user_identity_list.xml：

   xml
   <property name="Initial User Identity 0">testuser</property>
   <property name="Initial User Identity 1">CN=nifidev01-nifi, OU=NIFI</property>
   <property name="Initial User Identity 2">CN=nifidev02-nifi, OU=NIFI</property>
   <property name="Initial User Identity 3">CN=nifidev03-nifi, OU=NIFI</property>
   

3. 证书管理：生产环境中应使用安全的证书管理策略，避免使用示例中的默认密码。

4. 资源配置：根据实际环境调整 JVM 堆大小和其他资源配置，确保 NiFi 服务稳定运行。

5. CentOS 版本：如需在 CentOS 7 上部署 NiFi，可参考镜像 https://hub.docker.com/r/agturley/centos-nifi。