diff --git a/docs/en/Deployment/Deploy-Azure-App-Service.md b/docs/en/Deployment/Deploy-Azure-App-Service.md deleted file mode 100644 index e7536947bf..0000000000 --- a/docs/en/Deployment/Deploy-Azure-App-Service.md +++ /dev/null @@ -1,425 +0,0 @@ -# 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 a1c2e2d5f8..6503f8b664 100644 --- a/docs/en/Deployment/Index.md +++ b/docs/en/Deployment/Index.md @@ -7,6 +7,3 @@ 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. - - -* [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 4b82495a00..f764ca0bf2 100644 --- a/docs/en/docs-nav.json +++ b/docs/en/docs-nav.json @@ -1282,10 +1282,6 @@ { "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" } ] }, diff --git a/docs/en/images/azdevops-1.png b/docs/en/images/azdevops-1.png deleted file mode 100644 index 78181e4b7c..0000000000 Binary files a/docs/en/images/azdevops-1.png and /dev/null differ diff --git a/docs/en/images/azdevops-10.png b/docs/en/images/azdevops-10.png deleted file mode 100644 index 75a273ba52..0000000000 Binary files a/docs/en/images/azdevops-10.png and /dev/null differ diff --git a/docs/en/images/azdevops-11.png b/docs/en/images/azdevops-11.png deleted file mode 100644 index 422a0ddbc0..0000000000 Binary files a/docs/en/images/azdevops-11.png and /dev/null differ diff --git a/docs/en/images/azdevops-12.png b/docs/en/images/azdevops-12.png deleted file mode 100644 index e1bc1399f9..0000000000 Binary files a/docs/en/images/azdevops-12.png and /dev/null differ diff --git a/docs/en/images/azdevops-13.png b/docs/en/images/azdevops-13.png deleted file mode 100644 index e83f972b20..0000000000 Binary files a/docs/en/images/azdevops-13.png and /dev/null differ diff --git a/docs/en/images/azdevops-14.png b/docs/en/images/azdevops-14.png deleted file mode 100644 index a4bd3b65d0..0000000000 Binary files a/docs/en/images/azdevops-14.png and /dev/null differ diff --git a/docs/en/images/azdevops-15.png b/docs/en/images/azdevops-15.png deleted file mode 100644 index ed4b9dc6a0..0000000000 Binary files a/docs/en/images/azdevops-15.png and /dev/null differ diff --git a/docs/en/images/azdevops-16.png b/docs/en/images/azdevops-16.png deleted file mode 100644 index 402f6b7d5e..0000000000 Binary files a/docs/en/images/azdevops-16.png and /dev/null differ diff --git a/docs/en/images/azdevops-17.png b/docs/en/images/azdevops-17.png deleted file mode 100644 index 5441a87035..0000000000 Binary files a/docs/en/images/azdevops-17.png and /dev/null differ diff --git a/docs/en/images/azdevops-18.png b/docs/en/images/azdevops-18.png deleted file mode 100644 index 8e358172d5..0000000000 Binary files a/docs/en/images/azdevops-18.png and /dev/null differ diff --git a/docs/en/images/azdevops-19.png b/docs/en/images/azdevops-19.png deleted file mode 100644 index ff282de4d5..0000000000 Binary files a/docs/en/images/azdevops-19.png and /dev/null differ diff --git a/docs/en/images/azdevops-2.png b/docs/en/images/azdevops-2.png deleted file mode 100644 index 9982431409..0000000000 Binary files a/docs/en/images/azdevops-2.png and /dev/null differ diff --git a/docs/en/images/azdevops-20.png b/docs/en/images/azdevops-20.png deleted file mode 100644 index f8a00be927..0000000000 Binary files a/docs/en/images/azdevops-20.png and /dev/null differ diff --git a/docs/en/images/azdevops-21.png b/docs/en/images/azdevops-21.png deleted file mode 100644 index 7d55d11150..0000000000 Binary files a/docs/en/images/azdevops-21.png and /dev/null differ diff --git a/docs/en/images/azdevops-22.png b/docs/en/images/azdevops-22.png deleted file mode 100644 index f103c8f56f..0000000000 Binary files a/docs/en/images/azdevops-22.png and /dev/null differ diff --git a/docs/en/images/azdevops-23.png b/docs/en/images/azdevops-23.png deleted file mode 100644 index 7318b82d13..0000000000 Binary files a/docs/en/images/azdevops-23.png and /dev/null differ diff --git a/docs/en/images/azdevops-3.png b/docs/en/images/azdevops-3.png deleted file mode 100644 index 0ede96f42a..0000000000 Binary files a/docs/en/images/azdevops-3.png and /dev/null differ diff --git a/docs/en/images/azdevops-4.png b/docs/en/images/azdevops-4.png deleted file mode 100644 index 52e025913c..0000000000 Binary files a/docs/en/images/azdevops-4.png and /dev/null differ diff --git a/docs/en/images/azdevops-5.png b/docs/en/images/azdevops-5.png deleted file mode 100644 index 31384e5de5..0000000000 Binary files a/docs/en/images/azdevops-5.png and /dev/null differ diff --git a/docs/en/images/azdevops-6.png b/docs/en/images/azdevops-6.png deleted file mode 100644 index cc493dfd43..0000000000 Binary files a/docs/en/images/azdevops-6.png and /dev/null differ diff --git a/docs/en/images/azdevops-7.png b/docs/en/images/azdevops-7.png deleted file mode 100644 index e5f0cda151..0000000000 Binary files a/docs/en/images/azdevops-7.png and /dev/null differ diff --git a/docs/en/images/azdevops-8.png b/docs/en/images/azdevops-8.png deleted file mode 100644 index 5c2f996cf8..0000000000 Binary files a/docs/en/images/azdevops-8.png and /dev/null differ diff --git a/docs/en/images/azdevops-9.png b/docs/en/images/azdevops-9.png deleted file mode 100644 index 0c8a7b557e..0000000000 Binary files a/docs/en/images/azdevops-9.png and /dev/null differ