Skip to content

Latest commit

 

History

History
130 lines (92 loc) · 4.46 KB

azure-integration.md

File metadata and controls

130 lines (92 loc) · 4.46 KB
Raw

Integrate with Azure Services

In the ChatRoom sample you have learned how to use Azure SignalR Service in your application, but you still need to host the hub implementation on a web server. In this tutorial you'll learn how to use Azure web app to host your hub logic and also integrate with serverless applications like Azure functions.

Deploy SignalR Hub to Azure Web App

Azure Web App is a service for hosting web applications, which is a perfect choice for hosting our SignalR hub.

In this topic we will introduce two ways to deploy web apps:

Deploy through Local Git

The easiest way to deploy web app is using local Git:

  1. Create a web app:

    az appservice plan create --name <plan_name> --resource-group <resource_group_name> --sku S1 --is-linux
az webapp create \
    --resource-group <resource_group_name> --plan <plan_name> --name <app_name> \
    --runtime "dotnetcore|2.1"

  2. Deploy your app to web app:

    az webapp deployment source config-local-git --resource-group <resource_group_name> --name <app_name>
az webapp deployment user set --user-name <user_name> --password <password>

git init
git remote add origin <deploy_git_url>
git add -A
git commit -m "init commit"
git push origin master

  3. Update app settings:

    az webapp config appsettings set --resource-group <resource_group_name> --name <app_name> --setting PORT=5000
az webapp config appsettings set --resource-group <resource_group_name> --name <app_name> \
    --setting Azure__SignalR__ConnectionString=<connection_string>

Deploy through Docker Image

Azure Web App also supports container, so we can build our application into a Docker container and deploy it to web app.

Build Docker Image

First use the Dockerfile to build our application into a Docker container image:

docker build -t chatroom .

Let's take a look at the details of the Dockerfile.

First copy the source code, restore, build and publish the app:

# copy csproj and restore as distinct layers
RUN mkdir ChatRoom && cd ChatRoom/
COPY *.csproj ./
RUN dotnet restore

# copy everything else and build
COPY ./ ./
RUN dotnet publish -c Release -o out

Then copy the build output into app folder and set the entrypoint:

# build runtime image
FROM microsoft/dotnet:2.1-aspnetcore-runtime
WORKDIR /app
COPY --from=build-env /app/out .
ENTRYPOINT ["dotnet", "ChatRoom.dll"]

Then you can test the image locally:

docker run -p 5000:80 -e Azure__SignalR__ConnectionString="<connection_string>" chatroom

For more information about building Docker image for .NET Core, please refer to this doc.

After you test the image, push it to a Docker register (here we use Azure Container Registry, you can also use others like DockerHub):

docker login <acr_name>.azurecr.io
docker tag chatroom <acr_name>.azurecr.io/chatroom
docker push <acr_name>.azurecr.io/chatroom

Deploy Docker Image to Azure Web App

First create an Azure Web App:

az group create --name <resource_group_name> --location CentralUS
az appservice plan create --name <plan_name> --resource-group <resource_group_name> --sku S1 --is-linux
az webapp create \
   --resource-group <resource_group_name> --plan <plan_name> --name <app_name> \
   --deployment-container-image-name nginx

This creates a web app with nginx image.

This tutorial uses Azure CLI to deploy to Azure, make sure you have Azure CLI installed first.

Then update the web app with the chat room image:

az webapp config container set \
   --resource-group <resource_group_name> --name <app_name> \
   --docker-custom-image-name <acr_name>.azurecr.io/chatroom \
   --docker-registry-server-url https://<acr_name>.azurecr.io \
   --docker-registry-server-user <acr_name> \
   --docker-registry-server-password <acr_password>
az webapp config appsettings set --resource-group <resource_group_name> --name <app_name> --setting PORT=80
az webapp config appsettings set --resource-group <resource_group_name> --name <app_name> \
   --setting Azure__SignalR__ConnectionString="<connection_string>"

Now open https://<app_name>.azurewebsites.net and you will see your chat room running on Azure.