ABOUT ME

-

Today
-
Yesterday
-
Total
-
  • Apache NiFi 시리즈 2회 - Apache NiFi 설치 및 환경 구성 가이드
    기술과 산업/AI 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
Designed by Tistory.