From ea9bc77efbf7d3b098cbdc0eef4f00b951150bad Mon Sep 17 00:00:00 2001
From: selmankoc <selman.koc@volosoft.com>
Date: Thu, 18 Aug 2022 13:27:03 +0300
Subject: [PATCH] added doc deploy to azure app service

---
 .../en/Deployment/Deploy-Azure-App-Service.md | 425 ++++++++++++++++++
 docs/en/Deployment/Index.md                   |   5 +-
 docs/en/docs-nav.json                         |   4 +
 3 files changed, 433 insertions(+), 1 deletion(-)
 create mode 100644 docs/en/Deployment/Deploy-Azure-App-Service.md

diff --git a/docs/en/Deployment/Deploy-Azure-App-Service.md b/docs/en/Deployment/Deploy-Azure-App-Service.md
new file mode 100644
index 0000000000..e7536947bf
--- /dev/null
+++ b/docs/en/Deployment/Deploy-Azure-App-Service.md
@@ -0,0 +1,425 @@
+# Deploy Abp Webapp to Azure App Service
+
+> In this document, you'll learn how to create and deploy your first abp web app to [Azure App Service](https://docs.microsoft.com/en-us/azure/app-service/overview). The App Service supports various versions of .NET apps, and provides a highly scalable, self-patching web hosting service. Abp web apps are cross-platform and can be hosted on Linux and Windows.
+
+****Prerequisites****
+
+- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/dotnet).
+- A GitHub account [Create an account for free](http://github.com/).
+
+
+## Create a new ABP Framework application
+
+Create a repository on [GitHub.com](https://github.com/) (keep all the default settings)
+
+Open the command prompt and clone the repository into a folder on your computer
+
+```bash
+git clone https://github.com/your-username/your-repository-name.git
+```
+Check your dotnet version. It should be at least 3.1.x
+```bash
+dotnet --version
+```
+Install or update the *ABP CLI* using a command line window
+
+```bash
+dotnet tool install -g Volo.Abp.Cli || dotnet tool update -g Volo.Abp.Cli
+```
+
+Open the command prompt in the *GitHub repository folder* and create a *new abp Blazor solution* with the command below
+
+```bash
+abp new YourAppName -u blazor
+```
+
+Open the command prompt in the *[YourAppName].DbMigrator* project and enter the command below to apply the database migrations
+
+```bash
+dotnet run
+```
+
+Open the command prompt in the *[YourAppName].HttpApi.Host* project to run the API project
+
+```bash
+dotnet run
+```
+
+Navigate to the *applicationUrl* specified in *the launchSettings.json* file of the *[YourAppName].HttpApi.Host project*. You should get the *Swagger window*
+
+Open the command prompt in the *[YourAppName].Blazor* folder and enter the command below to run the Blazor project
+
+```bash
+dotnet run
+```
+
+Navigate to the *applicationUrl* specified in the *launchSettings.json* file of the *[YourAppName].Blazor* project. You should get the *ABP Framework Welcome window*
+
+Stop both the *API* and the *Blazor* project by pressing **CTRL+C**
+
+Before the github commit, you have to delete "**/wwwroot/libs/*" at *.gitignore* file.
+
+![azdevops-23](../images/azdevops-23.png)
+
+Open the command prompt in the root folder of your project and *add, commit and push* all your changes to your GitHub repository
+
+```bash
+git add .
+git commit -m initialcommit
+git push
+```
+
+
+## Create a SQL Database on Azure and change the connection string in the appsettings.json files
+
+* Login into [Azure Portal](https://portal.azure.com/)
+
+* Click **Create a resource**
+
+* Search for *SQL Database*
+
+* Click the **Create** button in the *SQL Database window*
+
+* Create a new resource group. Name it *rg[YourAppName]*
+
+* Enter *[YourAppName]Db* as database name
+
+* Create a new Server and name it *[yourappname]server*
+
+* Enter a serveradmin login and passwords. Click the **OK** button
+
+* Select your *Location*
+
+* Check *Allow Azure services to access server*
+
+* Click **Configure database**. Go to the *Basic* version and click the **Apply** button
+
+* Click the **Review + create** button. Click **Create**
+
+* Click **Go to resource** and click **SQL server** when the SQL Database is created
+
+* Click **Networking** under Security left side menu 
+
+* Select **Selected networks** and click **Add your client IP$ address** at the Firewall rules
+
+* Select **Allow Azure and resources to access this seerver** and save
+
+* Go to your **SQL database**, click **Connection strings** and copy the connection string
+
+* Copy/paste the appsettings.json files of the [YourAppName].HttpApi.Host and the [YourAppName].DbMigrator project
+
+* Do not forget to replace {your_password} with the correct server password you entered in Azure SQL Database
+
+Open the command prompt in the [YourAppName].DbMigrator project again and enter the command below to apply the database migrations
+
+```bash
+dotnet run
+```
+Open the command prompt in the [YourAppName].HttpApi.Host project and enter the command below to check your API is working
+
+```bash
+dotnet run
+```
+
+Stop the [YourAppName].HttpApi.Host by entering CTRL+C
+
+Open the command prompt in the root folder of your project and add, commit and push all your changes to your GitHub repository
+```bash
+git add .
+git commit -m initialcommit
+git push
+```
+
+
+## Set up the Build pipeline in AzureDevops and publish the Build Artifacts
+
+* Sign in into Azure DevOps
+
+* Click **New organization** and follow the steps to create a new organisation. Name it [YourAppName]org
+
+* Enter [YourAppName]Proj as project name in the ***Create a project to get started*** window
+
+* Select **Public visibility** and click the **Create project** button
+
+* Click the **Pipelines** button to continue
+
+* Click the **Create Pipeline** button
+
+ Select GitHub in the Select your repository window
+
+![azdevops-1](../images/azdevops-1.png)
+
+* Enter the Connection name. [YourAppName]GitHubConnection and click **Authorize using OAuth**
+
+* Select your **GitHub** [YourAppName]repo and click Continue
+
+* Search for **ASP.NET**  in the ***Select a template*** window
+
+![azdevops-2](../images/azdevops-2.png)
+
+* Select the ASP.NET Core template and click the **Apply** button
+
+* Add the below commands block as a first step in the pipeline
+
+    ```
+    - task: UseDotNet@2
+      inputs:
+        packageType: 'sdk'
+        version: '6.0.106'
+    ```
+
+![azdevops-18](../images/azdevops-18.png)
+
+* Select **Settings** on the second task(Nugetcommand@2) in the pipeline
+
+* Select **Feeds in my Nuget.config** and type **Nuget.config** in the text box
+
+![azdevops-3](../images/azdevops-3.png)
+
+* Add the below commands block to the end of the pipeline
+
+    ```
+    - task: PublishBuildArtifacts@1
+      displayName: 'Publish Artifact'
+      inputs:
+        PathtoPublish: '$(build.artifactstagingdirectory)'
+        ArtifactName: '$(Parameters.ArtifactName)'
+      condition: succeededOrFailed()
+    ```
+![azdevops-4](../images/azdevops-4.png)
+
+```
+# ASP.NET
+# Build and test ASP.NET projects.
+# Add steps that publish symbols, save build artifacts, deploy, and more:
+# https://docs.microsoft.com/azure/devops/pipelines/apps/aspnet/build-aspnet-4
+
+trigger:
+- main
+
+pool:
+  vmImage: 'windows-latest'
+
+variables:
+  solution: '**/*.sln'
+  buildPlatform: 'Any CPU'
+  buildConfiguration: 'Release'
+
+steps:
+- task: UseDotNet@2
+  inputs:
+    packageType: 'sdk'
+    version: '6.0.106'
+
+- task: NuGetToolInstaller@1
+
+- task: NuGetCommand@2
+  inputs:
+    command: 'restore'
+    restoreSolution: '$(solution)'
+    feedsToUse: 'config'
+    nugetConfigPath: 'NuGet.config'
+
+- task: VSBuild@1
+  inputs:
+    solution: '$(solution)'
+    msbuildArgs: '/p:DeployOnBuild=true /p:WebPublishMethod=Package /p:PackageAsSingleFile=true /p:SkipInvalidConfigurations=true /p:PackageLocation="$(build.artifactStagingDirectory)"'
+    platform: '$(buildPlatform)'
+    configuration: '$(buildConfiguration)'
+
+- task: VSTest@2
+  inputs:
+    platform: '$(buildPlatform)'
+    configuration: '$(buildConfiguration)'
+
+- task: PublishBuildArtifacts@1
+  displayName: 'Publish Artifact'
+  inputs:
+    PathtoPublish: '$(build.artifactstagingdirectory)'
+    ArtifactName: '$(Parameters.ArtifactName)'
+    publishLocation: 'Container'
+  condition: succeededOrFailed()
+```
+
+* Click **Save & queue** in the top menu. Click **Save & queue** again and click **Save and run** to run the Build pipeline
+
+* When the Build pipeline has finished. Click **1 published; 1 consumed**
+
+
+
+## Create a Web App in the Azure Portal to deploy [YourAppName].HttpApi.Host project
+
+* Search for Web App in the *Search the Marketplace* field
+
+* Click the **Create** button in the Web App window
+
+* Select rg[YourAppName] in the *Resource Group* dropdown
+
+* Enter [YourAppName]API in the *Name input* field
+
+* Select code, .NET Core 3.1 (LTS) and windows as *Operating System*
+
+* Enter [YourAppName]API in the *Name input* field
+
+* Select .NET Core 3.1 (LTS) in the *Runtime stack* dropdown
+
+* Select Windows as *Operating System*
+
+* Select the same *Region* as in the SQL server you created in Part 3
+
+![azdevops-5](../images/azdevops-5.png)
+
+* Click **Create new** in the Windows Plan. Name it [YourAppName]ApiWinPlan
+
+* Click **Change size** in Sku and size. Go to the Dev/Test Free F1 version and click the **Apply** button
+
+![azdevops-6](../images/azdevops-6.png)
+
+* Click the **Review + create** button. Click the **Create** button
+
+* Click **Go to resource** when the Web App has been created
+
+
+
+## Create a Release pipeline in the AzureDevops and deploy [YourAppName].HttpApi.Host project
+
+* Sign in into [Azure DevOps](https://azure.microsoft.com/en-us/services/devops/)
+
+* Click [YourAppName]Proj and click **Releases** in the *Pipelines* menu
+
+* Click the **New pipeline** button in the *No release pipelines found* window
+
+* Select *Azure App Service deployment* and click the **Apply** button
+
+![azdevops-7](../images/azdevops-7.png)
+
+* Enter *[YourAppName]staging* in the *Stage name* field in the *Stage* window. And close the window
+
+* Click **+ Add an artifact** in the *Pipeline* tab
+
+* Select the **Build** icon as *Source type* in the *Add an artifact* window
+
+* Select Build pipeline in the *Source (build pipeline)* dropdown and click the **Add** button
+
+![azdevops-8](../images/azdevops-8.png)
+
+* Click the **Continuous deployment trigger (thunderbolt icon)**
+
+* Set the toggle to **Enabled** in the the *Continuous deployment trigger* window
+
+* Click **+ Add** in *No filters added*. Select **Include** in the *Type* dropdown. Select your branch in the *Build branch* dropdown and close the window
+
+![azdevops-9](../images/azdevops-9.png)
+
+* Click **the little red circle with the exclamation mark** in the *Tasks* tab menu
+
+* Select your subscription in the *Azure subscription* dropdown.
+
+![azdevops-10](../images/azdevops-10.png)
+
+* Click **Authorize** and enter your credentials in the next screens
+
+* After Authorization, select the **[YourAppName]API** in the *App service name* dropdown
+
+* Click the **Deploy Azure App Service** task
+
+* Select **[YourAppName].HttpApi.Host.zip** in the *Package or folder* input field
+
+![azdevops-11](../images/azdevops-11.png)
+
+* Click the **Save** icon in the top menu and click **OK**
+
+* Click **Create release** in the top menu. Click **Create** to create a release
+
+* Click the *Pipeline* tab and wait until the Deployment succeeds
+
+![azdevops-12](../images/azdevops-12.png)
+
+* Open a browser and navigate to the URL of your Web App
+
+```
+https://[YourAppName]api.azurewebsites.net
+```
+
+![azdevops-13](../images/azdevops-13.png)
+
+
+
+## Create a Web App in Azure Portal to deploy [YourAppName].Blazor project
+
+* Login into [Azure Portal](https://portal.azure.com/)
+
+* Click **Create a resource**
+
+* Search for *Web App* in the *Search the Marketplace* field
+
+* Click the **Create** button in the *Web App* window
+
+* Select *rg[YourAppName]* in the *Resource Group* dropdown
+
+* Enter *[YourAppName]Blazor* in the *Name* input field
+
+* Select *.NET Core 3.1 (LTS)* in the *Runtime stack* dropdown
+
+* Select *Windows* as *Operating System*
+
+* Select the same region as the SQL server you created in Part 3
+
+* Select the [YourAppName]ApiWinPlan in the *Windows Plan* dropdown
+
+![azdevops-14](../images/azdevops-14.png)
+
+* Click the **Review + create** button. Click **Create** button
+
+* Click **Go to resource** when the Web App has been created
+
+* Copy the URL of the Blazor Web App for later use
+
+```
+https://[YourAppName]blazor.azurewebsites.net
+```
+
+
+## Change the Web App configuration for the Azure App Service
+
+Copy the URL of the Api Host and Blazor Web App. Change appsettings.json files in the Web App as follows images.
+
+![azdevops-19](../images/azdevops-19.png)
+
+![azdevops-20](../images/azdevops-20.png)
+
+![azdevops-21](../images/azdevops-21.png)
+
+
+
+## Add an extra Stage in the Release pipeline in the AzureDevops to deploy [YourAppName].Blazor project
+
+* Go to the *Release* pipeline in [Azure DevOps](https://azure.microsoft.com/en-us/services/devops/) and click **Edit**
+
+* Click the **+ Add** link and add a **New Stage**
+
+![azdevops-15](../images/azdevops-15.png)
+
+* Select *Azure App Service deployment* and click the **Apply** button
+
+* Enter *BlazorDeployment* in the *Stage name* input field and close the *Stage* window
+
+* Click the **little red circle with the exclamation mark** in the BlazorDeployment stage
+
+* Select your subscription in the *Azure subscription* dropdown
+
+* Select your Blazor Web App in the *App service name* dropdown
+
+* Click the **Deploy Azure App Service task**
+
+* Select *[YourAppName].Blazor.zip* in the *Package or folder* input field
+
+![azdevops-16](../images/azdevops-16.png)
+
+* Click **Save** in the top menu and click the **OK** button after
+
+* Click **Create release** in the top menu and click the **Create** button
+
+![azdevops-17](../images/azdevops-17.png)
+
+![azdevops-22](../images/azdevops-22.png)
\ No newline at end of file
diff --git a/docs/en/Deployment/Index.md b/docs/en/Deployment/Index.md
index dc1cca300e..a1c2e2d5f8 100644
--- a/docs/en/Deployment/Index.md
+++ b/docs/en/Deployment/Index.md
@@ -6,4 +6,7 @@ However, there are some topics that you should care about when you are deploying
 
 ## Guides
 
-* [Deploying to a clustered environment](Clustered-Environment.md): Explains how to configure your application when you want to run multiple instances of your application concurrently.
\ No newline at end of file
+* [Deploying to a clustered environment](Clustered-Environment.md): Explains how to configure your application when you want to run multiple instances of your application concurrently.
+
+
+* [Deploy Abp Webapp to Azure App Service](Deploy-Azure-App-Service.md): Explains how to create and deploy your first abp web app to [Azure App Service](https://docs.microsoft.com/en-us/azure/app-service/overview).
\ No newline at end of file
diff --git a/docs/en/docs-nav.json b/docs/en/docs-nav.json
index f764ca0bf2..4b82495a00 100644
--- a/docs/en/docs-nav.json
+++ b/docs/en/docs-nav.json
@@ -1282,6 +1282,10 @@
         {
           "text": "Deploying to a Clustered Environment",
           "path": "Deployment/Clustered-Environment.md"
+        },
+        {
+          "text": "Deploy Abp Webapp to Azure App Service",
+          "path": "Deployment/Deploy-Azure-App-Service.md"
         }
       ]
     },