C++ 클라이언트 라이브러리 설정

C++ 클라이언트 라이브러리 설정 (C++ client setup)

C++ 클라이언트 라이브러리를 설치하고 Pulsar 클러스터에 연결하는 방법을 정리해볼게요. 운영 체제별로 Homebrew, Debian(Deb), RPM, Alpine(APK) 패키지를 제공하니 환경에 맞는 방법을 고르면 돼요. 마지막 단계에서는 프로토콜 URL로 클러스터를 지정하는 법까지 확인할 수 있어요.

출처: 문서

본문

Pulsar에서 C++ 클라이언트 라이브러리를 설정하려면 다음 단계를 완료하세요.

1단계: C++ 클라이언트 라이브러리 설치 (Step 1: Install C++ client library)

다음 방법 중 하나를 사용해 Pulsar C++ 클라이언트를 설치해요.

Brew

Homebrew로 최신 태그 버전의 라이브러리와 헤더를 설치해요.

brew install libpulsar

Deb

  • Deb 패키지 중 하나를 다운로드해요: client, client-devel
wget https://archive.apache.org/dist/pulsar/pulsar-client-cpp-4.2.0/deb-x86_64/apache-pulsar-client.deb

이 패키지는 공유 라이브러리 libpulsar.so를 포함해요.

wget https://archive.apache.org/dist/pulsar/pulsar-client-cpp-4.2.0/deb-x86_64/apache-pulsar-client-dev.deb

이 패키지는 정적 라이브러리 libpulsar.a, libpulsarwithdeps.a와 C/C++ 헤더를 포함해요.

  • 다음 명령으로 패키지를 설치해요:
apt install ./apache-pulsar-client*.deb

이제 /usr/lib 디렉터리 아래에 Pulsar C++ 클라이언트 라이브러리가 설치된 것을 볼 수 있어요.

RPM

  • RPM 패키지 중 하나를 다운로드해요: client, client-debuginfo, client-devel
wget https://archive.apache.org/dist/pulsar/pulsar-client-cpp-4.2.0/rpm-x86_64/x86_64/apache-pulsar-client-4.2.0-1.x86_64.rpm

이 패키지는 공유 라이브러리 libpulsar.so를 포함해요.

wget https://archive.apache.org/dist/pulsar/pulsar-client-cpp-4.2.0/rpm-x86_64/x86_64/apache-pulsar-client-debuginfo-4.2.0-1.x86_64.rpm

이 패키지는 libpulsar.so의 디버그 심볼을 포함해요.

wget https://archive.apache.org/dist/pulsar/pulsar-client-cpp-4.2.0/rpm-x86_64/x86_64/apache-pulsar-client-devel-4.2.0-1.x86_64.rpm

이 패키지는 정적 라이브러리 libpulsar.a, libpulsarwithdeps.a와 C/C++ 헤더를 포함해요.

  • 다음 명령으로 패키지를 설치해요:
rpm -ivh apache-pulsar-client*.rpm

이제 /usr/lib 디렉터리 아래에 Pulsar C++ 클라이언트 라이브러리가 설치된 것을 볼 수 있어요.

Pulsar 클라이언트를 시작할 때 "libpulsar.so: cannot open shared object file: No such file or directory" 같은 에러가 발생하면 ldconfig를 먼저 실행해야 해요.

APK

apk add --allow-untrusted ./apache-pulsar-client-*.apk

2단계: Pulsar 클러스터에 연결 (Step 2: Connect to Pulsar cluster)

클라이언트 라이브러리로 Pulsar에 연결하려면 Pulsar 프로토콜 URL을 지정해야 해요. 특정 클러스터에 Pulsar 프로토콜 URL을 할당하고 pulsar 체계를 사용할 수 있어요. 기본 포트 6650을 사용하는 localhost의 예시는 다음과 같아요.

pulsar://localhost:6650

여러 브로커가 있다면 IP:port를 쉼표로 구분해요.

pulsar://localhost:6550,localhost:6651,localhost:6652

mTLS 인증을 사용한다면 체계에 +ssl을 추가해요.

pulsar+ssl://pulsar.us-west.example.com:6651

더 알아보기 (Learn more)