Function Compute:Créer une application web avec une fonction web

Étape 1 : Développer et tester l'application

1. Ouvrez une nouvelle fenêtre de ligne de commande sur votre machine locale et exécutez la commande suivante pour installer les bibliothèques Flask et tabulate requises.

   pip install Flask tabulate

2. Créez un dossier nommé code et, à l'intérieur, un fichier nommé app.py. Collez l'exemple de code suivant dans ce fichier. Il implémente un service de calendrier simple exposé via une API. L'API accepte une année et un mois (par exemple, janvier 2025) et renvoie le tableau du calendrier correspondant.

   import calendar
   from flask import Flask, request
   from tabulate import tabulate
   import logging
   import json
   
   logger = logging.getLogger()
   app = Flask(__name__)
   
   @app.route("/", methods=["POST"])
   def get_month_calendar():
       # Get the request ID and print the log.
       requestId = request.headers.get('x-fc-request-id', '')
       logger.info("FC Invoke Start RequestId: " + requestId)
       # Get the request content and check the request format.
       data = json.loads(request.stream.read().decode('utf-8'))
       if not ('year' in data and 'month' in data):
           message = "Request must be in format like {'year': '1999', 'month': '12'}"
           return message
   
       # Get the calendar table.
       result = print_calendar(year=int(data['year']), month=int(data['month']))
       # Print the log that indicates the function execution is complete before the result is returned.
       logger.info("FC Invoke End RequestId: " + requestId)
       return result
   
   def print_calendar(year, month):
       # Get the calendar matrix for the specified year and month.
       cal = calendar.monthcalendar(year, month)
       # Change the dates that do not belong to the month from 0 to empty strings.
       cal = list(map(lambda sublist: list(map(lambda x: '' if x == 0 else x, sublist)), cal))
       # Create table headers.
       headers = ["Mo", "Tu", "We", "Th", "Fr", "Sa", "Su"]
   
       # Use tabulate to print the calendar table.
       return tabulate(cal, headers=headers, tablefmt="grid", stralign='center', numalign='center')
   
   if __name__ == "__main__":
       app.run(host='0.0.0.0', port=9000)
   

3. Exécutez la commande python3 app.py pour lancer votre application Flask. Si la sortie Running on http://127.0.0.1:9000 s'affiche, l'application Flask est en cours d'exécution. Vous pouvez alors utiliser cURL pour tester l'application.

   python3 app.py 
    * Serving Flask app 'app'
    * Debug mode: off
   WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
    * Running on http://127.0.0.1:9000
    * Running on http://47.100.XX.XX:9000
   Press CTRL+C to quit

4. Ouvrez une nouvelle fenêtre de terminal et utilisez cURL pour envoyer une requête d'exemple. Une commande réussie renvoie un tableau de calendrier.

   curl -X POST http://127.0.0.1:9000 -d '{"year": "2000", "month": "1"}'

   

Le projet est désormais créé et testé localement.

Étape 2 : Générer un package de code

Construisez localement un package de code adapté à Function Compute. Celui-ci doit contenir les éléments suivants :

• Les fichiers de projet requis par l'application web.

• Les dépendances non incluses dans le runtime, le cas échéant. Pour connaître les dépendances intégrées aux runtimes, consultez la section Dépendances intégrées.

1. Installer les dépendances : Dans le répertoire racine de votre projet d'application web, exécutez la commande suivante pour y installer les dépendances requises (dans cet exemple, tabulate).

   Remarque

   Le runtime de la fonction web Python inclut déjà la bibliothèque Flask. Il suffit d'installer la bibliothèque tabulate pour que l'exemple d'application fonctionne.

   pip install -t . tabulate

2. Empaquetez tous les fichiers du répertoire racine du projet.

   Linux ou macOS

   Dans le répertoire racine du projet, exécutez la commande zip code.zip -r ./*. Cette commande empaquette les fichiers du projet et les dépendances dans un fichier ZIP, créant ainsi le package de code.

   Remarque

   Assurez-vous de disposer des autorisations de lecture et d'écriture sur le répertoire.

   Windows

   Accédez au répertoire du projet, sélectionnez tous les fichiers, faites un clic droit, puis empaquetez-les dans un fichier ZIP. Cela crée le package de code contenant les fichiers du projet et les dépendances.

Étape 3 : Créer et déployer la fonction

1. Sélectionner le type de fonction web : Connectez-vous à la console Function Compute. Dans le volet de navigation de gauche, cliquez sur Function Management > Functions. Dans la barre de navigation supérieure, sélectionnez la région où créer la fonction. Sur la page qui s'affiche, cliquez sur Create Function, puis suivez les instructions à l'écran pour créer une Web Function.

2. Sélectionner un runtime : Comme indiqué dans la figure suivante, sélectionnez Custom Runtime. Ce runtime dispose des dépendances requises par le framework Flask.

   Remarque

   • Nous vous recommandons d'utiliser un Custom Runtime pour votre fonction web. Un Custom Runtime vous permet de spécifier une commande de démarrage et un port d'écoute, et prend en charge la gestion simultanée des requêtes. Les Built-in Runtimes ne proposent pas ces fonctionnalités et conviennent mieux à la gestion d'événements générés par d'autres services cloud.

   • Si vous préférez un déploiement conteneurisé, utilisez un Custom Container pour créer une fonction web. Ce runtime prend également en charge la gestion simultanée des requêtes, mais vous devez gérer vous-même les dépendances.

   • Pour une comparaison détaillée des runtimes, consultez la section Sélectionner un runtime.

3. Déployer le package de code : Comme indiqué dans la figure, téléchargez le package de code ZIP créé à l'Étape 2. Définissez la commande de démarrage sur python3 app.py et le port d'écoute sur 9000. Si vous migrez une application Flask existante, adaptez la configuration à la commande de démarrage et au port réels. Par exemple, le port par défaut de Flask est 5000.

   Cliquez sur Create et attendez la création de la fonction.

Étape 4 : Tester la fonction

1. Obtenir l'URL de la fonction : Sur la page de détails de la fonction nouvellement créée, cliquez sur l'onglet Trigger. Dans la configuration du déclencheur HTTP, copiez le point de terminaison public.

   Si vous êtes dans un environnement de test et n'avez pas besoin d'authentification, modifiez la Authentication Method en No Authentication dans la configuration du déclencheur HTTP, lors de sa création ou ultérieurement.

   

2. Tester la fonction : Utilisez cURL, Postman ou tout client HTTP pour appeler la fonction et vérifier que l'application Flask fonctionne comme prévu. L'exemple suivant utilise cURL. Remplacez l'URL par le point de terminaison copié à l'étape précédente.

   curl https://******.cn-hangzhou.fcapp.run -d '{"year": "2025", "month": "1"}' 

   L'API web renvoie les informations de calendrier pour janvier 2025. Voici un exemple de sortie.

   

   Remarque

   • Avec la configuration par défaut du déclencheur HTTP, la commande renvoie une erreur « MissingRequiredHeader ». En environnement de test, modifiez la Authentication Method du déclencheur en No Authentication.

   • La commande d'exemple et la sortie de cette étape s'appliquent uniquement à l'exemple de code. Si vous migrez une application existante, appelez le service en fonction du nom de l'API et des paramètres réels. Pour plus d'informations, consultez la section Utiliser cURL pour tester une fonction.

3. (Facultatif) Accéder à la fonction depuis un navigateur : Le point de terminaison public fourni par le déclencheur HTTP ne peut pas être ouvert directement dans un navigateur (cela peut déclencher un téléchargement forcé) et est destiné uniquement aux tests. Nous vous recommandons de lier un nom de domaine personnalisé à la fonction pour permettre l'accès via un navigateur et pour une utilisation en production. Pour plus d'informations, consultez la section Configurer un nom de domaine personnalisé.

(Facultatif) Étape 5 : Nettoyer les ressources

Pour plus d'informations sur l'ajout de packages de dépendances pour différents langages, consultez les rubriques suivantes :