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.
Déployez les fonctions événementielles Rust Lambda avec des archives de fichiers .zip
Cette page décrit comment compiler votre fonction Rust Event, puis déployer le binaire compilé sur AWS Lambda en utilisant Cargo Lambda
Sections
Conditions préalables
Création de fonctions Rust sur macOS, Windows ou Linux
Les étapes suivantes montrent comment créer le projet pour votre première fonction Lambda avec Rust et le compiler avec Cargo Lambda
-
Installer Cargo Lambda
, une extension open source tierce de l'outil de ligne de commande Cargo qui simplifie la création et le déploiement des fonctions Rust Lambda : cargo install cargo-lambdaPour d'autres options d'installation, voir Installation
dans la documentation de Cargo Lambda. -
Créez la structure du package. Cette commande crée un code de fonction de base dans
src/main.rs. Vous pouvez utiliser ce code pour le tester ou le remplacer par le vôtre.cargo lambda newmy-function -
À l’intérieur du répertoire racine du package, exécutez la sous-commande build
pour compiler le code de votre fonction. cargo lambda build --release(Facultatif) Si vous souhaitez utiliser AWS Graviton sur Lambda, ajoutez le
--arm64indicateur pour compiler votre code pour les processeurs ARM.cargo lambda build --release --arm64 -
Avant de déployer votre fonction Rust, configurez AWS informations d'identification sur votre machine.
aws configure
Déploiement du binaire de la fonction Rust avec Cargo Lambda
Utilisez la sous-commande deploy
cargo lambda deploymy-function
Déploiement de votre binaire de fonction Rust avec le AWS CLI
Vous pouvez également déployer votre binaire avec AWS CLI.
-
Utilisez la sous-commande build
pour créer le package de déploiement .zip. cargo lambda build --release --output-format zip -
Pour déployer le package .zip vers Lambda, exécutez la commande create-function
. -
Pour
--runtime, spécifiezprovided.al2023. Il s'agit d'un OS-only exécution. OS-only les environnements d'exécution sont utilisés pour déployer des fichiers binaires compilés et des environnements d'exécution personnalisés sur Lambda. -
Pour
--role, spécifiez l’ARN du rôle d’exécution.
aws lambda create-function \ --function-namemy-function\ --runtimeprovided.al2023\ --rolearn:aws:iam::111122223333:role/lambda-role\ --handler rust.handler \ --zip-file fileb://target/lambda/my-function/bootstrap.zip -
Déploiement de votre binaire de fonction Rust avec le AWS SAM INTERFACE DE LIGNE DE COMMANDE (CLI)
Vous pouvez également déployer votre binaire avec AWS SAM CLI.
-
Créez un AWS SAM modèle avec la définition de la ressource et de la propriété. Pour
Runtime, spécifiezprovided.al2023. Il s'agit d'un OS-only exécution. OS-only les environnements d'exécution sont utilisés pour déployer des fichiers binaires compilés et des environnements d'exécution personnalisés sur Lambda.Pour plus d'informations sur le déploiement de fonctions Lambda à l'aide de AWS SAM, voir AWS::Serverless::Fonction dans le AWS Serverless Application Model Guide du développeur.
Exemple Définition des ressources et des propriétés SAM pour un binaire Rust
AWSTemplateFormatVersion: '2010-09-09' Transform: AWS::Serverless-2016-10-31 Description: SAM template for Rust binaries Resources: RustFunction: Type: AWS::Serverless::Function Properties: CodeUri: target/lambda/my-function/ Handler: rust.handler Runtime: provided.al2023 Outputs: RustFunction: Description: "Lambda Function ARN" Value: !GetAtt RustFunction.Arn -
Utilisez la sous-commande build
pour compiler la fonction. cargo lambda build --release -
Utilisez la commande sam deploy pour déployer la fonction vers Lambda.
sam deploy --guided
Pour plus d'informations sur la création de fonctions Rust avec le AWS SAM CLI, voir Création de fonctions Rust Lambda avec Cargo Lambda dans le AWS Serverless Application Model Guide du développeur.
Invocation de votre fonction Rust avec Cargo Lambda
Utilisez la sous-commande invoke
cargo lambda invoke --remote --data-ascii '{"command": "Hello world"}'my-function
Invoquer votre fonction Rust avec le AWS CLI
Vous pouvez également utiliser le AWS CLI pour invoquer la fonction.
aws lambda invoke --function-namemy-function--cli-binary-format raw-in-base64-out --payload '{"command": "Hello world"}' /tmp/out.txt
Le cli-binary-format l'option est requise si vous utilisez AWS CLI version 2. Pour faire de ce paramètre le paramètre par défaut, exécutez aws configure set cli-binary-format raw-in-base64-out. Pour plus d’informations, consultez les options de ligne de commande globales prises en charge par l’AWS CLI dans le Guide de l’utilisateur AWS Command Line Interface version 2.