Créer une application de fonction dans un conteneur Linux local

  • Article

Cet article vous montre comment utiliser Azure Functions Core Tools pour créer votre première fonction dans un conteneur Linux sur votre ordinateur local, vérifier la fonction localement, puis publier la fonction conteneurisée dans un registre de conteneurs. Vous pouvez facilement déployer vos fonctions conteneurisées sur Azure depuis un registre de conteneurs.

Pour obtenir un exemple complet de déploiement de fonctions conteneurisées sur Azure, qui inclut les étapes décrites de cet article, consultez l’un des articles suivants :

Vous pouvez également créer une application de fonction dans le Portail Azure à l’aide d’une application de fonction conteneurisée existante dans un registre de conteneurs. Si vous souhaitez obtenir plus d’informations, consultez Fonction de création du Portail Azure en utilisant des conteneurs.

Choisissez votre langage de développement

Tout d’abord, vous utilisez les outils Azure Functions pour créer votre code de projet en tant qu’application de fonction dans un conteneur Docker à l’aide d’une image de base Linux spécifique au langage. Veillez à sélectionner le langage de votre choix en haut de l’article.

Core Tools génère automatiquement un fichier Dockerfile pour votre projet qui utilise la version la plus récente de l’image de base appropriée pour le langage de vos fonctions. Vous devez régulièrement mettre à jour votre conteneur à partir de l’image de base la plus récente et redéployer à partir de la version mise à jour de votre conteneur. Pour plus d’informations, consultez Création d’applications de fonction conteneurisées.

Prérequis

Avant de commencer, vous devez disposer de la configuration requise suivante :

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit Azure avant de commencer.

Pour publier l’image d’application de fonction en conteneur que vous créez dans un registre de conteneurs, vous avez besoin d’un ID Docker et d’une instance Docker s’exécutant sur votre ordinateur local. Si vous n’avez pas d’ID Docker, vous pouvez créer un compte Docker.

Vous devez également suivre la section Créer un registre de conteneurs du guide de démarrage rapide Container Registry pour créer une instance de registre. Notez le nom complet de votre serveur de connexion.

Créer et activer un environnement virtuel

Dans le dossier approprié, exécutez les commandes suivantes pour créer et activer un environnement virtuel nommé .venv. Veillez à utiliser une des versions Python prises en charge par Azure Functions.

python -m venv .venv

source .venv/bin/activate

Si Python n’a pas installé le package venv sur votre distribution Linux, exécutez la commande suivante :

sudo apt-get install python3-venv

Vous devez exécuter toutes les commandes suivantes dans cet environnement virtuel activé.

Créer et tester un projet de fonction local

Dans un terminal ou une invite de commandes, exécutez la commande suivante dans le langage de votre choix pour créer un projet d’application de fonction dans le dossier actuel :

func init --worker-runtime dotnet-isolated --docker

func init --worker-runtime node --language javascript --docker

func init --worker-runtime powershell --docker

func init --worker-runtime python --docker

func init --worker-runtime node --language typescript --docker

Dans un dossier vide, exécutez la commande suivante pour générer le projet Functions à partir d’un archétype Maven :

mvn archetype:generate -DarchetypeGroupId=com.microsoft.azure -DarchetypeArtifactId=azure-functions-archetype -DjavaVersion=8 -Ddocker

Le paramètre -DjavaVersion dit au runtime Functions quelle version de Java utiliser. Utilisez -DjavaVersion=11 si vous voulez que vos fonctions s’exécutent sur Java 11. Si vous ne spécifiez pas -DjavaVersion, par défaut Maven utilise Java 8. Pour plus d’informations, consultez Versions de Java.

Important

La variable d’environnement JAVA_HOME doit être définie sur l’emplacement d’installation de la version appropriée du JDK pour que vous puissiez suivre cet article.

Maven vous invite à entrer les valeurs nécessaires pour terminer la génération du projet lors du déploiement. Suivez les invites et fournissez les informations suivantes :

Prompt Valeur Description
groupId com.fabrikam Valeur qui identifie de façon unique votre projet parmi tous les projets, avec respect des règles de nommage de package pour Java.
artifactId fabrikam-functions Valeur qui correspond au nom du fichier jar, sans numéro de version.
version 1.0-SNAPSHOT Sélectionnez la valeur par défaut.
package com.fabrikam.functions Valeur qui correspond au package Java pour le code de fonction généré. Utilisez la valeur par défaut.

Tapez Y ou appuyez sur Entrée pour confirmer.

Maven crée les fichiers projet dans un nouveau dossier avec le nom d’artifactId, qui est fabrikam-functions dans cet exemple.

L’option --docker génère un Dockerfile pour le projet, qui définit un conteneur approprié pour une utilisation avec Azure Functions et le runtime sélectionné.

Accédez au dossier du projet :

cd fabrikam-functions

Ajoutez une fonction à votre projet à l’aide de la commande suivante, où l’argument --name est le nom unique de votre fonction, et l’argument --template spécifie le déclencheur de la fonction. func new crée un fichier de code C# dans votre projet.

func new --name HttpExample --template "HTTP trigger" --authlevel anonymous

Ajoutez une fonction à votre projet à l’aide de la commande suivante, où l’argument --name est le nom unique de votre fonction, et l’argument --template spécifie le déclencheur de la fonction. func new crée un sous-dossier correspondant au nom de la fonction qui contient un fichier config nommé func new.

func new --name HttpExample --template "HTTP trigger" --authlevel anonymous

Pour tester la fonction localement, démarrez l’hôte du runtime Azure Functions local à la racine du dossier du projet.

func start  

func start  

npm install
npm start

mvn clean package  
mvn azure-functions:run

Quand vous voyez le point de terminaison HttpExample écrit dans la sortie, accédez à ce point de terminaison. Vous devez voir un message de bienvenue dans la sortie de la réponse.

Quand vous voyez le point de terminaison HttpExample écrit dans la sortie, accédez à http://localhost:7071/api/HttpExample?name=Functions. Le navigateur doit afficher un message « hello » qui renvoie Functions par écho, c’est-à-dire la valeur fournie au paramètre de requête name.

Appuyez sur Ctrl+C (Commande+C sur macOS) pour arrêter l’hôte.

Générer l’image conteneur et vérifier localement

(Facultatif) Examinez le Dockerfile à la racine du dossier du projet. Le Dockerfile décrit l’environnement requis pour exécuter l’application de fonction sur Linux. La liste complète des images de base prises en charge pour Azure Functions se trouve sur la pages des images de base Azure Functions.

À la racine du dossier du projet, exécutez la commande docker build, puis indiquez un nom (azurefunctionsimage) et une balise (v1.0.0). Remplacez <DOCKER_ID> par votre ID de compte Docker Hub. Cette commande génère l’image Docker pour le conteneur.

docker build --tag <DOCKER_ID>/azurefunctionsimage:v1.0.0 .

Une fois la commande terminée, vous pouvez exécuter le nouveau conteneur localement.

Pour vérifier la génération, exécutez l’image dans un conteneur local avec la commande docker run, en remplaçant à nouveau <DOCKER_ID> par votre ID de compte Docker Hub et en ajoutant l’argument pour les ports, -p 8080:80 :

docker run -p 8080:80 -it <DOCKER_ID>/azurefunctionsimage:v1.0.0

Après le démarrage de l’image dans le conteneur local, accédez à http://localhost:8080/api/HttpExample, qui doit afficher le même message d’accueil que précédemment. Étant donné que la fonction déclenchée par HTTP que vous avez créée utilise une autorisation anonyme, vous pouvez appeler la fonction en cours d’exécution dans le conteneur sans avoir à obtenir de clé d’accès. Pour plus d’informations, consultez Clés d’autorisation.

Après le démarrage de l’image dans le conteneur local, accédez à http://localhost:8080/api/HttpExample?name=Functions, qui doit afficher le même message « hello » que précédemment. Étant donné que la fonction déclenchée par HTTP que vous avez créée utilise une autorisation anonyme, vous pouvez appeler la fonction en cours d’exécution dans le conteneur sans avoir à obtenir de clé d’accès. Pour plus d’informations, consultez Clés d’autorisation.

Après avoir vérifié l’application de fonction dans le conteneur, appuyez sur Ctrl+C (Commande+C sur macOS) pour arrêter l’exécution.

Publier l’image conteneur dans un registre

Pour que votre image conteneur soit disponible pour le déploiement dans un environnement d’hébergement, vous devez l’envoyer à un registre de conteneurs.

Azure Container Registry est un service de registre privé permettant de créer, de stocker et de gérer des images conteneurs et des artefacts connexes. Vous devez utiliser un service de registre privé pour publier vos conteneurs sur les services Azure.

  1. Utilisez la commande suivante pour vous connecter à votre instance de registre :

    az acr login --name <REGISTRY_NAME>

    Dans la commande précédente, remplacez <REGISTRY_NAME> par le nom de votre instance Container Registry.

  2. Utilisez la commande suivante pour baliser votre image avec le nom complet de votre serveur de connexion au registre :

    docker tag <DOCKER_ID>/azurefunctionsimage:v1.0.0 <LOGIN_SERVER>/azurefunctionsimage:v1.0.0

    Remplacez <LOGIN_SERVER> par le nom complet de votre serveur de connexion au registre et <DOCKER_ID> par votre ID Docker.

  3. Utilisez la commande suivante pour envoyer le conteneur à votre instance de registre :

    docker push <LOGIN_SERVER>/azurefunctionsimage:v1.0.0

  4. Utilisez la commande suivante pour activer le compte d’administrateur intégré afin que Functions puisse se connecter au registre avec un nom d’utilisateur et un mot de passe :

    az acr update -n <REGISTRY_NAME> --admin-enabled true

  1. Utilisez la commande suivante pour récupérer le nom d’utilisateur et le mot de passe de l’administrateur, dont Functions a besoin pour se connecter au Registre :

    az acr credential show -n <REGISTRY_NAME> --query "[username, passwords[0].value]" -o tsv

    Important

    Le nom d’utilisateur et le mot de passe du compte d’administrateur sont des informations d’identification importantes. Veillez à les stocker en toute sécurité et jamais dans un emplacement accessible, comme un référentiel public.

Étapes suivantes

Utilisation de conteneurs et d’Azure Functions