Configuring Lambda application
Deploying a Lambda application requires a
function.yaml file placing inside the application directory. That file contains values to be used to deploy Lambda function on your AWS cluster.
Currently, Piped supports deploying all types of Lambda deployment packages:
- container images (called container image as Lambda function)
.zipfile archives (which stored in AWS S3)
Besides, Piped also supports deploying your Lambda function directly from the function source code which is stored in a remote git repository.
Deploy container image as Lambda function
function.yaml file for container image as Lambda function used deployment as follows:
apiVersion: pipecd.dev/v1beta1 kind: LambdaFunction spec: name: SimpleFunction image: ecr.ap-northeast-1.amazonaws.com/lambda-test:v0.0.1 role: arn:aws:iam::76xxxxxxx:role/lambda-role # The amount of memory available to the Lambda application # at runtime. The value can be any multiple of 1 MB. memory: 512 # Timeout of the Lambda application, the value must # in between 1 to 900 seconds. timeout: 30 tags: app: simple environments: FOO: bar
tags and the
environments field, all others are required fields for the deployment to run.
role value represents the service role (for your Lambda function to run), not for Piped agent to deploy your Lambda application. To be able to pull container images from AWS ECR, besides policies to run as usual, you need to add
Lambda.ElasticContainerRegistry read permission to your Lambda function service role.
environments field represents environment variables that can be accessed by your Lambda application at runtime. In case of no value set for this field, all environment variables for the deploying Lambda application will be revoked, so make sure you set all currently required environment variables of your running Lambda application on
function.yaml if you migrate your app to PipeCD deployment.
Deploy .zip file archives as Lambda function
It’s recommended to use container image as Lambda function due to its simplicity, but as mentioned above, below is a sample
function.yaml file for Lambda which uses zip packing source code stored in AWS S3.
apiVersion: pipecd.dev/v1beta1 kind: LambdaFunction spec: name: SimpleZipPackingS3Function role: arn:aws:iam::76xxxxxxx:role/lambda-role # --- 3 next lines allow Piped to determine your Lambda function code stored in AWS S3. s3Bucket: pipecd-sample-lambda s3Key: pipecd-sample-src s3ObjectVersion: 1pTK9_v0Kd7I8Sk4n6abzCL # --- handler: app.lambdaHandler runtime: nodejs14.x memory: 512 timeout: 30 environments: FOO: bar tags: app: simple-zip-s3
Value for the
runtime field should be listed in AWS Lambda runtimes official docs. All other fields setting are remained as in the case of using container image as Lambda function pattern.
Deploy source code directly as Lambda function
In case you don’t have a separated CI pipeline that provides artifacts (such as container image, built zip files) as its outputs and want to set up a simple pipeline to deploy the Lambda function directly from your source code, this deployment package is for you.
apiVersion: pipecd.dev/v1beta1 kind: LambdaFunction spec: name: SimpleCanaryZipFunction role: arn:aws:iam::76xxxxxxx:role/lambda-role # source configuration use to determine the source code of your Lambda function. source: # git remote address where the source code is placing. git: firstname.lastname@example.org:username/lambda-function-code.git # the commit SHA or tag for remote git. Use branch name means you will always use # the latest code of that branch as Lambda function code which is NOT recommended. ref: dede7cdea5bbd3fdbcc4674bfcd2b2f9e0579603 # relative path from the repository root directory to the function code directory. path: hello-world handler: app.lambdaHandler runtime: nodejs14.x memory: 128 timeout: 5 tags: app: canary-zip
All other fields setting are remained as in the case of using .zip archives as Lambda function pattern.
By default, when the pipeline was not specified, PipeCD triggers a quick sync deployment for the merged pull request. Quick sync for a Lambda deployment will roll out the new version and switch all traffic to it.
Sync with the specified pipeline
The pipeline field in the application configuration is used to customize the way to do the deployment. You can add a manual approval before routing traffic to the new version or add an analysis stage the do some smoke tests against the new version before allowing them to receive the real traffic.
These are the provided stages for Lambda application you can use to build your pipeline:
- deploy workloads of the new version, but it is still receiving no traffic.
- promote the new version to receive an amount of traffic.
and other common stages:
See the description of each stage at Customize application deployment.
Here is an example that rolls out the new version gradually:
apiVersion: pipecd.dev/v1beta1 kind: LambdaApp spec: pipeline: stages: # Deploy workloads of the new version. # But this is still receiving no traffic. - name: LAMBDA_CANARY_ROLLOUT # Promote new version to receive 10% of traffic. - name: LAMBDA_PROMOTE with: percent: 10 - name: WAIT with: duration: 10m # Promote new version to receive 50% of traffic. - name: LAMBDA_PROMOTE with: percent: 50 - name: WAIT with: duration: 10m # Promote new version to receive all traffic. - name: LAMBDA_PROMOTE with: percent: 100
See Configuration Reference for the full configuration.
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.