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

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

C# 클라이언트 라이브러리를 설치하고 Pulsar 클러스터에 연결하는 방법을 정리해볼게요. .NET Core SDK와 dotnet CLI만 있다면 NuGet 패키지 DotPulsar를 추가하는 것만으로 준비가 끝나요. 프로토콜 URL로 클러스터를 지정하는 법까지 확인해보죠.

출처: 문서

본문

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

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

이 섹션은 dotnet CLI를 통해 Pulsar C# 클라이언트 라이브러리를 설치하는 방법을 설명해요. 또는 Visual Studio를 통해 Pulsar C# 클라이언트 라이브러리를 설치할 수도 있어요. Visual Studio 2017부터 dotnet CLI는 .NET Core 관련 워크로드와 함께 자동으로 설치돼요. 자세한 내용은 Microsoft 문서를 참고하세요.

dotnet CLI로 Pulsar C# 클라이언트 라이브러리를 설치하려면 다음 단계를 따르세요.

  1. .NET Core SDK 설치 — dotnet CLI를 제공해요.
  2. 프로젝트 생성 — 프로젝트용 폴더를 만들고, 터미널 창을 열어 새 폴더로 이동한 뒤 다음 명령으로 프로젝트를 만들어요.
dotnet new console

dotnet run을 사용해 앱이 제대로 만들어졌는지 테스트해요.

  1. DotPulsar NuGet 패키지 추가 — 다음 명령으로 DotPulsar 패키지를 설치해요.
dotnet add package DotPulsar

명령이 완료된 후 .csproj 파일을 열면 추가된 참조가 보여요.

<ItemGroup>
  <PackageReference Include="DotPulsar" Version="2.0.1" />
</ItemGroup>

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)