Skip to content

Run as an Azure Web App Using GitHub Action

Jump to bottom
Bryan Soltis edited this page Mar 19, 2024 · 14 revisions

Overview

This process will allow you to deploy the Azure Naming Tool as a .NET 8 application as an Azure Web App. This is the fastest deployment option and allows you to deploy and utilize your installation in minutes. The provided GitHub Action will deploy your repository code on every commit. This installation process provides the most secure, scalable solution for your installation.

At a high level, this is the installation process:

  1. Fork the Azure Naming Tool Repository

  2. Create an Azure Web App
    The App Service can be created manually, or leverage the Deploy to Azure options below.

  3. Enable Azure Web App Authentication
    Require users to authenticate to Azure AD to access the App Service.

  4. Create GitHub secrets
    These secrets are used by the GitHub Action to build the application in the Azure App Service.

  5. Enable GitHub Action
    Enable automative deployment of the tool when GitHub repository is updated.

Steps

1. Fork the Azure Naming Tool Repository

  1. Scroll up to the top-left corner of this page.
  2. Click on the AzureNamingTool link to open the root of this repository.
  3. Click the Fork option in the top-right menu.
  4. Select your desired Owner and Repository name and click Create fork.
  5. Click the green <>Code button
  6. Click the .github/workflows link.

Run as Azure Web App 1

  1. Click the .deploy-azure-naming-tool-to-azure-webapps-dotnet-core.yml link.

Run as Azure Web App 2

  1. Review the instructions for creating the required GitHub secrets.


NOTES:

  • The GitHub Action will not successfully deploy until the secrets are created.
  • You must create an Azure Web App and configure the GitHub Action secrets to deploy to your Azure Web App.


2. Create an Azure Web App

  1. Create a new Azure Web App in the Azure portal.
  2. For the Publish option, select Code.
  3. For the Runtime stack, select .NET 8.

Web App Basics

  1. Download the Publish Profile for use within the GitHub Action secret.
Get-AzWebApp -Name <webappname> | Get-AzWebAppPublishingProfile -OutputFile <filename> | Out-Null

** OR **

Web App Details

3. Enable Azure Web App Authentication

  1. In the Azure Portal for your Azure Web App, Navigate to the Authentication blade.
  2. Select Add identity provider.
  3. In the Identity provider section, select Microsoft.
  4. Enter the desired Name. All other options can be left as default.
  5. Click Add.

Web App Authentication



4. Create GitHub Secrets

  1. In your GitHub repository, click Settings in the top menu.
  2. Click Secrets in the left menu.
  3. Click New repository secret.
  4. Enter AZURE_WEBAPP_PUBLISH_PROFILE as the Name.
  5. Enter the Publish Profile data for your Azure Web App as the Value.
  6. Click Add secret.
  7. Click New repository secret.
  8. Enter AZURE_WEBAPP_NAME as the Name.
  9. Enter the name of your Azure Web App as the Value.

GitHub Secrets



5. Enable GitHub Action

  1. In your GitHub repository, click the Actions tab.
  2. Click on I understand my workflows, go ahead and enable them.
  3. Select the Azure Naming Tool - Build and deploy to an Azure Web App workflow in the left navigation.
  4. Click Run workflow.
  5. Confirm the workflow completes successfully.

GitHub Workflow

  1. Access your Azure Web App to confirm the site is successfully deployed.


NOTE:
If your website does not load, check the configuration to ensure the dotnet AzureNamingTool.dll command is set on startup.

image

Clone this wiki locally