AWS Container Plugin

The AWS container plugin allows you to create, update, invoke, and delete Lambda functions using packages such as .zip files or container images.

important

You must set up a connection to the AWS server before adding AWS tasks. For more information, see Set up Connection to AWS Server.

note

In the release flow editor, Container tasks have a blue border.

AWS provides the following features:

• Create Function and Update Function using Image
• Create Function and Update Function using S3 zip
• Delete Function and Invoke Function

Prerequisites

For AWS integration, you need the following:

• AWS server running and accessible via HTTP(s)
• Remote runner setup to run the container tasks

Set up Connection to AWS Server

1. From the navigation pane, under CONFIGURATION, click Connections.
2. Under HTTP Server connections, next to AWS: Server (Container), click . The New AWS: Server (Container) page opens.
3. In the Title field, enter a name for the configuration.
4. In the Access Key ID field, enter the AWS access key id.
5. In the Secret Access Key field, enter the AWS secret access key.
6. If required, enter proxy details.
7. To test the connection, click Test.
8. To save the configuration, click Save.

Create Function Using Image (Container)

The Create Function Using Image (Container) task creates a Lambda function using the image.

1. In the release flow tab of a Release template, add a task of type AWS > Create Function Using Image (Container).
2. Click the added task to open it.
3. In the Capabilities field, enter a value that matches the capability set for your remote runner. This will help you to route jobs to that particular remote runner.
4. In the AWS Server field, select the configured AWS server.
5. In the Region field, enter the AWS region to be used.
6. In the Function Name field, enter the AWS Lambda function name.
7. In the Function Description field, enter a description for the AWS Lambda function.
8. In the Role field, enter the Amazon Resource Name (ARN) of the IAM role.
9. In the Image Uri field, enter the URI of a container image in the Amazon ECR registry.
10. If you want to wait for the function to become active, turn on the Wait for Active State toggle button.
11. In the Wait Interval field, enter the value in seconds to define the wait interval between each attempt.
12. In the ENTRYPOINT Override field, enter a value to override the entry point value in the image configuration.
13. In the CMD Override field, enter a value to override the cmd value in the image configuration.
14. In the WORKDIR Override field, enter a value to override the workdir value in the image configuration.
15. In the Subnet Ids field, enter one or multiple VPC subnet IDs, separating them using commas.
16. In the Security Group Ids field, enter one or multiple VPC security group IDs, separating them using commas.
17. In the Timeout field, enter the timeout in seconds.
18. In the Memory Size field, enter the memory capacity given to the Lambda function in MB.
19. In the Environment table, add the environments in key-value pairs that are accessible from function code during execution.
20. If you want to publish the first version of the function during creation, turn on the Publish toggle button.
21. In the Tags table, add the tags in key-value pairs that are assigned to the new function.

Update Function Using Image (Container)

The Update Function Using Image (Container) task updates a Lambda function using the image.

1. In the release flow tab of a Release template, add a task of type AWS > Update Function Using Image (Container).
2. Click the added task to open it.
3. In the Capabilities field, enter a value that matches the capability set for your remote runner. This will help you to route jobs to that particular remote runner.
4. In the AWS Server field, select the configured AWS server.
5. In the Region field, enter the AWS region to be used.
6. In the Function Name field, enter the AWS Lambda function name.
7. In the Image Uri field, enter the URI of a container image in the Amazon ECR registry.
8. If you want to wait for the function to get updated and become successful, turn on the Wait for Successful Status toggle button.
9. In the Wait Interval field, enter the value in seconds to define the wait interval between each attempt.
10. If you want to publish the new version of the function after update, turn on the Publish toggle button.

Create Function Using S3 Zip (Container)

The Create Function Using S3 Zip (Container) task creates a Lambda function using the S3 zip.

1. In the release flow tab of a Release template, add a task of type AWS > Create Function Using S3 Zip (Container).
2. Click the added task to open it.
3. In the Capabilities field, enter a value that matches the capability set for your remote runner. This will help you to route jobs to that particular remote runner.
4. In the AWS Server field, select the configured AWS server.
5. In the Region field, enter the AWS region to be used.
6. In the Function Name field, enter the AWS Lambda function name.
7. In the Function Description field, enter a description for the AWS Lambda function.
8. In the S3 Bucket Name field, enter the S3 bucket name where the .zip file containing your deployment package is stored.
9. In the S3 Object Key field, enter the path to you .zip file containing your deployment package.
10. In the S3 Object Version field, enter the version of your deployment package.
11. In the Runtime field, enter the runtime environment for execution.
12. In the Role field, enter the Amazon Resource Name (ARN) of the IAM role.
13. In the Handler field, enter the function within your code that Lambda calls to begin the execution.
14. If you want to wait for the function to become active, turn on the Wait for Active State toggle button.
15. In the Wait Interval field, enter the value in seconds to define the wait interval between each attempt.
16. In the Timeout field, enter the timeout in seconds.
17. In the Subnet Ids field, enter one or multiple VPC subnet IDs, separating them using commas.
18. In the Security Group Ids field, enter one or multiple VPC security group IDs, separating them using commas.
19. In the Memory Size field, enter the memory capacity given to the Lambda function in MB.
20. In the Environment table, add the environments in key-value pairs that are accessible from function code during execution.
21. If you want to publish the first version of the function during creation, turn on the Publish toggle button.
22. In the Tags table, add the tags in key-value pairs that are assigned to the new function.

Update Function Using S3 Zip (Container)

The Update Function Using S3 Zip (Container) task updates a lambda function using the S3 zip.

1. In the release flow tab of a Release template, add a task of type AWS > Update Function Using S3 Zip (Container).
2. Click the added task to open it.
3. In the Capabilities field, enter a value that matches the capability set for your remote runner. This will help you to route jobs to that particular remote runner.
4. In the AWS Server field, select the configured AWS server.
5. In the Region field, enter the AWS region to be used.
6. In the Function Name field, enter the AWS Lambda function name that must be updated.
7. In the S3 Bucket Name field, enter the S3 bucket name where the .zip file containing your deployment package is stored.
8. In the S3 Object Key field, enter the path to you .zip file containing your deployment package.
9. In the S3 Object Version field, enter the version of your deployment package.
10. If you want to wait for the function to get updated and become successful, turn on the Wait for Successful Status toggle button.
11. In the Wait Interval field, enter the value in seconds to define the wait interval between each attempt.
12. If you want to publish the new version of the function after update, turn on the Publish toggle button.

Invoke Function (Container)

The Invoke Function Using S3 Zip (Container) task invokes a Lambda function.

1. In the release flow tab of a Release template, add a task of type AWS > Invoke Function (Container).
2. Click the added task to open it.
3. In the Capabilities field, enter a value that matches the capability set for your remote runner. This will help you to route jobs to that particular remote runner.
4. In the AWS Server field, select the configured AWS server.
5. In the Region field, enter the AWS region to be used.
6. In the Function Name field, enter the AWS Lambda function name that you want to invoke.
7. In the Invocation Type field, select a type from the drop-down list. This types defines how the function is invoked.
8. In the Paylod field, enter the JSON that you want to provide to your Lambda function as input.
9. In the Client Context field, enter the value of the client context.
10. In the Qualifier field, specify a version or alias to invoke a published version of the function.

Delete Function (Container)

The Delete Function Using S3 Zip (Container) task deletes a Lambda function.

1. In the release flow tab of a Release template, add a task of type AWS > Delete Function (Container).
2. Click the added task to open it.
3. In the Capabilities field, enter a value that matches the capability set for your remote runner. This will help you to route jobs to that particular remote runner.
4. In the AWS Server field, select the configured AWS server.
5. In the Region field, enter the AWS region to be used.
6. In the Function Name field, enter the AWS Lambda function name that you want to delete.
7. In the Qualifier field, specify a version of the function that you want to delete.