Skip to main content
All docs
V24.1

Azure App Service (Linux) - Create and Publish ASP.NET Core Reporting App in Visual Studio

  • 3 minutes to read

This topic uses Microsoft Visual Studio UI to create a sample ASP.NET Core Devexpress Reporting application that includes Document Viewer and Report Designer, and deploys this application to Azure App Services.

The Azure App Service uses Linux images that already contain the libraries required for DevExpress Reporting components. You can deploy an ASP.NET Core Reporting application without a Docker container.

Prerequisites

  1. An Azure account with an active subscription.
  2. Visual Studio 2022 with the ASP.NET and web development workload.

Important Disclaimer

The deployment recommendations do not apply to all possible configurations and should not be considered comprehensive. We offer these instructions as a getting-started reference. Steps may vary depending on your operating system, installed software, and DevExpress versions. You, the developer, are responsible for the application, database, network, and other configurations based on your client, security, environment, and other requirements. We recommend that you review these settings with your database, network, and IT infrastructure administrators and consider tailoring their recommendations to your case.

Create a Sample ASP.NET Core DevExpress Reporting Application

Create a sample .NET 6 application with a Report Designer and Document Viewer components. The project uses a Debian-based Docker image and ASP.NET Core distributed caching mechanism to cache reports and related documents.

  • From the File menu, select New > Project.
  • Select the DevExpress v24.1 Web App Template Gallery, and click Next
  • In the Configure your new project dialog, specify a project name and location, and click Create
  • Select Reporting Application from the .NET category in the invoked DevExpress Template Gallery

    create-new-aspnet-core-reporting-application-template-gallery

  • Select the framework version and click Create Project.

  • Use the DevExpress Template Gallery to generate a basic ASP.NET Core application that contains the End-User Report Designer and Document Viewer components. In the DevExpress ASP.NET Core Project Wizard dialog specify the following settings:

    DevExpress ASP.NET Core Project Wizard Setting Value
    Add Viewer Page True
    Add Designer Page True
    Enable Docker Support Based on Selected OS None
    Specify Document Cache Storage Type DistributedCache

    DevExpress ASP.NET Core Project Wizard Settings for Azure Deployment - No Docker

For more information, review the following help article: Use Visual Studio Templates to Create an ASP.NET Core Application with a Report Designer.

Specify the NuGet Feed URL for Docker

To restore NuGet packages while building a Docker image, replace the contents of the secrets.dev.yaml file located in the project with your personal DevExpress NuGet feed URL.

Set Up a Publishing Profile for Azure App Service Container

  1. Log into your Microsoft account from Visual Studio.

    Log into your Microsoft account

  2. In Solution Explorer, right-click the project name and click Publish.

    Visual Studio Publish Menu Item

  3. Select Azure and click Next.

    Select Publish to Azure

  • Select the Azure App Service (Linux) and click Next.

    Select the Azure App Service (Linux)

  1. On the App Service tab, click Create new.

    App Service Create New

  2. If necessary, change the Name, Resource group, or Hosting Plan values, and click Create.

    Change the Name, Resource Group or Hosting Plan

  3. Select the newly created service and click Next.

    Newly Created Azure App Service

Publish to Azure App Service (Linux)

  1. After the publishing profile is successfully created, click Publish to start process.

    Publish Button for Azure App Service (Linux)

  2. Once the profile is published, the application’s home page automatically opens in a browser.

    ASP.NET Core Reporting App in a Docker Container Deployed to Azure App Service