Configuration des extensions Lambda

Configuration des extensions (archive de fichiers .zip)

Vous pouvez ajouter une extension à votre fonction en tant que couche Lambda. L'utilisation de couches vous permet de partager des extensions au sein de votre organisation ou avec l'ensemble de la communauté des développeurs Lambda. Vous pouvez ajouter une ou plusieurs extensions à une couche. Vous pouvez enregistrer jusqu'à 10 extensions pour une fonction.

Ajoutez l'extension à votre fonction en utilisant la même méthode que pour n'importe quelle couche. Pour en savoir plus, consultez Gestion des dépendances Lambda à l’aide de couches.

Ajout d'une extension à votre fonction (console)

1. Ouvrez la page Functions (Fonctions) de la console Lambda.

2. Choisissez une fonction.

3. Sélectionnez l'onglet Code s'il n'est pas déjà sélectionné.

4. Sous Layers (Couches), sélectionnez Edit (Modifier).

5. Pour Choose a layer (Choisir une couche), sélectionnez Specify an ARN (Spécifier un nom ARN).

6. Pour Specify an ARN (Spécifier un ARN), entrez l’Amazon Resource Name (ARN) d'une couche d'extension.

7. Choisissez Ajouter.

Utilisation des extensions dans les images de conteneur

Vous pouvez ajouter des extensions à votre image de conteneur. Le paramètre d'image de conteneur ENTRYPOINT détermine le processus principal de la fonction. Configurez le paramètre ENTRYPOINT dans le Dockerfile ou en tant que remplacement dans la configuration de la fonction.

Vous pouvez exécuter plusieurs traitements au sein d'un conteneur. Lambda gère le cycle de vie du traitement principal et tous les traitements supplémentaires. Lambda utilise l'API des extensions pour gérer le cycle de vie des extensions.

Exemple : ajout d'une extension externe

Une extension externe s'exécute dans un processus distinct de la fonction Lambda. Lambda démarre un traitement pour chaque extension dans le répertoire /opt/extensions/. Lambda utilise l'API d'extensions pour gérer le cycle de vie des extensions. Une fois l'exécution de la fonction terminée, Lambda envoie un événement Shutdown à chaque extension externe.

Exemple d'ajouter une extension externe à une image de base Python

FROM public.ecr.aws/lambda/python:3.11

# Copy and install the app
COPY /app /app
WORKDIR /app
RUN pip install -r requirements.txt

# Add an extension from the local directory into /opt
ADD my-extension.zip /opt
CMD python ./my-function.py

Étapes suivantes

Pour de plus amples informations sur les extensions, nous vous recommandons les ressources suivantes :

• Pour consulter un exemple pratique de base, consultez Building Extensions for AWS Lambda sur le blog AWS Compute.

• Pour plus d'informations sur les extensions fournies par les partenaires AWS Lambda, consultez Introducing AWS Lambda Extensions sur le blog AWS Compute.

• Pour consulter les exemples d'extensions disponibles et scripts encapsuleurs, reportez-vous à Extensions AWS Lambda sur le référentiel d'exemples AWS GitHub.