Événements
Relevez le défi Microsoft Learn
19 nov., 23 h - 10 janv., 23 h
Ignite Edition - Créez des compétences dans Microsoft Azure et gagnez un badge numérique d’ici le 10 janvier !
S’inscrire maintenantCe navigateur n’est plus pris en charge.
Effectuez une mise à niveau vers Microsoft Edge pour tirer parti des dernières fonctionnalités, des mises à jour de sécurité et du support technique.
Dans Azure Functions, une Function App fournit le contexte d’exécution de vos fonctions individuelles. Les comportements de la Function App s’appliquent à toutes les fonctions hébergées par une Function App donnée. Toutes les fonctions d’une application de fonction doivent être exprimées dans le même langage.
Les fonctions individuelles dans une application de fonction sont déployées ensemble et sont mises à l’échelle ensemble. Toutes les fonctions de la même application de fonction partagent les ressources, par instance, à mesure que l’application de fonction est mise à l’échelle.
Les chaînes de connexion, les variables d’environnement et d’autres paramètres d’application sont définis séparément pour chaque application de fonction. Toutes les données qui doivent être partagées entre les applications de fonction doivent être stockées en externe dans un magasin persistant.
Notes
En raison des limitations liées à la modification du code de fonction dans le portail Azure, vous devez développer vos fonctions localement et publier votre projet de code dans une application de fonction dans Azure. Pour plus d’informations, consultez la section Limitations de développement dans le portail Azure.
Pour afficher les paramètres de l’application dans votre application de fonction, procédez comme suit :
Connectez-vous au portail Azure avec votre compte Azure. Recherchez votre application de fonction, puis sélectionnez-la.
Dans le volet gauche de votre application de fonction, développez Paramètres, sélectionnez Variables d’environnement, puis sélectionnez l’onglet Paramètres de l’application.
Outre les paramètres d’application prédéfinis utilisés par Azure Functions, vous pouvez créer n’importe quel nombre de paramètres d’application, comme requis par votre code de fonction. Pour plus d'informations, consultez Informations de référence sur les paramètres d'application d'Azure Functions.
Ces paramètres sont stockés sous forme chiffrée. Pour plus d’informations, consultez Sécurité des paramètres d’application.
Vous pouvez gérer les paramètres d’application à partir du portail Azure et à l’aide d’Azure CLI et d’Azure PowerShell. Vous pouvez également gérer les paramètres d’application à partir de Visual Studio Code et de Visual Studio.
Pour afficher les paramètres de votre application, consultez Bien démarrer dans le portail Azure.
L’onglet Paramètres de l’application conserve les paramètres qui sont utilisés par votre application de fonction :
Ces valeurs de paramètres d’application de fonction peuvent aussi être lues dans votre code en tant que variables d’environnement. Pour plus d’informations, consultez la section Variables d’environnement de ces rubriques de référence propres à un langage :
Quand vous développez une application de fonction localement, vous devez conserver des copies locales de ces valeurs dans le fichier de projet local.settings.json. Pour en savoir plus, voir Fichier de paramètres locaux.
Azure Functions prend en charge le déploiement du code du projet dans votre application de fonction en utilisant FTPS. Étant donné que cette méthode de déploiement vous oblige à synchroniser les déclencheurs, elle n’est pas recommandée. Pour transférer des fichiers de projet en toute sécurité, utilisez toujours FTPS et non FTP.
Pour obtenir les informations d'identification requises pour le déploiement de FTPS en utilisant l'une des méthodes suivantes :
Vous pouvez obtenir les identifiants de publication FTPS dans le portail Azure en téléchargeant le profil de publication pour votre application fonctionnelle.
Important
Le profil de publication contient des informations d’identification de sécurité importantes. Sécurisez toujours le fichier téléchargé sur votre ordinateur local.
Pour télécharger le profil de publication de votre application de fonction :
Dans le Portail Azure, recherchez la page de votre application de fonction, puis développez Paramètres>Configuration dans la colonne de gauche.
Dans la page Configuration, sélectionnez l’onglet Paramètres généraux et vérifiez que les Informations d’identification d’authentification de base SCM sont Activées. Lorsque ce paramètre est Désactivé, vous ne pouvez pas utiliser de profils de publication. Sélectionnez donc Activé, puis Enregistrez.
Revenez à la page Vue d’ensemble de l’application de fonction, puis sélectionnez Obtenir le profil de publication.
Enregistrez et copiez le contenu du fichier.
publishProfile
contenant l’attribut publishMethod="FTP"
. Dans cet élément, les attributs publishUrl
, userName
et userPWD
contiennent l’URL cible et les informations d’identification pour la publication FTPS.Lorsque vous créez une application de fonction, vous créez également un plan d’hébergement dans lequel elle s’exécute. Un plan peut comporter une ou plusieurs applications de fonction. Les fonctionnalités, la mise à l’échelle et le tarif des fonctions dépendent du type de plan. Pour plus d’informations, consultez Options d’hébergement Azure Functions.
Vous pouvez déterminer le type de plan utilisé par votre application de fonction sur le Portail Azure, avec l’API Azure CLI ou avec l’API Azure PowerShell.
Les valeurs suivantes indiquent le type de plan :
Type de plan | Portail Azure | Azure CLI/PowerShell |
---|---|---|
Consommation | Consommation | Dynamic |
Premium | ElasticPremium | ElasticPremium |
Dédié (App Service) | Divers | Divers |
Pour identifier le type de plan utilisé par votre application de fonction, consultez Plan App Service dans la page Vue d’ensemble correspondant à l’application de fonction sur le portail Azure.
Pour afficher le niveau tarifaire, sélectionnez le nom Plan App Service, puis sélectionnez Paramètres > Propriétés dans le volet de gauche.
Vous pouvez migrer une application de fonction entre un plan Consommation et un plan Premium sur Windows. Lors de la migration entre plans, gardez à l’esprit les considérations suivantes :
Vous pouvez migrer votre plan à l’aide de ces outils :
Vous pouvez utiliser le portail Azure pour passer à un autre plan.
Choisissez la direction de la migration pour votre application sur Windows.
Le tableau suivant présente les systèmes d'exploitation et les langues qui prennent en charge l'édition dans le portail :
Langage | Consommation Windows | Windows Premium | Dédié (Windows) | Consommation Linux | Linux Premium | Dédié (Linux) |
---|---|---|---|---|---|---|
C# | ||||||
Java | ||||||
JavaScript (Node.js) | ✔ | ✔ | ✔ | ✔ | ✔ | |
Python | ✔ | ✔ | ✔ | |||
PowerShell | ✔ | ✔ | ✔ | |||
TypeScript (Node.js) |
Tenez compte de ces limitations lorsque vous développez vos fonctions dans le portail Azure :
Au besoin, développez vos fonctions localement et publier votre projet de code sur une application de fonction dans Azure. Pour plus d’informations, consultez Coder et tester Azure Functions localement.
Les fonctions de bibliothèque de classes C# peuvent inclure les packages NuGet pour les extensions de liaison directement dans le projet de bibliothèque de classes. Pour les autres langages non-.NET et script C#, vous devez utiliser des packs d’extensions. Si vous devez installer manuellement des extensions, vous pouvez le faire en utilisant Azure Functions Core Tools localement. Si vous ne pouvez pas utiliser de bundles d’extensions et que vous ne pouvez travailler que dans le portail, vous devez utiliser Advanced Tools (Kudu) pour créer manuellement le fichier extensions.csproj directement dans le site. Veillez à supprimer d’abord l’élément extensionBundle
du fichier host.json.
Ce même processus fonctionne pour tout autre fichier que vous devez ajouter à votre application.
Important
Si possible, ne modifiez pas les fichiers directement dans votre application de fonction dans Azure. Nous vous recommandons de télécharger vos fichiers d’application localement, à l’aide de Core Tools pour installer des extensions et d’autres packages, de valider vos modifications, puis de republier votre application à l’aide de Core Tools ou de l’une des autres méthodes de déploiement prises en charge.
L’éditeur Functions (intégré au Portail Azure) vous permet de mettre à jour vos fichiers de code et de configuration de fonction directement dans le portail :
Sélectionnez votre application de fonction, puis, sous Fonctions, sélectionnez Fonctions.
Choisissez votre fonction et sélectionnez Code + test sous Développeur.
Choisissez votre fichier à modifier et sélectionnez Enregistrer lorsque vous avez terminé.
Les fichiers à la racine de l’application, tels que function.proj ou extensions.csproj, doivent être créés et modifiés à l’aide d’Advanced Tools (Kudu) :
Sélectionnez votre application de fonction, développez outils de développement, puis sélectionnezOutils avancés>Go.
Si vous y êtes invité, connectez-vous au site SCM (Source Control Manager) avec vos informations d’identification Azure.
Dans le menu Déboguer la console, choisissez CMD.
Accédez à .\site\wwwroot
, sélectionnez le bouton plus (+) en haut, puis sélectionnez Nouveau fichier.
Donnez un nom au fichier, par exemple extensions.csproj
, puis appuyez sur Entrée.
Sélectionnez le bouton Modifier en regard du nouveau fichier, ajoutez ou mettez à jour le code dans le fichier, puis sélectionnez Enregistrer.
Pour un fichier projet tel que extensions.csproj, exécutez la commande suivante pour reconstruire le projet d’extensions :
dotnet build extensions.csproj
Les applications de fonction s’exécutent dans la plateforme Azure App Service, qui les gère. Par conséquent, vos Function Apps ont accès à la plupart des fonctionnalités de la plateforme d’hébergement web principale d’Azure. Si vous utilisez le portail Azure, le volet de gauche permet d’accéder aux nombreuses fonctionnalités de la plateforme App Service à votre disposition dans vos applications de fonction.
La matrice suivante indique la prise en charge des fonctionnalités du portail par plan d’hébergement et système d’exploitation :
Fonctionnalité | Plan Consommation | Plan de consommation flexible | Plan Premium | Plan dédié |
---|---|---|---|---|
Outils avancés (Kudu) | Windows : ✔ Linux : X |
X | ✔ | ✔ |
Éditeur App Service | Windows : ✔ Linux : X |
X | Windows : ✔ Linux : X |
Windows : ✔ Linux : X |
Sauvegardes | X | X | X | ✔ |
Console | Windows : ligne de commande Linux : X |
X | Windows : ligne de commande Linux : SSH |
Windows : ligne de commande Linux : SSH |
Le reste de ce article se concentre sur les fonctionnalités du portail qui sont utiles pour applications de fonction :
Pour plus d’informations sur l’utilisation des paramètres App Service, consultez Configurer des applications web dans Azure App Service.
L’éditeur App Service est un éditeur avancé intégré au portail. Vous pouvez l’utiliser pour modifier les fichiers de configuration JSON et les fichiers de code. L’activation de cette option entraîne l’ouverture d’un onglet distinct du navigateur avec un éditeur de base. Cet éditeur vous permet d’intégrer au référentiel GitHub, exécuter et déboguer du code et modifier les paramètres de l’application de fonction. Cet éditeur fournit un environnement de développement amélioré pour vos fonctions en comparaison avec l’éditeur de fonction intégré.
Nous vous recommandons d’envisager de développer vos fonctions sur votre ordinateur local. Quand vous développez localement et publiez sur Azure, vos fichiers projet sont en lecture seule dans le portail Azure. Pour plus d’informations, consultez Coder et tester Azure Functions localement.
La console intégrée au portail est un outil de développement idéal lorsque vous souhaitez interagir avec Function App à partir de la ligne de commande. Les commandes courantes incluent la création de fichiers et de répertoires et la navigation, ainsi que l’exécution de scripts et de fichiers de commandes.
Quand vous développez localement, nous vous recommandons d’utiliser Azure Functions Core Tools et Azure CLI.
Les outils avancés pour App Service (également appelé Kudu) donnent accès aux fonctionnalités d’administration avancées de votre Function App. Dans Kudu, vous pouvez gérer les informations système, les paramètres d’application, les variables d’environnement, les extensions de site, les en-têtes HTTP et les variables de serveur. Vous pouvez également lancer Kudu en naviguant vers le point de terminaison SCM pour votre Function App, par exemple : https://<myfunctionapp>.scm.azurewebsites.net/
.
Quand vous utilisez une solution de contrôle de code source pour développer et gérer le code de vos fonctions, le centre de déploiement vous permet de générer et de déployer à partir du contrôle de code source. Votre projet est généré et déployé sur Azure quand vous effectuez des mises à jour. Pour plus d’informations, consultez Technologies de déploiement dans Azure Functions.
Pour empêcher l’exécution de code malveillant sur le client, les navigateurs modernes bloquent les requêtes des applications web vers les ressources qui s’exécutent dans un domaine distinct. Le partage des ressources cross-origin (CORS) permet à un en-tête Access-Control-Allow-Origin
de déclarer les origines autorisées à appeler des points de terminaison sur votre application de fonction.
Quand vous configurez la liste Origines autorisées pour votre application de fonction, l’en-tête Access-Control-Allow-Origin
est automatiquement ajouté à toutes les réponses des points de terminaison HTTP dans votre application de fonction.
Le caractère générique (*) est ignoré si une autre entrée de domaine existe.
Lorsque les fonctions utilisent un déclencheur HTTP, vous pouvez exiger l’authentification préalable des appels. App Service prend en charge l’authentification Microsoft Entra et la connexion à des fournisseurs de réseaux sociaux tels que Facebook, Microsoft et X. Pour plus d’informations sur la configuration de fournisseurs d’authentification spécifiques, consultez Vue d’ensemble de l’authentification Azure App Service.
Événements
Relevez le défi Microsoft Learn
19 nov., 23 h - 10 janv., 23 h
Ignite Edition - Créez des compétences dans Microsoft Azure et gagnez un badge numérique d’ici le 10 janvier !
S’inscrire maintenantEntrainement
Module
Authentifier les utilisateurs avec Azure Static Web Apps - Training
Publiez une application et une API JavaScript Angular, React, Svelte ou Vue et une authentification à l’aide de Azure Static Web Apps et Azure Functions. Déployez votre code de GitHub sur un site intermédiaire à l’aide d’URL de préversion.
Certification
Microsoft Certified: Azure Developer Associate - Certifications
Générez des solutions de bout en bout dans Microsoft Azure pour créer des fonctions Azure Functions, implémenter et gérer des applications web, développer des solutions qui utilisent le Stockage Azure, et bien plus encore.
Documentation
Informations de référence sur les paramètres d’application d’Azure Functions
Documentation de référence pour les paramètres d’application Azure Functions ou les variables d’environnement utilisées pour la configuration des applications de fonction.
Développer et exécuter des fonctions Azure Functions en local
Apprenez à coder et à tester des fonctions Azure Functions sur votre ordinateur local avant de les exécuter dans Azure Functions.
Informations de référence sur le fichier host.json pour Azure Functions 2.x
Décrit les différents paramètres disponibles pour l’hôte Azure Functions qui peuvent être définis dans le fichier host.json pour le runtime Functions v4.