Skip to main content
All docs
V25.2
  • Azure App Service (Linux) Docker Container - Create and Publish ASP.NET Core Reporting App in Visual Studio

    • 3 minutes to read

    This topic creates a sample ASP.NET Core DevExpress Reporting application that includes Document Viewer and Report Designer, and deploys this application to Azure App Services using a Docker Container from the Azure Container Registry using Microsoft Visual Studio.

    Prerequisites

    1. An Azure account with an active subscription.
    2. Visual Studio 2022 with the ASP.NET and web development workload.
    3. The latest version of Docker desktop. You can find more information about Docker in the following topic: Get Docker.
    4. Your personal DevExpress NuGet credentials. Refer to the following help topic for instructions on how to obtain the feed URL and authorization key: Choose Between Offline and Online DevExpress NuGet Feeds.

    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 ASP.NET Core application with 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.

    Run the following CLI command to create a new ASP.NET Core application with the Web Document Viewer and Web Report Designer:

    dotnet new dx.aspnetcore.reporting -n DxReportingApp --DockerFile Debian --DocumentStorage DistributedCache
    

    DevExpress ASP.NET Core project templates are included in our Unified Component Installer.

    You can also use the Project Template Kit to create an application with the required components.

    Refer to the following help topic for additional information on DevExpress Templates: Use DevExpress Templates.

    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

    4. Select the Azure App Service Container and click Next.

      Select the Azure App Service Container

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

      App Service Create New

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

      Change the Name, Resource Group or Hosting Plan

    7. Select the newly created service and click Next.

      Newly Created Azure App Service

    8. Choose an existing container registry or create a new one, then click Finish.

      Select Container Registry

    9. You may be prompted to enable the Admin user on the container registry instance. Click Yes.

      Prompt to Enable Admin User

    Publish to Azure App Service Container

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

      Publish Button

    2. Once the profile is successfully 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