Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation de couches pour les fonctions Lambda en Python

Une couche Lambda est une archive de fichier .zip qui contient du code ou des données supplémentaires. Les couches contiennent généralement des dépendances de bibliothèque, une exécution personnalisée, ou des fichiers de configuration. La création d'une couche implique trois étapes générales :

Cette rubrique contient des étapes et des conseils sur la manière d'empaqueter et de créer correctement une couche Lambda Python avec des dépendances de bibliothèque externes.

Prérequis

Pour suivre les étapes décrites dans cette section, vous devez disposer des éléments suivants :

Tout au long de cette rubrique, nous faisons référence à l'layer-pythonexemple d'application sur le référentiel awsdocs GitHub . Cette application contient des scripts qui téléchargent les dépendances et génèrent les couches. L'application contient également les fonctions correspondantes qui utilisent les dépendances des couches. Après avoir créé une couche, vous pouvez déployer et invoquer la fonction correspondante pour vérifier que tout fonctionne correctement. Comme vous utilisez le moteur d'exécution Python 3.11 pour les fonctions, les couches doivent également être compatibles avec Python 3.11.

L'layer-pythonexemple d'application contient deux exemples :

Compatibilité de la couche Python avec Amazon Linux

La première étape de la création d'une couche consiste à regrouper l'ensemble du contenu de la couche dans une archive de fichiers .zip. Parce que les fonctions Lambda s'exécutent sur Amazon Linux, le contenu de votre couche doit pouvoir être compilé et construit dans un environnement Linux.

En Python, la plupart des paquets sont disponibles sous forme de roues (.whlfichiers) en plus de la distribution source. Chaque roue est un type de distribution intégrée qui prend en charge une combinaison spécifique de versions de Python, de systèmes d'exploitation et de jeux d'instructions machine.

Les roues sont utiles pour garantir la compatibilité de votre couche avec Amazon Linux. Lorsque vous téléchargez vos dépendances, téléchargez la roue universelle si possible. (Par défaut, pip installe la roue universelle si elle est disponible.) La roue universelle contient any une balise de plate-forme, indiquant qu'elle est compatible avec toutes les plateformes, y compris Amazon Linux.

Dans l'exemple suivant, vous allez empaqueter la requests bibliothèque dans une couche Lambda. La requests bibliothèque est un exemple de package disponible sous forme de roue universelle.

Tous les packages Python ne sont pas distribués sous forme de roues universelles. Par exemple, numpypossède plusieurs distributions de roues, chacune supportant un ensemble différent de plateformes. Pour de tels packages, téléchargez la manylinux distribution afin de garantir la compatibilité avec Amazon Linux. Pour obtenir des instructions détaillées sur l'empaquetage de telles couches, reportez-vous à la sectionUtilisation des distributions manylinux de roues.

Dans de rares cas, un package Python peut ne pas être disponible sous forme de roue. Si seule la distribution source (sdist) existe, nous vous recommandons d'installer et d'empaqueter vos dépendances dans un environnement Docker basé sur l'image du conteneur de base Amazon Linux 2023. Nous recommandons également cette approche si vous souhaitez inclure vos propres bibliothèques personnalisées écrites dans d'autres langages tels que C/C++. Cette approche imite l'environnement d'exécution Lambda dans Docker et garantit que les dépendances de vos packages autres que Python sont compatibles avec Amazon Linux.

Chemins de couche pour les environnements d'exécution Python

Lorsque vous ajoutez une couche à une fonction, Lambda charge le contenu de la couche dans le répertoire /opt de cet environnement d’exécution. Pour chaque exécution Lambda, la variable PATH inclut déjà des chemins de dossiers spécifiques dans le répertoire /opt. Pour garantir que la PATH variable capte le contenu de votre couche, le fichier .zip de votre couche doit avoir ses dépendances dans les chemins de dossier suivants :

Par exemple, le fichier de couche .zip obtenu que vous créez dans ce didacticiel possède la structure de répertoire suivante :

layer_content.zip
└ python
    └ lib
        └ python3.11
            └ site-packages
                └ requests
                └ <other_dependencies> (i.e. dependencies of the requests package)
                └ ...

La requestsbibliothèque est correctement située dans le python/lib/python3.11/site-packages répertoire. Cela garantit que Lambda peut localiser la bibliothèque lors des appels de fonctions.

Empaqueter le contenu de la couche

Dans cet exemple, vous allez empaqueter la requests bibliothèque Python dans un fichier .zip de couche. Procédez comme suit pour installer et empaqueter le contenu de la couche.

Création de la couche

Dans cette section, vous allez prendre le layer_content.zip fichier que vous avez généré dans la section précédente et le télécharger en tant que couche Lambda. Vous pouvez télécharger une couche à l'aide du AWS Management Console ou du Lambda API via le AWS Command Line Interface ()AWS CLI. Lorsque vous téléchargez le fichier .zip de votre couche, dans la PublishLayerVersion AWS CLI commande suivante, spécifiez python3.11 comme environnement d'exécution compatible et arm64 comme architecture compatible.

aws lambda publish-layer-version --layer-name python-requests-layer \
    --zip-file fileb://layer_content.zip \
    --compatible-runtimes python3.11 \
    --compatible-architectures "arm64"

Dans la réponse, notez leLayerVersionArn, qui ressemble àarn:aws:lambda:us-east-1:123456789012:layer:python-requests-layer:1. Vous aurez besoin de cet Amazon Resource Name (ARN) à l'étape suivante de ce didacticiel, lorsque vous ajouterez la couche à votre fonction.

Ajouter la couche à votre fonction

Dans cette section, vous déployez un exemple de fonction Lambda qui utilise la requests bibliothèque dans son code de fonction, puis vous attachez la couche. Pour déployer la fonction, vous avez besoin d'unDéfinition des autorisations d'une fonction Lambda avec un rôle d'exécution. Si vous n'avez pas de rôle d'exécution existant, suivez les étapes décrites dans la section pliable.

Le code de fonction Lambda importe la requests bibliothèque, fait une HTTP demande simple, puis renvoie le code d'état et le corps.

import requests

def lambda_handler(event, context):
    print(f"Version of requests library: {requests.__version__}")
    request = requests.get('https://api.github.com/')
    return {
        'statusCode': request.status_code,
        'body': request.text
    }

Utilisation des distributions manylinux de roues

Parfois, un package que vous souhaitez inclure en tant que dépendance n'aura pas de roue universelle (en particulier, il n'en a pas any comme balise de plate-forme). Dans ce cas, téléchargez manylinux plutôt la roue qui le supporte. Cela garantit que vos bibliothèques de couches sont compatibles avec Amazon Linux.

numpyest un ensemble qui n'a pas de roue universelle. Si vous souhaitez inclure le numpy package dans votre couche, vous pouvez suivre les exemples d'étapes suivants pour installer et empaqueter correctement votre couche.

Pour télécharger cette couche sur Lambda, utilisez la commande suivante : PublishLayerVersion AWS CLI

aws lambda publish-layer-version --layer-name python-numpy-layer \
    --zip-file fileb://layer_content.zip \
    --compatible-runtimes python3.11 \
    --compatible-architectures "x86_64"

Dans la réponse, notez leLayerVersionArn, qui ressemble àarn:aws:lambda:us-east-1:123456789012:layer:python-numpy-layer:1. Pour vérifier que votre couche fonctionne comme prévu, déployez la fonction Lambda dans le function-numpy répertoire.