Configurer les exclusions de fichiers d’empaquetage de service

Azure Developer CLI (azd) vous permet d’ajouter des fichiers d’ignorance dans vos modèles pour spécifier les fichiers et répertoires à exclure du package de déploiement pour App Service et Function Apps. Cette fonctionnalité fournit un contrôle granulaire au niveau du service sur les fichiers inclus dans le processus d’empaquetage.

Comprendre les fichiers d’ignorance de l’empaquetage de service

Il existe deux types de fichiers d’ignorance que vous pouvez utiliser pour influencer le processus d’empaquetage :

  • .webappignore influence les exclusions d’empaquetage pour les déploiements Azure App Service.
  • .funcignore influence les exclusions d’empaquetage pour les déploiements Azure Functions.

Ces fichiers d’ignorance sont appliqués en fonction du service de déploiement ciblé, garantissant que les utilisateurs peuvent personnaliser indépendamment les exclusions de fichiers lors de l’empaquetage pour Azure App Service et Azure Functions. Les deux types de fichiers d’ignorance d’empaquetage suivent ces règles :

  • Les fichiers .webappignore ou .funcignore doivent être placés dans le dossier racine du service concerné dans votre modèle azd.
  • Si un fichier .webappignore ou .funcignore existe dans un répertoire de service, le processus d’empaquetage suit ses règles, permettant un contrôle granulaire des fichiers inclus ou exclus dans l’archive zip du service.
  • Si aucun fichier .webappignore ou .funcignore n’est présent, des exclusions par défaut s’appliquent :
    • Python : __pycache__ et tout fichier venv
    • Node.js : node_modules
  • La syntaxe des fichiers d’ignorance suit la syntaxe standard gitignore. Par exemple, utilisez le symbole ! pour annuler une exclusion.

Exemples d’exclusions

Dans votre modèle azd, ajoutez un fichier .webappignore ou .funcignore dans le dossier racine du service que vous souhaitez déployer sur Azure App Service ou Azure Functions. Mettez à jour le contenu de ces fichiers d’ignorance pour inclure ou exclure des fichiers en utilisant les motifs suivants :

Exclure un dossier ou un fichier spécifique :

logs/*
testfile.js

Exclure les dossiers ou fichiers ignorés par défaut lorsque le fichier .webappignore ou .funcignore n’est pas présent :

node_modules/