이 빠른 시작에서는 Azure CLI를 사용하여 Azure Web PubSub 인스턴스에 연결하고 연결된 클라이언트에 메시지를 게시하는 방법을 보여 줍니다.
Azure 계정이 없는 경우 시작하기 전에 체험 계정을 만듭니다.
필수 조건
Azure Cloud Shell에서 Bash 환경을 사용합니다. 자세한 내용은 Azure Cloud Shell 시작을 참조하세요.
CLI 참조 명령을 로컬에서 실행하려면 Azure CLI를 설치합니다. Windows 또는 macOS에서 실행 중인 경우 Docker 컨테이너에서 Azure CLI를 실행하는 것이 좋습니다. 자세한 내용은 Docker 컨테이너에서 Azure CLI를 실행하는 방법을 참조하세요.
로컬 설치를 사용하는 경우 az login 명령을 사용하여 Azure CLI에 로그인합니다. 인증 프로세스를 완료하려면 터미널에 표시되는 단계를 수행합니다. 다른 로그인 옵션은 Azure CLI를 사용하여 Azure에 인증을 참조하세요.
메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 확장에 대한 자세한 내용은 Azure CLI로 확장 사용 및 관리를 참조하세요.
az version을 실행하여 설치된 버전과 종속 라이브러리를 찾습니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.
- 이 빠른 시작에는 Azure CLI 버전 2.22.0 이상이 필요합니다. Azure Cloud Shell을 사용하는 경우 최신 버전이 이미 설치되어 있습니다.
리소스 그룹 만들기
리소스 그룹은 Azure 리소스가 배포 및 관리되는 논리적 컨테이너입니다.
az group create 명령을 사용하여 myResourceGroup 위치에서 eastus이라는 리소스 그룹을 만듭니다.
az group create --name myResourceGroup --location EastUS
Web PubSub 인스턴스 만들기
az extension add를 실행하여 webpubsub 확장을 현재 버전으로 설치하거나 업그레이드합니다.
az extension add --upgrade --name webpubsub
Azure CLI az webpubsub create 명령을 사용하여 만든 리소스 그룹에 Web PubSub를 만듭니다. 다음 명령은 EastUS의 리소스 그룹 myResourceGroup 아래에 무료 Web PubSub 리소스를 만듭니다.
중요합니다
각 Web PubSub 리소스에는 고유한 이름이 있어야 합니다. 다음 예제에서 <your-unique-resource-name>을 Web PubSub의 이름으로 바꿉니다.
az webpubsub create --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --location "EastUS" --sku Free_F1
이 명령의 출력에는 새로 만든 리소스의 속성이 표시됩니다. 아래에 나열된 두 개의 속성을 기록합니다.
-
리소스 이름: 위의
--name매개 변수에 제공한 이름입니다. -
hostName: 이 예제에서 호스트 이름은
<your-unique-resource-name>.webpubsub.azure.com/입니다.
이때 Azure 계정은 이 새 리소스에서 모든 작업을 수행할 권한이 있는 유일한 계정입니다.
인스턴스 재생
해당 서비스에 연결
Azure CLI az webpubsub client 명령을 사용하여 이전 단계에서 만든 서비스에 대한 WebSocket 클라이언트 연결을 시작하고 다음 정보를 제공합니다.
- 허브 이름: 1~127자로 구성된 문자열입니다. 영문자
(a-z, A-Z)로 시작하고 영숫자(0-9, a-z, A-Z)문자 또는 밑줄(_)만 포함해야 합니다.
Hub는 연결된 WebSocket 연결의 논리적 집합입니다. 개념에 대한 자세한 내용은 Hubs, 그룹 및 연결 정보를 참조하세요.
중요합니다
<your-unique-resource-name>을 이전 단계에서 만든 Web PubSub 리소스의 이름으로 바꿉니다.
- Hub 이름: myHub1.
- 리소스 그룹 이름: myResourceGroup
- 사용자 ID: user1
az webpubsub client start --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --hub-name "myHub1" --user-id "user1"
명령이 Web PubSub 서비스에 대한 WebSocket 연결을 설정하고, 이제 성공적으로 연결되었음을 나타내는 JSON 메시지를 받고, 다음과 같은 고유한 connectionId로 할당되었음을 확인할 수 있습니다.
{"type":"system","event":"connected","userId":"user1","connectionId":"<your_unique_connection_id>"}
이 기능을 활용하고 joingroup <group-name>을 사용하여 그룹에 참가하고 sendtogroup <group-name>을 사용하여 그룹에 메시지를 보냅니다.
joingroup group1
sendtogroup group1 hello
메시지 게시 및 클라이언트 관리
Azure CLI는 클라이언트 연결을 관리하는 az webpubsub service 명령도 제공합니다.
또 다른 CLI 명령을 열어 클라이언트로 메시지를 브로드캐스트할 수 있습니다.
- Hub 이름: myHub1.
- 리소스 그룹 이름: myResourceGroup
az webpubsub service broadcast --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --hub-name "myHub1" --payload "Hello World"
이전 CLI 명령으로 다시 전환하면 클라이언트가 메시지를 받는 것을 확인할 수 있습니다.
{"type":"message","from":"server","dataType":"text","data":"Hello World"}
--help 옵션을 사용하여 사용 가능한 모든 명령을 나열하고 나열된 명령을 사용할 수도 있습니다.
az webpubsub service --help
다음 단계
이 빠른 시작에서는 Web PubSub 서비스에 연결하는 방법과 연결된 클라이언트에 메시지를 게시하는 방법에 대한 기본 개념을 알아보았습니다.
실제 애플리케이션에서는 다양한 언어의 SDK를 사용하여 고유한 애플리케이션을 빌드할 수 있습니다. 또한 서버리스 애플리케이션을 쉽게 빌드할 수 있도록 함수 확장도 제공합니다.
다음 리소스를 사용하여 사용자 고유의 애플리케이션 빌드를 시작합니다.