-
Apache NiFi 시리즈 2회 - Apache NiFi 설치 및 환경 구성 가이드기술과 산업/AI 2025. 5. 7. 16:15728x90
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 기준 설치
- 압축 해제: nifi-x.y.z-bin.zip 압축을 원하는 폴더에 풉니다
- 실행: bin 디렉토리로 이동하여 run-nifi.bat 실행
- 브라우저에서 접속: http://localhost:8080/nifi 입력
🔸 3. macOS 기준 설치
- 터미널에서 압축 해제:
unzip nifi-x.y.z-bin.zip cd nifi-x.y.z
- 실행:
./bin/nifi.sh start
- 브라우저 접속: 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. 하단 상태창
- 시스템 상태, 메모리 사용량, 쓰루풋 등을 실시간 확인 가능
설치 후 확인해볼 기본 동작
- Processor 추가
- 마우스 우클릭 → “Add Processor” 선택
- 예: GenerateFlowFile, LogAttribute 추가
- Processor 간 연결
- 마우스로 연결 → 조건 선택 → OK
- 흐름 실행
- 각 Processor를 선택하고 Start 버튼 클릭
- 모니터링
- FlowFile 경로, 에러 발생 여부 실시간 확인
이 기본 흐름은 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'기술과 산업 > AI' 카테고리의 다른 글
AI 모델 만들기 시리즈 7화 – 모델을 더 똑똑하게: 하이퍼파라미터 튜닝과 교차검증 실습 (0) 2025.05.09 Whisper 시리즈 12화 – Whisper와 GPT로 만드는 자동 회의록 생성 시스템 (0) 2025.05.09 Apache NiFi 시리즈 1회 - Apache NiFi란 무엇인가 (0) 2025.05.07 분야별 데이터 수집 전략 가이드 시리즈 - 3화. 서울 열린데이터광장 실전 활용법: 위치 기반 데이터로 인사이트 만들기 (0) 2025.05.07 데이터 수집과 EDA 전략 시리즈 – 3화. 결측치와 이상치 탐지 전략: 데이터의 허점을 읽어내는 기술 (1) 2025.05.07