📖 카프카 시리즈 2편 - 카프카 실습 1 (Docker를 활용한 설치 및 환경 구성)

✅ 실습 목표

이번 글에서는 macOS 환경에서 Docker를 활용하여 간단하게 Kafka 환경을 구성해 보겠습니다.

📌 사전 준비사항

macOS 환경
Docker Desktop 설치 (Docker Desktop 다운로드)

Docker가 설치되었는지 확인:

docker --version

📌 Docker Compose를 이용한 Kafka 설치

다음과 같이 docker-compose.yml 파일을 만듭니다.

version: '3'
services:
  zookeeper:
    image: confluentinc/cp-zookeeper:latest
    environment:
      ZOOKEEPER_CLIENT_PORT: 2181

  kafka:
    image: confluentinc/cp-kafka:latest
    ports:
      - "9092:9092"
    environment:
      KAFKA_BROKER_ID: 1
      KAFKA_ZOOKEEPER_CONNECT: zookeeper:2181
      KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://localhost:9092
      KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR: 1
    depends_on:
      - zookeeper

파일 생성 후, 터미널에서 Docker Compose를 실행합니다.

docker compose up -d

정상적으로 실행되었는지 확인합니다.

docker compose ps

📌 Kafka 설치 확인 및 테스트

Kafka 컨테이너 내부로 들어가서 기본 동작을 확인합니다.

docker compose exec kafka bash

컨테이너 내부에서 토픽을 생성해 봅니다.

kafka-topics --create --topic test-topic --bootstrap-server localhost:9092

생성된 토픽 확인:

kafka-topics --list --bootstrap-server localhost:9092

정상적으로 토픽이 생성되었다면 아래처럼 출력됩니다.

test-topic

📌 한줄 코멘트

"이제 간단하게 Kafka 환경을 구축했으니, 다음 편에서는 자바(Spring)로 Kafka Producer와 Consumer를 만들어 보겠습니다."

다음 편에서는 본격적으로 Spring Boot 환경에서 Kafka를 이용한 메시징 실습을 진행합니다.