Travailler avec des archives de fichiers .zip pour les fonctions Lambda Python

Le code de votre AWS Lambda fonction comprend un fichier .py contenant le code du gestionnaire de votre fonction, ainsi que les packages et modules supplémentaires dont dépend votre code. Pour déployer ce code de fonction vers Lambda, vous utilisez un package de déploiement. Ce package peut être une archive de fichier .zip ou une image de conteneur. Pour plus d'informations sur l'utilisation d'images de conteneur avec Python, consultez la page Déployer des fonctions Lambda Python avec des images de conteneur.

Pour créer votre package de déploiement sous forme d'archive de fichier .zip, vous pouvez utiliser l'utilitaire d'archivage .zip intégré à votre outil de ligne de commande, ou tout autre utilitaire .zip tel que 7zip. Les exemples présentés dans les sections suivantes supposent que vous utilisez un outil zip de ligne de commande dans un environnement Linux ou macOS. Pour utiliser les mêmes commandes sous Windows, vous pouvez installer le sous-système Windows pour Linux afin d’obtenir une version intégrée à Windows d’Ubuntu et de Bash.

Notez que Lambda utilise les autorisations de fichiers POSIX. Ainsi, vous pourriez devoir définir des autorisations pour le dossier du package de déploiement avant de créer l'archive de fichiers .zip.

Dépendances d'exécution dans Python

Pour les fonctions Lambda qui utilisent l'exécution Python, une dépendance peut être n'importe quel package ou module Python. Lorsque vous déployez votre fonction à l'aide d'une archive .zip, vous pouvez soit ajouter ces dépendances à votre fichier .zip avec votre code de fonction, soit utiliser une couche Lambda. Une couche est un fichier .zip séparé qui peut contenir du code supplémentaire et d'autres contenus. Pour en savoir plus sur l'utilisation des couches Lambda, consultez Utilisation de couches Lambda.

Les environnements d'exécution Lambda Python incluent le AWS SDK for Python (Boto3) et ses dépendances. Lambda fournit le kit SDK dans l'environnement d'exécution pour les scénarios de déploiement où vous n'êtes pas en mesure d'ajouter vos propres dépendances. Ces scénarios incluent la création de fonctions dans la console à l'aide de l'éditeur de code intégré ou à l'utilisation de fonctions intégrées dans AWS Serverless Application Model (AWS SAM) ou de AWS CloudFormation modèles.

Lambda met régulièrement à jour les bibliothèques d'exécution Python afin d'inclure les dernières mises à jour et correctifs de sécurité. Si votre fonction utilise la version du kit SDK Boto3 incluse dans l'exécution, mais que votre package de déploiement inclut des dépendances du kit SDK, cela peut entraîner des problèmes d'alignement de versions. Par exemple, votre package de déploiement peut inclure la dépendance du kit SDK urllib3. Lorsque Lambda met à jour le kit SDK dans l'exécution, des problèmes de compatibilité entre la nouvelle version de l'exécution et la version d'urllib3 de votre package de déploiement peuvent faire échouer votre fonction.

Important

Pour conserver un contrôle total sur vos dépendances et éviter d'éventuels problèmes d'alignement de versions, nous vous recommandons d'ajouter toutes les dépendances de votre fonction à votre package de déploiement, même si des versions de celles-ci sont incluses dans l'exécution Lambda. Cela inclut le kit SDK Boto3.

Pour savoir quelle version du SDK pour Python (Boto3) est incluse dans le moteur d'exécution que vous utilisez, consultez. Versions du SDK incluses dans Runtime

Dans le cadre du modèle de responsabilité partagée AWS, vous êtes responsable de la gestion de toutes les dépendances dans les packages de déploiement de vos fonctions. Cela inclut l’application de mises à jour et de correctifs de sécurité. Pour mettre à jour les dépendances dans le package de déploiement de votre fonction, créez d’abord un nouveau fichier .zip, puis chargez-le sur Lambda. Pour plus d’informations, consultez Création d'un package de déploiement .zip avec dépendances et Création et mise à jour de fonctions Lambda Python à l'aide de fichiers .zip.

Création d'un package de déploiement .zip sans dépendances

Si le code de votre fonction ne comporte aucune dépendance, votre fichier .zip contient uniquement le fichier .py contenant le code du gestionnaire de votre fonction. Utilisez votre utilitaire zip préféré pour créer un fichier .zip avec votre fichier .py à la racine. Si le fichier .py ne se trouve pas à la racine de votre fichier .zip, Lambda ne sera pas en mesure d'exécuter votre code.

Pour savoir comment déployer votre fichier .zip pour créer une nouvelle fonction Lambda ou mettre à jour une fonction Lambda existante, veuillez consulter la rubrique Création et mise à jour de fonctions Lambda Python à l'aide de fichiers .zip.

Création d'un package de déploiement .zip avec dépendances

Si votre code de fonction dépend de packages ou de modules supplémentaires, vous pouvez soit ajouter ces dépendances à votre fichier .zip avec votre code de fonction, soit utiliser une couche Lambda. Les instructions de cette section vous indiquent comment inclure vos dépendances dans votre package de déploiement .zip. Pour que Lambda puisse exécuter votre code, le fichier .py contenant le code de votre gestionnaire et toutes les dépendances de votre fonction doit être installé à la racine du fichier .zip.

Supposons que votre code de fonction soit enregistré dans un fichier nommé lambda_function.py. L'exemple de commandes d'interface de ligne de commande suivant crée un fichier .zip nommé my_deployment_package.zip contenant le code de votre fonction et ses dépendances. Vous pouvez soit installer vos dépendances directement dans un dossier du répertoire de votre projet, soit utiliser un environnement virtuel Python.

Pour créer le package de déploiement (répertoire du projet)

1. Accédez au répertoire du projet qui contient votre fichier de code source lambda_function.py. Dans cet exemple, le répertoire est nommé my_function.

   cd my_function

2. Créez un nouveau répertoire nommé « package » dans lequel vous installerez vos dépendances.

   mkdir package

   Notez que pour un package de déploiement .zip, Lambda s'attend à ce que votre code source et ses dépendances se trouvent tous à la racine du fichier .zip. Toutefois, l'installation de dépendances directement dans le répertoire de votre projet peut introduire un grand nombre de nouveaux fichiers et dossiers et rendre la navigation dans votre IDE difficile. Vous créez ici un répertoire package distinct pour séparer vos dépendances de votre code source.

3. Installez les dépendances dans le répertoire package. L'exemple ci-dessous installe le kit SDK Boto3 à partir de l'index du Python Package Index à l'aide de pip. Si le code de votre fonction utilise des packages Python que vous avez créés vous-même, enregistrez-les dans le répertoire package.

   pip install --target ./package boto3

4. Créez un fichier .zip avec les bibliothèques installées à la racine.

   cd package
   zip -r ../my_deployment_package.zip .

   Cela génère un fichier my_deployment_package.zip dans votre répertoire de projet.

5. Ajoutez le fichier lambda_function.py à la racine du fichier .zip.

   cd ..
   zip my_deployment_package.zip lambda_function.py

   Votre fichier .zip doit avoir une structure de répertoires horizontale, avec le code du gestionnaire de votre fonction et tous vos dossiers de dépendances installés à la racine comme suit.

   my_deployment_package.zip
   |- bin
   |  |-jp.py
   |- boto3
   |  |-compat.py
   |  |-data
   |  |-docs
   ...
   |- lambda_function.py

   Si le fichier .py contenant le code du gestionnaire de votre fonction ne se trouve pas à la racine de votre fichier .zip, Lambda ne sera pas en mesure d'exécuter votre code.

Pour créer le package de déploiement (environnement virtuel)

1. Créez et activez un environnement virtuel dans le répertoire de votre projet. Dans cet exemple, le répertoire du projet est nommé my_function.

   ~$ cd my_function
   ~/my_function$ python3.12 -m venv my_virtual_env
   ~/my_function$ source ./my_virtual_env/bin/activate

2. Installez les bibliothèques requises à l'aide de pip. L'exemple suivant permet d'installer le kit SDK Boto3

   (my_virtual_env) ~/my_function$ pip install boto3

3. Utilisez pip show pour trouver l'emplacement dans votre environnement virtuel où pip a installé vos dépendances.

   (my_virtual_env) ~/my_function$ pip show <package_name>

   Le dossier dans lequel pip installe vos bibliothèques peut être nommé site-packages ou dist-packages. Ce dossier peut se trouver dans le répertoire lib/python3.x ou lib64/python3.x (où python3.x représente la version de Python que vous utilisez).

4. Désactivation de l'environnement virtuel

   (my_virtual_env) ~/my_function$ deactivate

5. Accédez au répertoire contenant les dépendances que vous avez installées avec pip et créez un fichier .zip dans le répertoire de votre projet avec les dépendances installées à la racine. Dans cet exemple, pip a installé vos dépendances dans le répertoire my_virtual_env/lib/python3.12/site-packages.

   ~/my_function$ cd my_virtual_env/lib/python3.12/site-packages
   ~/my_function/my_virtual_env/lib/python3.12/site-packages$ zip -r ../../../../my_deployment_package.zip .

6. Accédez à la racine du répertoire de votre projet où se trouve le fichier .py contenant le code de votre gestionnaire et ajoutez ce fichier à la racine de votre package .zip. Dans cet exemple, votre fichier de code de fonction est nommé lambda_function.py.

   ~/my_function/my_virtual_env/lib/python3.12/site-packages$ cd ../../../../
   ~/my_function$ zip my_deployment_package.zip lambda_function.py

Création d'une couche Python pour vos dépendances

Les instructions de cette section vous indiquent comment inclure les dépendances dans une couche. Pour obtenir des instructions sur la façon d’inclure vos dépendances dans votre package de déploiement, voir Création d'un package de déploiement .zip avec dépendances.

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 vous assurer que le contenu de votre couche est pris en charge par la variable PATH, incluez le contenu dans les chemins de dossier suivants :

• python

• python/lib/python3.10/site-packages (répertoires de site)

Par exemple, la structure du fichier .zip de votre couche peut ressembler à ce qui suit :

pillow.zip
│ python/PIL
└ python/Pillow-5.3.0.dist-info

En outre, Lambda détecte automatiquement toutes les bibliothèques dans le répertoire /opt/lib et tous les fichiers binaires dans le répertoire /opt/bin. Pour que Lambda trouve correctement le contenu de votre couche, vous pouvez aussi créer une couche avec la structure suivante :

custom-layer.zip
└ lib
    | lib_1
    | lib_2
└ bin
    | bin_1
    | bin_2

Après avoir empaqueté votre couche, reportez-vous à Création et suppression de couches dans Lambda et à Ajout de couches aux fonctions pour terminer la configuration de votre couche.

Chemin de recherche des dépendances et bibliothèques incluses dans l’exécution

Lorsque vous utilisez une instruction import dans votre code, l'exécution Python recherche les répertoires dans son chemin de recherche jusqu'à ce qu'elle trouve le module ou le package. Par défaut, le premier emplacement dans lequel recherche l'exécution est le répertoire dans lequel votre package de déploiement .zip est décompressé et monté (/var/task). Si vous ajoutez une version d'une bibliothèque incluse dans l'exécution dans votre package de déploiement, votre version aura la priorité sur la version incluse dans l'exécution. Les dépendances de votre package de déploiement ont également la priorité sur les dépendances des couches.

Lorsque vous ajoutez une dépendance à une couche, Lambda l'extrait vers /opt/python/lib/python3.x/site-packages (où python3.x représente la version de l'exécution que vous utilisez) ou /opt/python. Dans le chemin de recherche, ces répertoires ont la priorité sur les répertoires contenant les bibliothèques incluses dans l'exécution et les bibliothèques installées par pip (/var/runtime et /var/lang/lib/python3.x/site-packages). Les bibliothèques des couches de fonctions ont donc la priorité sur les versions incluses dans l’exécution.

Note

Dans le runtime géré et l'image de base de Python 3.11, le AWS SDK et ses dépendances sont installés dans le /var/lang/lib/python3.11/site-packages répertoire.

Vous pouvez voir le chemin de recherche complet de votre fonction Lambda en ajoutant l'extrait de code suivant.

import sys
      
search_path = sys.path
print(search_path)

Note

Étant donné que les dépendances de votre package de déploiement ou de vos couches sont prioritaires sur les bibliothèques incluses dans l'exécution, cela peut entraîner des problèmes d'alignement de versions si vous incluez une dépendance du kit SDK telle que urllib3 dans votre package sans inclure également le kit SDK. Si vous déployez votre propre version d'une dépendance de Boto3, vous devez également déployer Boto3 en tant que dépendance dans votre package de déploiement. Nous vous recommandons de regrouper toutes les dépendances de votre fonction, même si des versions de celles-ci sont incluses dans l'exécution.

Vous pouvez également ajouter des dépendances dans un dossier distinct au sein de votre package .zip. Par exemple, vous pouvez ajouter une version du kit SDK Boto3 dans un dossier de votre package .zip appelé common. Lorsque votre package .zip est décompressé et monté, ce dossier est placé dans le répertoire /var/task. Pour utiliser dans votre code une dépendance provenant d'un dossier de votre package de déploiement .zip, utilisez une instruction import from. Par exemple, pour utiliser une version de Boto3 provenant d'un dossier nommé common dans votre package .zip, utilisez l'instruction suivante.

from common import boto3

Utilisation des dossiers __pycache__

Nous vous recommandons de ne pas inclure de dossiers __pycache__ dans le package de déploiement de votre fonction. Le bytecode Python compilé sur une machine de génération avec une architecture ou un système d'exploitation différent peut ne pas être compatible avec l'environnement d'exécution Lambda.

Création de packages de déploiement .zip avec des bibliothèques natives

Si votre fonction utilise uniquement des packages et des modules Python purs, vous pouvez utiliser la commande pip install pour installer vos dépendances sur n'importe quelle machine de génération locale et créer votre fichier .zip. De nombreuses bibliothèques Python populaires, y compris NumPy Pandas, ne sont pas du Python pur et contiennent du code écrit en C ou C++. Lorsque vous ajoutez des bibliothèques contenant du code C/C++ à votre package de déploiement, vous devez créer votre package correctement pour vous assurer qu'il est compatible avec l'environnement d'exécution Lambda.

La plupart des packages disponibles sur le Python Package Index (PyPI) sont disponibles sous forme de « wheels » (fichiers .whl). Un fichier .whl est un type de fichier ZIP qui contient une distribution intégrée avec des fichiers binaires précompilés pour un système d'exploitation et une architecture de l'ensemble des instructions particuliers. Pour rendre votre package de déploiement compatible avec Lambda, vous devez installer le fichier wheel pour les systèmes d'exploitation Linux et l'architecture de l'ensemble d'instructions de votre fonction.

Certains packages peuvent uniquement être disponibles en tant que distributions sources. Pour ces packages, vous devez compiler et créer vous-même les composants C/C++.

Pour connaître les distributions disponibles pour le package dont vous avez besoin, procédez comme suit :

1. Recherchez le nom du package sur la page principale du Python Package Index.

2. Choisissez la version du package que vous souhaitez utiliser.

3. Choisissez Télécharger les fichiers.

Utilisation des distributions intégrées (fichiers wheels)

Pour télécharger un fichier wheel compatible avec Lambda, utilisez l'option --platform pip.

Si votre fonction Lambda utilise l'architecture de l'ensemble d'instructions x86_64, exécutez la commande pip install suivante pour installer un fichier wheel compatible dans votre répertoire package. Remplacez --python 3.x par la version d'exécution Python que vous utilisez.

pip install \
--platform manylinux2014_x86_64 \
--target=package \
--implementation cp \
--python-version 3.x \
--only-binary=:all: --upgrade \
<package_name>

Si votre fonction utilise l'architecture de l'ensemble d'instructions arm64, exécutez la commande suivante. Remplacez --python 3.x par la version d'exécution Python que vous utilisez.

pip install \
--platform manylinux2014_aarch64 \
--target=package \
--implementation cp \
--python-version 3.x \
--only-binary=:all: --upgrade \
<package_name>

Utilisation des distributions sources

Si votre package n'est disponible que sous la forme d'une distribution source, vous devez créer vous-même les bibliothèques C/C++. Pour rendre votre package compatible avec l'environnement d'exécution Lambda, vous devez le créer dans un environnement qui utilise le même système d'exploitation Amazon Linux 2. Pour ce faire, créez votre package dans une instance Amazon EC2 Linux.

Pour savoir comment lancer une instance Amazon EC2 Linux et s'y connecter, veuillez consulter la rubrique Didacticiel : premiers pas avec les instances Amazon EC2 Linux dans le Guide de l'utilisateur Amazon EC2 pour les instances Linux.

Création et mise à jour de fonctions Lambda Python à l'aide de fichiers .zip

Une fois que vous avez créé votre package de déploiement .zip, vous pouvez l'utiliser pour créer une nouvelle fonction Lambda ou mettre à jour une fonction Lambda existante. Vous pouvez déployer votre package .zip à l'aide de la console Lambda, de l'API Lambda et AWS Command Line Interface de l'API Lambda. Vous pouvez également créer et mettre à jour des fonctions Lambda à l’aide de l’ AWS Serverless Application Model (AWS SAM) et de AWS CloudFormation.

La taille maximale d’un package de déploiement .zip pour Lambda est de 250 Mo (décompressé). Notez que cette limite s’applique à la taille combinée de tous les fichiers que vous chargez, y compris les couches Lambda.

Le runtime Lambda a besoin d’une autorisation pour lire les fichiers de votre package de déploiement. Dans la notation octale des autorisations Linux, Lambda a besoin de 644 autorisations pour les fichiers non exécutables (rw-r--r--) et de 755 autorisations () pour les répertoires et les fichiers exécutables. rwxr-xr-x

Sous Linux et macOS, utilisez la commande chmod pour modifier les autorisations de fichiers sur les fichiers et les répertoires de votre package de déploiement. Par exemple, pour accorder les autorisations appropriées à un fichier exécutable, exécutez la commande suivante.

chmod 755 <filepath>

Pour modifier les autorisations relatives aux fichiers dans Windows, voir Définir, afficher, modifier ou supprimer des autorisations sur un objet dans la documentation Microsoft Windows.

Création et mise à jour de fonctions avec des fichiers .zip à l’aide de la console

Pour créer une nouvelle fonction, vous devez d’abord créer la fonction dans la console, puis charger votre archive .zip. Pour mettre à jour une fonction existante, ouvrez la page de votre fonction, puis suivez la même procédure pour ajouter votre fichier .zip mis à jour.

Si votre fichier .zip fait moins de 50 Mo, vous pouvez créer ou mettre à jour une fonction en chargeant le fichier directement à partir de votre ordinateur local. Pour les fichiers .zip de plus de 50 Mo, vous devez d’abord charger votre package dans un compartiment Amazon S3. Pour savoir comment charger un fichier dans un compartiment Amazon S3 à l'aide du AWS Management Console, consultez Getting started with Amazon S3. Pour télécharger des fichiers à l'aide de AWS CLI, voir Déplacer des objets dans le guide de AWS CLI l'utilisateur.

Note

Vous ne pouvez pas modifier le type de package de déploiement (.zip ou image de conteneur) pour une fonction existante. Par exemple, vous ne pouvez pas convertir une fonction d'image de conteneur pour utiliser une archive de fichier .zip. Vous devez créer une nouvelle fonction.

Pour créer une nouvelle fonction (console)

1. Ouvrez la page Fonctions de la console Lambda et choisissez Créer une fonction.

2. Choisissez Créer à partir de zéro.

3. Sous Informations de base, procédez comme suit :

   1. Pour Nom de la fonction, saisissez le nom de la fonction.

   2. Pour Exécution, sélectionnez l’exécution que vous souhaitez utiliser.

   3. (Facultatif) Pour Architecture, choisissez l’architecture de l’ensemble des instructions pour votre fonction. L’architecture par défaut est x86_64. Assurez-vous que le package de déploiement .zip pour votre fonction est compatible avec l’architecture de l’ensemble d’instructions que vous sélectionnez.

4. (Facultatif) Sous Permissions (Autorisations), développez Change default execution role (Modifier le rôle d’exécution par défaut). Vous pouvez créer un rôle d’exécution ou en utiliser un existant.

5. Choisissez Créer une fonction. Lambda crée une fonction de base « Hello world » à l’aide de l’exécution de votre choix.

Pour charger une archive .zip à partir de votre ordinateur local (console)

1. Sur la page Fonctions de la console Lambda, choisissez la fonction pour laquelle vous souhaitez charger le fichier .zip.

2. Sélectionnez l’onglet Code.

3. Dans le volet Source du code, choisissez Charger à partir de.

4. Choisissez Fichier .zip.

5. Pour charger un fichier .zip, procédez comme suit :

   1. Sélectionnez Charger, puis choisissez votre fichier .zip dans le sélecteur de fichiers.

   2. Choisissez Ouvrir.

   3. Choisissez Enregistrer.

Pour charger une archive .zip depuis un compartiment Amazon S3 (console)

1. Sur la page Fonctions de la console Lambda, choisissez la fonction pour laquelle vous souhaitez charger un nouveau fichier .zip.

2. Sélectionnez l’onglet Code.

3. Dans le volet Source du code, choisissez Charger à partir de.

4. Choisissez l’emplacement Amazon S3.

5. Collez l’URL du lien Amazon S3 de votre fichier .zip et choisissez Enregistrer.

Mise à jour des fonctions du fichier .zip à l’aide de l’éditeur de code de la console

Pour certaines fonctions avec des packages de déploiement .zip, vous pouvez utiliser l’éditeur de code intégré de la console Lambda pour mettre à jour le code de votre fonction directement. Pour utiliser cette fonctionnalité, votre fonction doit répondre aux critères suivants :

• Votre fonction doit utiliser l’une des exécutions des langages interprétés (Python, Node.js ou Ruby).

• Le package de déploiement de votre fonction doit être inférieur à 3 Mo.

Le code des fonctions avec les packages de déploiement d’images de conteneurs ne peut pas être édité directement dans la console.

Pour mettre à jour le code de fonction à l’aide de l’éditeur de code de la console

1. Ouvrez la page Fonctions de la console Lambda et choisissez votre fonction.

2. Sélectionnez l’onglet Code.

3. Dans le volet Source du code, sélectionnez votre fichier de code source et modifiez-le dans l’éditeur de code intégré.

4. Lorsque vous avez fini de modifier votre code, choisissez Déployer pour enregistrer vos modifications et mettre à jour votre fonction.

Création et mise à jour de fonctions avec des fichiers .zip à l'aide du AWS CLI

Vous pouvez utiliser l’AWS CLI pour créer une nouvelle fonction ou pour mettre à jour une fonction existante à l’aide d’un fichier .zip. Utilisez la fonction de création et update-function-codeles commandes pour déployer votre package .zip. Si votre fichier .zip est inférieur à 50 Mo, vous pouvez charger le package .zip à partir d’un emplacement de fichier sur votre machine de génération locale. Pour les fichiers plus volumineux, vous devez charger votre package .zip à partir d’un compartiment Amazon S3. Pour savoir comment charger un fichier dans un compartiment Amazon S3 à l'aide du AWS CLI, consultez la section Déplacer des objets dans le guide de AWS CLI l'utilisateur.

Note

Si vous chargez votre fichier .zip depuis un compartiment Amazon S3 à l'aide de AWS CLI, le compartiment doit se trouver au même endroit Région AWS que votre fonction.

Pour créer une nouvelle fonction à l'aide d'un fichier .zip avec le AWS CLI, vous devez spécifier les éléments suivants :

• Le nom de votre fonction (--function-name)

• L’exécution de votre fonction (--runtime)

• L’Amazon Resource Name (ARN) du rôle d’exécution de votre fonction (--role)

• Le nom de la méthode du gestionnaire dans votre code de fonction (--handler)

Vous devez également indiquer l’emplacement de votre fichier .zip. Si votre fichier .zip se trouve dans un dossier sur votre machine de génération locale, utilisez l’option --zip-file pour spécifier le chemin d’accès du fichier, comme le montre l’exemple de commande suivant.

aws lambda create-function --function-name myFunction \
--runtime python3.12 --handler lambda_function.lambda_handler \
--role arn:aws:iam::111122223333:role/service-role/my-lambda-role \
--zip-file fileb://myFunction.zip

Pour spécifier l’emplacement du fichier .zip dans un compartiment Amazon S3, utilisez l’option --code comme le montre l’exemple de commande suivant. Vous devez uniquement utiliser le paramètre S3ObjectVersion pour les objets soumis à la gestion des versions.

aws lambda create-function --function-name myFunction \
--runtime python3.12 --handler lambda_function.lambda_handler \
--role arn:aws:iam::111122223333:role/service-role/my-lambda-role \
--code S3Bucket=myBucketName,S3Key=myFileName.zip,S3ObjectVersion=myObjectVersion

Pour mettre à jour une fonction existante à l’aide de l’interface de ligne de commande, vous devez spécifier le nom de votre fonction à l’aide du paramètre --function-name. Vous devez également spécifier l’emplacement du fichier .zip que vous souhaitez utiliser pour mettre à jour votre code de fonction. Si votre fichier .zip se trouve dans un dossier sur votre machine de génération locale, utilisez l’option --zip-file pour spécifier le chemin d’accès du fichier, comme le montre l’exemple de commande suivant.

aws lambda update-function-code --function-name myFunction \
--zip-file fileb://myFunction.zip

Pour spécifier l’emplacement du fichier .zip dans un compartiment Amazon S3, utilisez les options --s3-bucket et --s3-key comme le montre l’exemple de commande suivant. Vous devez uniquement utiliser le paramètre --s3-object-version pour les objets soumis à la gestion des versions.

aws lambda update-function-code --function-name myFunction \
--s3-bucket myBucketName --s3-key myFileName.zip --s3-object-version myObject Version

Création et mise à jour de fonctions avec des fichiers .zip à l’aide de l’API Lambda

Pour créer et mettre à jour des fonctions à l’aide d’une archive de fichiers .zip, utilisez les opérations d’API suivantes :

• CreateFunction

• UpdateFunctionCode

Création et mise à jour de fonctions avec des fichiers .zip à l'aide de AWS SAM

The AWS Serverless Application Model (AWS SAM) est une boîte à outils qui permet de rationaliser le processus de création et d'exécution d'applications sans serveur sur AWS. Vous définissez les ressources de votre application dans un modèle YAML ou JSON et vous utilisez l'interface de ligne de AWS SAM commande (AWS SAM CLI) pour créer, empaqueter et déployer vos applications. Lorsque vous créez une fonction Lambda à partir d'un AWS SAM modèle, elle crée AWS SAM automatiquement un package de déploiement ou une image de conteneur .zip avec le code de votre fonction et les dépendances que vous spécifiez. Pour en savoir plus sur l'utilisation des fonctions Lambda AWS SAM pour créer et déployer des fonctions Lambda, consultez la section Getting started with AWS SAM dans le Guide du AWS Serverless Application Model développeur.

Vous pouvez également l'utiliser AWS SAM pour créer une fonction Lambda à l'aide d'une archive de fichiers .zip existante. Pour créer une fonction Lambda à l'aide de AWS SAM, vous pouvez enregistrer votre fichier .zip dans un compartiment Amazon S3 ou dans un dossier local sur votre machine de génération. Pour savoir comment charger un fichier dans un compartiment Amazon S3 à l'aide du AWS CLI, consultez la section Déplacer des objets dans le guide de AWS CLI l'utilisateur.

Dans votre AWS SAM modèle, la AWS::Serverless::Function ressource spécifie votre fonction Lambda. Dans cette ressource, définissez les propriétés suivantes pour créer une fonction à l’aide d’une archive de fichiers .zip :

• PackageType : défini sur Zip

• CodeUri- défini sur l'URI Amazon S3, le chemin d'accès au dossier local ou à l'FunctionCodeobjet du code de fonction

• Runtime : défini sur votre exécution choisie

Ainsi AWS SAM, si votre fichier .zip est supérieur à 50 Mo, vous n'avez pas besoin de le télécharger au préalable dans un compartiment Amazon S3. AWS SAM peut télécharger des packages .zip jusqu'à la taille maximale autorisée de 250 Mo (décompressés) à partir d'un emplacement sur votre machine de compilation locale.

Pour en savoir plus sur le déploiement de fonctions à l'aide d'un fichier .zip dans AWS SAM, consultez AWS::Serverless::Functionle manuel du AWS SAM développeur.

Création et mise à jour de fonctions avec des fichiers .zip à l'aide de AWS CloudFormation

Vous pouvez l'utiliser AWS CloudFormation pour créer une fonction Lambda à l'aide d'une archive de fichiers .zip. Pour créer une fonction Lambda à partir d’un fichier .zip, vous devez d’abord charger votre fichier dans un compartiment Amazon S3. Pour savoir comment charger un fichier dans un compartiment Amazon S3 à l'aide du AWS CLI, consultez la section Déplacer des objets dans le guide de AWS CLI l'utilisateur.

Pour les environnements d'exécution Node.js et Python, vous pouvez également fournir du code source intégré dans votre AWS CloudFormation modèle. AWS CloudFormation crée ensuite un fichier .zip contenant votre code lorsque vous créez votre fonction.

Utilisation d'un fichier .zip existant

Dans votre AWS CloudFormation modèle, la AWS::Lambda::Function ressource spécifie votre fonction Lambda. Dans cette ressource, définissez les propriétés suivantes pour créer une fonction à l’aide d’une archive de fichiers .zip :

• PackageType : défini sur Zip

• Code : saisissez le nom du compartiment Amazon S3 et le nom du fichier .zip dans les champs S3Bucket et S3Key

• Runtime : défini sur votre exécution choisie

Création d'un fichier .zip à partir du code en ligne

Vous pouvez déclarer des fonctions simples écrites en Python ou en Node.js en ligne dans un AWS CloudFormation modèle. Le code étant intégré dans YAML ou JSON, vous ne pouvez pas ajouter de dépendances externes à votre package de déploiement. Cela signifie que votre fonction doit utiliser la version du AWS SDK incluse dans le runtime. Les exigences du modèle, telles que l'obligation d'échapper certains caractères, rendent également plus difficile l'utilisation des fonctionnalités de vérification syntaxique et de complétion de code de votre IDE. Cela signifie que votre modèle peut nécessiter des tests supplémentaires. En raison de ces limitations, la déclaration de fonctions en ligne convient mieux à un code très simple qui ne change pas fréquemment.

Pour créer un fichier .zip à partir du code en ligne pour les exécutions Node.js et Python, définissez les propriétés suivantes dans la ressource AWS::Lambda::Function de votre modèle :

• PackageType : défini sur Zip

• Code : saisissez votre code de fonction dans le champ ZipFile

• Runtime : défini sur votre exécution choisie

Le fichier .zip AWS CloudFormation généré ne peut pas dépasser 4 Mo. Pour en savoir plus sur le déploiement de fonctions à l'aide d'un fichier .zip dans AWS CloudFormation, consultez AWS::Lambda::Functionle Guide de l'AWS CloudFormation utilisateur.