빠른 시작: Azure CLI를 사용하여 이벤트 허브 만들기
빠른 시작에서 Azure CLI를 사용하여 이벤트 허브를 만듭니다.
Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.
필수 조건
Azure Cloud Shell에서 Bash 환경을 사용합니다. 자세한 내용은 Azure Cloud Shell의 Bash에 대한 빠른 시작을 참조하세요.
CLI 참조 명령을 로컬에서 실행하려면 Azure CLI를 설치합니다. Windows 또는 macOS에서 실행 중인 경우 Docker 컨테이너에서 Azure CLI를 실행하는 것이 좋습니다. 자세한 내용은 Docker 컨테이너에서 Azure CLI를 실행하는 방법을 참조하세요.
로컬 설치를 사용하는 경우 az login 명령을 사용하여 Azure CLI에 로그인합니다. 인증 프로세스를 완료하려면 터미널에 표시되는 단계를 수행합니다. 다른 로그인 옵션은 Azure CLI를 사용하여 로그인을 참조하세요.
메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 확장에 대한 자세한 내용은 Azure CLI에서 확장 사용을 참조하세요.
az version을 실행하여 설치된 버전과 종속 라이브러리를 찾습니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.
- 이 문서에는 Azure CLI 버전 2.0.4 이상이 필요합니다. Azure Cloud Shell을 사용하는 경우 최신 버전이 이미 설치되어 있습니다.
리소스 그룹 만들기
다음 명령을 실행하여 리소스 그룹을 만듭니다. 리소스 그룹은 Azure 리소스에 대한 논리적 컬렉션입니다. 모든 리소스는 리소스 그룹에서 배포 및 관리됩니다.
복사를 선택하여 명령을 복사하고 Cloud Shell 또는 CLI 창에 붙여넣고 실행합니다. 원하는 경우 리소스 그룹 이름 및 지역을 업데이트합니다.
rgName="contosorg$RANDOM"
region="eastus"
az group create --name $rgName --location $region
그러면 다음과 같은 출력이 표시됩니다. name
필드에 리소스 그룹 이름이 표시되며 난수가 $RANDOM
으로 바꿉니다.
{
"id": "/subscriptions/0000000000-0000-0000-0000-000000000000000/resourceGroups/contosorg32744",
"location": "eastus",
"managedBy": null,
"name": "contosorg32744",
"properties": {
"provisioningState": "Succeeded"
},
"tags": null,
"type": "Microsoft.Resources/resourceGroups"
}
Event Hubs 네임스페이스 만들기
다음 명령을 실행하여 Event Hubs 네임스페이스를 만듭니다. Event Hubs 네임스페이스는 정규화된 도메인 이름으로 참조되는 고유한 범위 지정 컨테이너를 제공하며, 하나 이상의 이벤트 허브를 만듭니다. 원하는 경우 네임스페이스의 이름을 업데이트합니다.
# Create an Event Hubs namespace. Specify a name for the Event Hubs namespace.
namespaceName="contosoehubns$RANDOM"
az eventhubs namespace create --name $namespaceName --resource-group $rgName -l $region
그러면 다음과 같은 출력이 표시됩니다. name
필드에 네임스페이스의 이름이 표시됩니다.
{
"createdAt": "2023-03-13T20:28:53.037Z",
"disableLocalAuth": false,
"id": "/subscriptions/0000000000-0000-0000-0000-0000000000000000/resourceGroups/contosorg32744/providers/Microsoft.EventHub/namespaces/contosoehubns17861",
"isAutoInflateEnabled": false,
"kafkaEnabled": true,
"location": "East US",
"maximumThroughputUnits": 0,
"metricId": "0000000000-0000-0000-0000-0000000000000000:contosoehubns17861",
"minimumTlsVersion": "1.2",
"name": "contosoehubns17861",
"provisioningState": "Succeeded",
"publicNetworkAccess": "Enabled",
"resourceGroup": "contosorg32744",
"serviceBusEndpoint": "https://contosoehubns17861.servicebus.windows.net:443/",
"sku": {
"capacity": 1,
"name": "Standard",
"tier": "Standard"
},
"status": "Active",
"tags": {},
"type": "Microsoft.EventHub/Namespaces",
"updatedAt": "2023-03-13T20:29:45.637Z",
"zoneRedundant": false
}
이벤트 허브 만들기
다음 명령을 실행하여 이벤트 허브를 만듭니다. 원하는 경우 이벤트 허브의 이름을 업데이트합니다.
# Create an event hub. Specify a name for the event hub.
eventhubName="contosoehub$RANDOM"
az eventhubs eventhub create --name $eventhubName --resource-group $rgName --namespace-name $namespaceName
그러면 다음과 같은 출력이 표시됩니다. name
필드에 이벤트 허브의 이름이 표시됩니다.
{
"captureDescription": null,
"createdAt": "2023-03-13T20:32:04.457000+00:00",
"id": "/subscriptions/000000000-0000-0000-0000-00000000000000/resourceGroups/contosorg32744/providers/Microsoft.EventHub/namespaces/contosoehubns17861/eventhubs/contosoehub23255",
"location": "eastus",
"messageRetentionInDays": 7,
"name": "contosoehub23255",
"partitionCount": 4,
"partitionIds": [
"0",
"1",
"2",
"3"
],
"resourceGroup": "contosorg32744",
"status": "Active",
"systemData": null,
"type": "Microsoft.EventHub/namespaces/eventhubs",
"updatedAt": "2023-03-13T20:32:04.727000+00:00"
}
축하합니다! Azure CLI를 사용하여 Event Hubs 네임스페이스와, 그 네임스페이스 안에 이벤트 허브를 만들었습니다.
리소스 정리
이벤트 보내기 및 수신을 테스트할 수 있도록 이 이벤트 허브를 유지하려면 이 섹션을 무시합니다. 그렇지 않으면 다음 명령을 실행하여 리소스 그룹을 삭제합니다. 이 명령은 리소스 그룹의 모든 리소스 및 리소스 그룹 자체를 삭제합니다.
az group delete --name $rgName
다음 단계
이 문서에서는 리소스 그룹, Event Hubs 네임스페이스 및 이벤트 허브를 만들었습니다. 이벤트 허브에서 이벤트를 보내거나 받기 위한 단계별 지침은 이벤트 보내기 및 받기 자습서를 참조하세요.
- .NET Core
- Java
- Python
- JavaScript
- Go
- C(보내기 전용)
- Apache Storm(받기 전용)