Desplegar a Azure App Service

Introducción

Esta guía te explica cómo utilizar GitHub Actions para crear, probar y desplegar una aplicación en Azure App Service.

Azure App Service puede ejecutar apps web en varios lenguajes de programación, pero esta guía demuestra el despliegue en un proyecto existente que se encuentra en Node.js.

Prerrequisitos

Antes de crear tu flujo de trabajo de GitHub Actions, primero necesitarás completar los siguientes pasos de configuración:

1. Crear un plan de Azure App Service.

   Por ejemplo, puedes utilizar el CLI de Azure para crear un plan de App Service nuevo:

   Shell

   az appservice plan create \
       --resource-group MY_RESOURCE_GROUP \
       --name MY_APP_SERVICE_PLAN \
       --is-linux

   En el comando anterior, reemplaza MY_RESOURCE_GROUP con tu Grupo de Recursos de Azure preexistente y MY_APP_SERVICE_PLAN con un nombre nuevo para el plan de App Service.

   Consulta la documentación de Azure para obtener más información sobre cómo utilizar el CLI de Azure:

   • Para la autenticación, consulta "Iniciar sesión con Azure CLI".
   • Si necesitas crear un grupo de recursos nuevo, consulta lasección "grupo az".

2. Crea una app web.

   Por ejemplo, puedes utilizar el CLI de Azure para crear una app web de Azure App Service con un tiempo de ejecución de nodo:

   Shell

   az webapp create \
       --name MY_WEBAPP_NAME \
       --plan MY_APP_SERVICE_PLAN \
       --resource-group MY_RESOURCE_GROUP \
       --runtime "node|10.14"

   En este comando, reemplaza los parámetros con tus propios valores, en donde MY_WEBAPP_NAME es un nombre nuevo para la app web.

3. Configura un perfil de publicación de Azure y crea un secreto de AZURE_WEBAPP_PUBLISH_PROFILE.

   Genera tus credenciales de despliegue de Azure utilizando un perfil de publicación. Para obtener más información, consulta la sección "Generar credenciales de despliegue" en la documentación de Azure.

   En tu repositorio de GitHub, crea un secreto que se llame AZURE_WEBAPP_PUBLISH_PROFILE que tenga el contenido del perfil de publicación. Para obtener más información sobre cómo crear secretos, consulta la sección "Secretos cifrados".

4. For Linux apps, add an app setting called WEBSITE_WEBDEPLOY_USE_SCM and set it to true in your app. For more information, see "Configure apps in the portal" in the Azure documentation.

5. Optionally, configure a deployment environment. Environments are used to describe a general deployment target like production, staging, or development. When a GitHub Actions workflow deploys to an environment, the environment is displayed on the main page of the repository. You can use environments to require approval for a job to proceed, restrict which branches can trigger a workflow, or limit access to secrets. For more information about creating environments, see "Using environments for deployment."

Crear un flujo de trabajo

Una vez que hayas completado los prerequisitos, puedes proceder con la creación del flujo de trabajo.

The following example workflow demonstrates how to build, test, and deploy the Node.js project to Azure App Service when a release is created.

Asegúrate de configurar a AZURE_WEBAPP_NAME en la clave env del flujo de trabajo con el nombre de la app web que creaste. You can also change AZURE_WEBAPP_PACKAGE_PATH if the path to your project is not the repository root and NODE_VERSION if you want to use a node version other than 10.x.

If you configured a deployment environment, change the value of environment to be the name of your environment. If you did not configure an environment, delete the environment key.

# This workflow uses actions that are not certified by GitHub.
# Estas las proporcionan entidades terceras y las gobiernan
# condiciones de servicio, políticas de privacidad y documentación de soporte
# documentación.

on:
  release:
    types: [created]

env:
  AZURE_WEBAPP_NAME: MY_WEBAPP_NAME   # set this to your application's name
  AZURE_WEBAPP_PACKAGE_PATH: '.'      # set this to the path to your web app project, defaults to the repository root
  NODE_VERSION: '10.x'                # set this to the node version to use

jobs:
  build-and-deploy:
    name: Build and Deploy
    runs-on: ubuntu-latest
    environment: production

    steps:
      - uses: actions/checkout@v2

      - name: Use Node.js ${{ env.NODE_VERSION }}
        uses: actions/setup-node@v2
        with:
          node-version: ${{ env.NODE_VERSION }}

      - name: npm install, build, and test
        run: |
          # Build and test the project, then
          # deploy to Azure Web App.
          npm install
          npm run build --if-present
          npm run test --if-present

      - name: 'Deploy to Azure WebApp'
        uses: azure/webapps-deploy@0b651ed7546ecfc75024011f76944cb9b381ef1e
        with:
          app-name: ${{ env.AZURE_WEBAPP_NAME }}
          publish-profile: ${{ secrets.AZURE_WEBAPP_PUBLISH_PROFILE }}
          package: ${{ env.AZURE_WEBAPP_PACKAGE_PATH }}

Recursos adicionales

Los siguientes recursos también pueden ser útiles:

• Para encontrar el flujo de trabajo inicial original, consulta el archivo azure.yml en el repositorio starter-workflows de GitHub Actions.
• La acción que se utilizó para desplegar la app web es la acción oficial Azure/webapps-deploy de Azure.
• For more examples of GitHub Action workflows that deploy to Azure, see the actions-workflow-samples repository.
• La guía rápida de "Crear una app web de Node.js en Azure" dentro de la documentación de la app web de Azure demuestra cómo utilizar VS Code con la Extensión de Azure App Service.