windows에 kafka ui 설치하기

0. 요약

• kafka ui 설치 참고 URL: https://github.com/provectus/kafka-ui
• 저의 설치 환경: Windows 11
• 선행 작업: windows에 docker를 설치합니다. (docker 명령어를 사용하기 위해서)
  • windows에 docker설치 참고: https://herojoon-dev.tistory.com/120?category=964211

1) docker image로 된 kafka ui를 다운로드 받습니다.

2) 위에서 다운로드 받은 kafka ui의 docker image를 docker 명령어를 이용하여 띄웁니다.

3) kafka 연결 정보를 입력하여 kafka ui를 다시 띄웁니다.

4) kafka ui에서 Topic 생성하기

 

1. docker 명령어로 kafka ui 다운로드 받기

• Download Link: https://hub.docker.com/r/provectuslabs/kafka-ui

위 다운로드 링크로 접속하면 아래 kafka ui docker image를 다운로드 받을 수 있는 명령어를 제공합니다.

아래 명령어를 복사하여 cmd창에 입력해줍니다.

docker pull provectuslabs/kafka-ui

 

- kafka ui docker image 다운로드 확인 -

cmd 창에 아래 명령어를 입력하여 kafka ui docker image가 잘 다운로드되었는지 확인합니다.

docker images

 

2. docker 명령어로 kafka ui 띄우기

cmd 창에 아래 명령어를 입력하여 kafka ui를 띄워줍니다.

docker run -p 8080:8080 \
	-e KAFKA_CLUSTERS_0_NAME=local \
	-e KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS=kafka:9092 \
	-d provectuslabs/kafka-ui:latest

windows cmd에서는 줄바꿈이 ^으로 사용되오니 아래 명령어를 입력해줍니다.

docker run -p 8080:8080 ^
	-e KAFKA_CLUSTERS_0_NAME=local ^
	-e KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS=kafka:9092 ^
	-d provectuslabs/kafka-ui:latest

8080의 경우는 HTTP 포트로 많이 쓰이므로 다른 애플리케이션 작업과 함께 사용을 위해서

kafka ui를 다른 포트로 띄우는게 편리합니다.

다른 포트로 띄우기 위해서는 아래 위치에 원하는 포트 입력 후 실행시켜 줍니다.

docker run -p 원하는 포트로 입력:8080 ^
	-e KAFKA_CLUSTERS_0_NAME=local ^
	-e KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS=kafka:9092 ^
	-d provectuslabs/kafka-ui:latest
    
ex)    
docker run -p 9095:8080 ^
	-e KAFKA_CLUSTERS_0_NAME=local ^
	-e KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS=kafka:9092 ^
	-d provectuslabs/kafka-ui:latest

 

kafka 접속정보가 연결되지 않은 상태의 kafka ui가 띄워졌습니다.

 

3. kafka 연결 정보를 입력하여 kafka ui 띄우기

저는 제 컴퓨터(로컬환경)에 kafka를 실행시켜놓고 연결주소인 localhost:9092를 아래 입력하여 kafka ui를 띄워보겠습니다.  클러스터명은 dev-cluster로 하였습니다.

위에서 띄웠던 kafka ui를 종료 후 접속 정보를 입력한 아래 명령어로 다시 띄워줍니다.

- 로컬에서 kafka 종료하기 (아래 더보기 펼쳐서 보기) -

# kafka ui 종료하는 방법

# 1. docker image로 띄운 kafka ui docker 컨테이너 조회

docker container ls

 

# 2. docker 컨테이너 종료

docker rm -f 컨테이너ID

 

 

# 3. docker log 확인

docker logs 컨테이너ID

docker run -p 원하는 포트로 입력:8080 ^
	-e KAFKA_CLUSTERS_0_NAME=카프카 클러스터명 ^
	-e KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS=카프카 연결주소:카프카 포트 ^
	-d provectuslabs/kafka-ui:latest
    
ex)    
docker run -p 9095:8080 ^
	-e KAFKA_CLUSTERS_0_NAME=dev-cluster ^
	-e KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS=localhost:9092 ^
	-d provectuslabs/kafka-ui:latest

 

변경했던 클러스터명과 접속주소를 반영하여 정상적으로 kafka ui가 띄워졌습니다.

 

4. kafka ui에서 Topic 생성하기

kafka ui에서는 kafka 메시지 전달에 필요한 Topic을 생성할 수도 있습니다.