기술과 산업/AI

Apache NiFi 시리즈 2회 - Apache NiFi 설치 및 환경 구성 가이드

B컷개발자 2025. 5. 7. 16:15
728x90

Apache NiFi를 설치하고 로컬 환경에서 실행하는 방법을 OS별로 정리했습니다. GUI 기반의 첫 화면과 주요 UI 구성도 함께 설명합니다.

 

 

시작하며 – 설치는 복잡하지 않다

 

Apache NiFi의 장점 중 하나는 설치가 매우 간단하다는 점입니다. Apache 재단에서 배포하는 공식 바이너리를 다운로드하면, 별도의 데이터베이스나 복잡한 의존성 없이도 바로 실행이 가능합니다. Java만 설치되어 있다면 곧바로 시작할 수 있습니다.

 

이번 회에서는 NiFi를 로컬 환경에서 설치하고 브라우저에서 실행하는 전체 흐름을 소개합니다. 또한 웹 기반 GUI의 핵심 구성요소도 함께 살펴보겠습니다.

 

 

필수 요구사항

 

  • Java 8 이상 (JDK 8 또는 11 권장)
  • 대부분의 NiFi 버전은 Java 8~11과 호환됩니다. 최신 버전에서는 Java 17도 지원됩니다.
  • 메모리 최소 4GB 이상 권장
  • NiFi는 JVM 기반이고, 기본 설정이 512MB이지만 실무에서는 2GB 이상으로 설정하는 것이 일반적입니다.
  • 운영체제: Windows, macOS, Linux 모두 지원

 

 

설치 방법 (OS별 안내)

 

 

🔹 1. 공식 사이트에서 바이너리 다운로드

 

공식 다운로드 페이지

→ nifi-x.y.z-bin.zip 파일 선택

→ Apache Mirror를 통해 다운로드

 

버전은 현재 기준으로 1.26.0 이상을 사용하는 것을 권장합니다.

 

 

🔸 2. Windows 기준 설치

 

  1. 압축 해제: nifi-x.y.z-bin.zip 압축을 원하는 폴더에 풉니다
  2. 실행: bin 디렉토리로 이동하여 run-nifi.bat 실행
  3. 브라우저에서 접속: http://localhost:8080/nifi 입력

 

 

🔸 3. macOS 기준 설치

 

  1. 터미널에서 압축 해제:
unzip nifi-x.y.z-bin.zip
cd nifi-x.y.z

 

  1.  
  2. 실행:
./bin/nifi.sh start

 

  1.  
  2. 브라우저 접속: http://localhost:8080/nifi

 

중지하려면 ./bin/nifi.sh stop 실행

 

 

🔸 4. Linux 서버 환경 (Ubuntu 등)

 

  • 위 macOS와 거의 동일
  • systemd 서비스 등록도 가능하며, /etc/systemd/system/nifi.service 구성으로 자동화 가능

 

 

최초 실행 시 주의할 점

 

  • 방화벽이나 보안 소프트웨어가 8080 포트를 차단하는 경우 웹 UI 접속이 되지 않을 수 있습니다.
  • 일부 보안 환경에서는 run-as-root가 막혀 있을 수 있으니 일반 사용자 계정으로 실행하세요.

 

 

Apache NiFi의 웹 UI 구조 빠르게 훑어보기

 

NiFi의 가장 큰 장점 중 하나는 웹 기반 시각적 UI입니다. 처음 실행하면 아래와 같은 화면을 보게 됩니다.

 

 

1. 캔버스(Canvas)

 

  • 흐름을 설계하는 공간입니다.
  • Processor, Connection, Group 등을 배치하는 주 무대

 

 

2. 메뉴 바 상단

 

  • Save, Start, Stop, Settings 등을 제어할 수 있는 버튼 영역

 

 

3. 좌측 도구 패널

 

  • Processor, Input/Output Port, Funnel, Group 등 주요 요소 삽입

 

 

4. 오른쪽 Flow Settings

 

  • 전체 플로우 요약, 설정, 변수 등 구성

 

 

5. 하단 상태창

 

  • 시스템 상태, 메모리 사용량, 쓰루풋 등을 실시간 확인 가능

 

 

설치 후 확인해볼 기본 동작

 

  1. Processor 추가
    • 마우스 우클릭 → “Add Processor” 선택
    • 예: GenerateFlowFile, LogAttribute 추가
  2.  
  3. Processor 간 연결
    • 마우스로 연결 → 조건 선택 → OK
  4.  
  5. 흐름 실행
    • 각 Processor를 선택하고 Start 버튼 클릭
  6.  
  7. 모니터링
    • FlowFile 경로, 에러 발생 여부 실시간 확인
  8.  

 

이 기본 흐름은 3화에서 실습 예제로 다룰 예정입니다.

 

 

보안을 강화하고 싶다면?

 

  • 기본 설치 상태에서는 인증/암호화가 적용되지 않은 상태입니다.
  • 실무에서는 nifi.properties를 수정해 HTTPS, 사용자 인증(RBAC), LDAP 연동 등을 설정해야 합니다.
  • 이는 고급 설정으로 13화에서 자세히 다룰 예정입니다.

 

 

설치 확인 체크리스트

항목확인

Java 8 이상 설치됨 ✅
nifi 실행 가능 ✅
브라우저에서 접속됨 (localhost:8080/nifi) ✅
Processor 추가/연결 테스트 완료 ✅

 

 

 

마무리 – 이제 실습 준비가 되었습니다

 

설치를 완료하고 UI 구조를 이해했다면, 이제 진짜 NiFi의 강력함을 느낄 수 있는 데이터 흐름 설계 실습을 시작할 차례입니다.

다음 글에서는 직접 Processor를 연결해보며, FlowFile의 동작을 실시간으로 관찰해보겠습니다.

 

 

다음 글 예고

 

Apache NiFi 시리즈 3회 - FlowFile과 Processor를 활용한 데이터 흐름 설계 실습

 

  • FlowFile 구조와 메타데이터 개념
  • GenerateFlowFile → LogAttribute → PutFile 흐름 실습
  • 실시간 데이터 흐름 시각화 경험하기
728x90