# Déploiement de Node.js sur Azure App Service Découvrez comment déployer un projet Node.js sur Azure App Service dans le cadre de vos flux de travail de déploiement continu (CD). ## Prérequis Avant de créer votre workflow GitHub Actions, vous devez suivre les étapes de configuration suivantes : 1. Créer un plan Azure App Service. Par exemple, vous pouvez utiliser Azure CLI pour créer un plan App Service : ```bash copy az appservice plan create \ --resource-group MY_RESOURCE_GROUP \ --name MY_APP_SERVICE_PLAN \ --is-linux ``` Dans la commande ci-dessus, remplacez `MY_RESOURCE_GROUP` par votre groupe de ressources Azure préexistant et `MY_APP_SERVICE_PLAN` par un nouveau nom pour le plan App Service. Pour plus d’informations sur l’utilisation d’[Azure CLI](https://docs.microsoft.com/cli/azure/), consultez la documentation Azure : * Pour l’authentification, consultez [Se connecter avec Azure CLI](https://docs.microsoft.com/cli/azure/authenticate-azure-cli). * Si vous devez créer un groupe de ressources, consultez [az group](https://docs.microsoft.com/cli/azure/group?view=azure-cli-latest#az_group_create). 2. Créez une application web. Par exemple, vous pouvez utiliser le Azure CLI pour créer une application web Azure App Service avec un runtime Node.js : ```bash copy az webapp create \ --name MY_WEBAPP_NAME \ --plan MY_APP_SERVICE_PLAN \ --resource-group MY_RESOURCE_GROUP \ --runtime "NODE|14-lts" ``` Dans la commande ci-dessus, remplacez les paramètres par vos propres valeurs, où `MY_WEBAPP_NAME` est un nouveau nom pour l’application web. 3. Configurez un profil de publication Azure, et créez un secret `AZURE_WEBAPP_PUBLISH_PROFILE`. Générez vos identifiants de déploiement Azure à l’aide d’un profil de publication. Pour plus d’informations, consultez [Générer les informations d’identification du déploiement](https://docs.microsoft.com/azure/app-service/deploy-github-actions?tabs=applevel#generate-deployment-credentials) dans la documentation Azure. Dans votre GitHub référentiel, créez un secret nommé `AZURE_WEBAPP_PUBLISH_PROFILE` qui contient le contenu du profil de publication. Pour plus d’informations sur la création de secrets, consultez [Utilisation de secrets dans GitHub Actions](/fr/actions/how-tos/write-workflows/choose-what-workflows-do/use-secrets#creating-secrets-for-a-repository). 4. Si vous le souhaitez, configurez un environnement de déploiement. Les environnements sont utilisés pour décrire une cible de déploiement général comme `production`, `staging` ou `development`. Lorsqu’un GitHub Actions flux de travail est déployé dans un environnement, l’environnement s’affiche sur la page principale du référentiel. Vous pouvez utiliser les environnements pour exiger l’approbation d’un travail, restreindre les branches pouvant déclencher un flux de travail, contrôler les déploiements avec des règles personnalisées de protection des déploiements ou limiter l’accès aux secrets. Pour plus d’informations sur la création d’environnements, consultez [Gestion des environnements pour le déploiement](/fr/actions/how-tos/deploy/configure-and-manage-deployments/manage-environments). ## Création du workflow Une fois les conditions préalables remplies, vous pouvez procéder à la création du workflow. L’exemple de flux de travail suivant montre comment générer, tester et déployer le projet Node.js sur Azure App Service en cas d’envoi (push) vers la branche `main`. Vérifiez que vous définissez `AZURE_WEBAPP_NAME` dans la clé `env` du workflow sur le nom de l’application web que vous avez créée. Si le chemin d’accès à votre projet n’est pas la racine du dépôt, remplacez `AZURE_WEBAPP_PACKAGE_PATH` par le chemin d’accès de votre projet. Si vous utilisez une version de Node.js autre que `10.x`, remplacez `NODE_VERSION` par la version que vous utilisez. Si vous avez configuré un environnement de déploiement, remplacez la valeur `environment` par le nom de votre environnement. Si vous n’avez pas configuré d’environnement ou si votre workflow se trouve dans un référentiel privé et que vous n’utilisez pas GitHub Enterprise Cloud, supprimez la clé `environment`. ```yaml copy # Ce workflow utilise des actions qui ne sont pas certifiées par GitHub. # Elles sont fournies par un tiers et régies par # des conditions d’utilisation du service, une politique de confidentialité et un support distincts. # documentation en ligne. # GitHub recommande d’épingler les actions à un SHA de commit. # Pour obtenir une version plus récente, vous devez mettre à jour le SHA. # Vous pouvez également référencer une balise ou une branche, mais l’action peut changer sans avertissement. on: push: branches: - main 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: '14.x' # set this to the node version to use jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v6 - name: Set up Node.js uses: actions/setup-node@v7 with: node-version: ${{ env.NODE_VERSION }} cache: 'npm' - name: npm install, build, and test run: | npm install npm run build --if-present npm run test --if-present - name: Upload artifact for deployment job uses: actions/upload-artifact@v4 with: name: node-app path: . deploy: runs-on: ubuntu-latest needs: build environment: name: 'production' url: ${{ steps.deploy-to-webapp.outputs.webapp-url }} steps: - name: Download artifact from build job uses: actions/download-artifact@v5 with: name: node-app - name: 'Deploy to Azure WebApp' id: deploy-to-webapp uses: azure/webapps-deploy@85270a1854658d167ab239bce43949edb336fa7c with: app-name: ${{ env.AZURE_WEBAPP_NAME }} publish-profile: ${{ secrets.AZURE_WEBAPP_PUBLISH_PROFILE }} package: ${{ env.AZURE_WEBAPP_PACKAGE_PATH }} ``` ## Pour aller plus loin * Pour le modèle de workflow d’origine, consultez [`azure-webapps-node.yml`](https://github.com/actions/starter-workflows/blob/main/deployments/azure-webapps-node.yml) dans le référentiel GitHub Actions `starter-workflows`. * L’action utilisée pour déployer l’application web est l’action officielle Azure [`Azure/webapps-deploy`](https://github.com/Azure/webapps-deploy). * Pour plus d’exemples de flux de travail d’action GitHub qui se déploient sur Azure, consultez le référentiel [actions-workflow-samples](https://github.com/Azure/actions-workflow-samples). * Le guide de démarrage rapide [Créer une application web Node.js dans Azure](https://docs.microsoft.com/azure/app-service/quickstart-nodejs) dans la documentation de l’application web Azure illustre l’utilisation de Visual Studio Code avec l’extension [Azure App Service](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azureappservice).