윈도우에서 Kafka 로컬 환경 설정하기

윈도우에서 Kafka 로컬 환경 설정하기

2025. 5. 6. 14:46

매번 환경 설정하는 과정을 다시 찾는 게 어려워 나중에 다시 볼 수 있도록 Kafka 로컬 환경 설정 과정을 정리한다.

 

 

📌 Kafka 로컬 설치 및 설정

1.Kafka 다운로드 및 압축 해제

https://kafka.apache.org/downloads

일단 Kafka 공식 사이트에서 받은 압축 파일을 해제해준다.

tar -xzf kafka_2.13-4.0.0.tgz

2.데이터 저장 디렉토리 준비

Kafka가 로그 데이터를 저장할 디렉토리를 따로 만들어 둔다.
(나는 C 드라이브 경로에 두 개의 디렉토리를 둘 다 배치하였다.)

C:\kafka-data

 

 

배포할 때는 서버 환경에 맞게 꼭 바꿔야한다.

3.Kafka 실행 스크립트 위치로 이동

명령 프롬프트에서 Kafka 실행 파일이 있는 곳으로 이동한다.

cd C:\kafka_2.13-4.0.0\bin\windows

 

4.클러스터 UUID 생성

Kafka 클러스터를 위한 UUID를 만들어준다.

call kafka-storage.bat random-uuid

실제 CMD에서 클러스트 UUID가 생성된 모습이다. 앞의 ERROR는 무시해도 지장 없다.

5.server.properties 파일 수정

server.properties를 열어서 설정을 추가한다. 나중에 배포할 땐 환경에 맞춰서 조정이 필요하다.

# 역할 설정
process.roles=broker,controller
node.id=1
controller.quorum.voters=1@localhost:9093

# 리스너 설정
listeners=PLAINTEXT://localhost:9092,CONTROLLER://localhost:9093
inter.broker.listener.name=PLAINTEXT

# 데이터(로그) 저장 위치
log.dirs=C:/kafka-data

 

6.메타데이터 포맷

생성한 UUID로 Kafka 메타데이터를 초기화한다.

set CLUSTER_ID=OLj-Aif6T6-fowPdLw0GBQ
call kafka-storage.bat format --cluster-id %CLUSTER_ID% --config "C:\kafka_2.13-4.0.0\config\server.properties"

 

1.지정을 해준다.

2.생성한 UUID로 kafka 메타데이터를 초기화 하였다.

7.Kafka 브로커 실행

이제 Kafka 브로커를 실행해서 클러스터를 시작한다.

call kafka-server-start.bat "C:\kafka_2.13-4.0.0\config\server.properties"

실제로 실행된 모습이다.

 

출처: https://ujacheong2.tistory.com/entry/%EC%9C%88%EB%8F%84%EC%9A%B0%EC%97%90%EC%84%9C-Kafka-%EB%A1%9C%EC%BB%AC-%ED%99%98%EA%B2%BD-%EC%84%A4%EC%A0%95%ED%95%98%EA%B8%B0#google_vignette