Skip to content

Commit 2e21ce4

Browse files
committed
Polish quick starts
1 parent 16f54c3 commit 2e21ce4

18 files changed

+1129
-44
lines changed
Lines changed: 123 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,138 @@
11
---
2-
title: Quickstart - Create a Web PubSub instance from Azure portal
3-
description: Quickstart showing how to create a Web PubSub instance from Azure portal
4-
author: yjin81
5-
ms.author: yajin1
2+
title: Create a Web PubSub resource
3+
description: Quickstart showing how to create a Web PubSub resource from Azure portal, using Azure CLI and a Bicep template
4+
author: kevinguo-ed
5+
ms.author: kevinguo
66
ms.service: azure-web-pubsub
77
ms.topic: quickstart
8-
ms.date: 11/08/2021
8+
ms.date: 03/13/2023
99
ms.custom: mode-ui
10+
zone_pivot_groups: azure-web-pubsub-create-resource-methods
1011
---
12+
# Create a Web PubSub resource
1113

12-
# Quickstart: Create a Web PubSub instance from Azure portal
14+
## Prerequisites
15+
> [!div class="checklist"]
16+
> * An Azure account with an active subscription. [Create a free Azure account](https://azure.microsoft.com/free/), if don't have one already.
1317
14-
This quickstart shows you how to create Azure Web PubSub instance from Azure portal.
18+
> [!TIP]
19+
> Web PubSub includes a generous **free tier** that can be used for testing and production purposes.
20+
21+
22+
::: zone pivot="method-azure-portal"
23+
## Create a resource from Azure portal
1524

16-
[!INCLUDE [quickstarts-free-trial-note](../../includes/quickstarts-free-trial-note.md)]
25+
1. Select the New button found on the upper left-hand corner of the Azure portal. In the New screen, type **Web PubSub** in the search box and press enter.
1726

18-
[!INCLUDE [create-instance-portal](includes/create-instance-portal.md)]
27+
:::image type="content" source="./media/create-instance-portal/search-web-pubsub-in-portal.png" alt-text="Screenshot of searching the Azure Web PubSub in portal.":::
1928

20-
## Try the newly created instance
29+
2. Select **Web PubSub** from the search results, then select **Create**.
2130

22-
> [!div class="nextstepaction"]
23-
> [Try the instance from the browser](./quickstart-live-demo.md#try-the-instance-with-an-online-demo)
31+
3. Enter the following settings.
2432

25-
> [!div class="nextstepaction"]
26-
> [Try the instance with Azure CLI](./quickstart-cli-try.md#play-with-the-instance)
33+
| Setting | Suggested value | Description |
34+
| ------------ | ------- | -------------------------------------------------- |
35+
| **Resource name** | Globally unique name | The globally unique Name that identifies your new Web PubSub service instance. Valid characters are `a-z`, `A-Z`, `0-9`, and `-`. |
36+
| **Subscription** | Your subscription | The Azure subscription under which this new Web PubSub service instance is created. |
37+
| **[Resource Group]** | myResourceGroup | Name for the new resource group in which to create your Web PubSub service instance. |
38+
| **Location** | West US | Choose a [region](https://azure.microsoft.com/regions/) near you. |
39+
| **Pricing tier** | Free | You can first try Azure Web PubSub service for free. Learn more details about [Azure Web PubSub service pricing tiers](https://azure.microsoft.com/pricing/details/web-pubsub/) |
40+
| **Unit count** | - | Unit count specifies how many connections your Web PubSub service instance can accept. Each unit supports 1,000 concurrent connections at most. It is only configurable in the Standard tier. |
41+
42+
:::image type="content" source="./media/howto-develop-create-instance/create-web-pubsub-instance-in-portal.png" alt-text="Screenshot of creating the Azure Web PubSub instance in portal.":::
43+
44+
4. Select **Create** to provision your Web PubSub resource.
45+
::: zone-end
46+
47+
48+
::: zone pivot="method-azure-cli"
49+
## Create a resource using Azure CLI
50+
51+
The [Azure CLI](/cli/azure) is a set of commands used to create and manage Azure resources. The Azure CLI is available across Azure services and is designed to get you working quickly with Azure, with an emphasis on automation.
52+
53+
> [!IMPORTANT]
54+
> This quickstart requires Azure CLI of version 2.22.0 or higher.
55+
56+
## Create a resource group
57+
58+
[!INCLUDE [Create a resource group](includes/cli-rg-creation.md)]
59+
60+
## Create a resource
61+
62+
[!INCLUDE [Create a Web PubSub instance](includes/cli-awps-creation.md)]
63+
::: zone-end
64+
65+
66+
::: zone pivot="method-bicep"
67+
## Create a resource using Bicep template
68+
69+
[!INCLUDE [About Bicep](../../includes/resource-manager-quickstart-bicep-introduction.md)]
70+
71+
## Review the Bicep file
72+
73+
The template used in this quickstart is from [Azure Quickstart Templates](/samples/azure/azure-quickstart-templates/azure-web-pubsub/).
74+
75+
:::code language="bicep" source="~/quickstart-templates/quickstarts/microsoft.web/azure-web-pubsub/main.bicep":::
76+
77+
## Deploy the Bicep file
2778

28-
## Next steps
79+
1. Save the Bicep file as **main.bicep** to your local computer.
80+
1. Deploy the Bicep file using either Azure CLI or Azure PowerShell.
2981

30-
In real-world applications, you can use SDKs in various languages build your own application. We also provide Function extensions for you to build serverless applications easily.
82+
# [CLI](#tab/CLI)
3183

32-
[!INCLUDE [next step](includes/include-next-step.md)]
84+
```azurecli
85+
az group create --name exampleRG --location eastus
86+
az deployment group create --resource-group exampleRG --template-file main.bicep
87+
```
88+
89+
# [PowerShell](#tab/PowerShell)
90+
91+
```azurepowershell
92+
New-AzResourceGroup -Name exampleRG -Location eastus
93+
New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep
94+
```
95+
96+
---
97+
98+
When the deployment finishes, you should see a message indicating the deployment succeeded.
99+
100+
## Review deployed resources
101+
102+
Use the Azure portal, Azure CLI, or Azure PowerShell to list the deployed resources in the resource group.
103+
104+
# [CLI](#tab/CLI)
105+
106+
```azurecli-interactive
107+
az resource list --resource-group exampleRG
108+
```
109+
110+
# [PowerShell](#tab/PowerShell)
111+
112+
```azurepowershell-interactive
113+
Get-AzResource -ResourceGroupName exampleRG
114+
```
115+
116+
---
117+
## Clean up resources
118+
119+
When no longer needed, use the Azure portal, Azure CLI, or Azure PowerShell to delete the resource group and its resources.
120+
121+
# [CLI](#tab/CLI)
122+
123+
```azurecli-interactive
124+
az group delete --name exampleRG
125+
```
126+
127+
# [PowerShell](#tab/PowerShell)
128+
129+
```azurepowershell-interactive
130+
Remove-AzResourceGroup -Name exampleRG
131+
```
132+
::: zone-end
133+
134+
## Next step
135+
Now that you have created a resource, you are ready to put it to use.
136+
Next, you will learn how to subscribe and publish messages among your clients.
137+
> [!div class="nextstepaction"]
138+
> [PubSub among clients](quickstarts-pubsub-among-clients.md)
68.7 KB
Loading
106 KB
Loading
66.9 KB
Loading
57 KB
Loading
187 KB
Loading
5.48 MB
Loading
59.7 KB
Loading
2.81 MB
Loading
160 KB
Loading

0 commit comments

Comments
 (0)