Konfigurieren von Ausschlüssen von Dienstpaketdateien

Mit der Azure Developer CLI (azd) können Sie Ihren Vorlagen IGNORE-Dateien hinzufügen, um festzulegen, welche Dateien und Verzeichnisse vom Bereitstellungspaket für App Service- und Funktions-Apps ausgeschlossen werden sollen. Dieses Feature bietet eine präzise Kontrolle auf Dienstebene darüber, welche Dateien im Paketprozess enthalten sind.

Grundlegendes zu IGNORE-Dienstpaketdateien

Sie können zwei verschiedene Arten von IGNORE-Dateien verwenden, um den Verpackungsprozess zu beeinflussen:

  • .webappignore wirkt sich auf das Packen von Ausschlüssen für Azure App Service-Bereitstellungen aus.
  • .funcignore wirkt sich auf das Packen von Ausschlüssen für Azure Functions-Bereitstellungen aus.

Diese IGNORE-Dateien werden in Abhängigkeit vom angezielten Bereitstellungsdienst angewendet und dienen dazu, sicherzustellen, dass Benutzer während des Packens für Azure App Service und Azure Functions Dateiausschlüsse unabhängig anpassen können. Beide Arten der IGNORE-Paketdateien befolgen die folgenden Regeln:

  • Die Dateien .webappignore oder .funcignore sollten im Stammordner des entsprechenden Diensts in Ihrer azd-Vorlage platziert werden.
  • Wenn eine .webappignore- oder .funcignore-Datei in einem Dienstverzeichnis vorhanden ist, folgt der Verpackungsprozess ihren Regeln und ermöglicht eine präzise Kontrolle darüber, welche Dateien in das ZIP-Archiv des Diensts eingeschlossen bzw. aus diesem ausgeschlossen werden sollen.
  • Wenn keine .webappignore- oder .funcignore-Datei vorhanden ist, gelten Standardausschlüsse:
    • Python: __pycache__- und alle venv-Dateien
    • Node.js: node_modules
  • Die Syntax für die IGNORE-Dateien folgt der standardmäßigen gitignore-Syntax. Verwenden Sie z. B. das !-Symbol, um einen Ausschluss wiederherzustellen.

Beispiele für Ausschlüsse

Fügen Sie in Ihrer azd-Vorlage dem Stammordner des Diensts, den Sie für Azure App Service oder Azure Functions bereitstellen möchten, eine .webappignore- oder eine .funcignore-Datei hinzu. Aktualisieren Sie den Inhalt dieser IGNORE-Dateien, um Dateien unter Verwendung der folgenden Muster ein- bzw. auszuschließen:

Schließen Sie einen Ordner oder eine bestimmte Datei aus:

logs/*
testfile.js

Schließen Sie Ordner und Dateien aus, die standardmäßig ignoriert werden, wenn die Datei .webappignore oder .funcignore nicht vorhanden ist.

node_modules/