AWS Serverless Application Repository
Developer Guide

Consuming Applications

Following, you can learn how to find and deploy serverless applications that have been published to the AWS Serverless Application Repository. You can browse for applications that are publicly available without having an AWS account by visiting the public site. Alternatively, you can browse for applications from within the AWS Lambda console.

Browsing, Searching, and Deploying Applications

Find, configure, and deploy an application in the AWS Serverless Application Repository by using the following procedure.

To find and configure an application in the AWS Serverless Application Repository

  1. Open the AWS Serverless Application Repository public home page, or open the AWS Lambda console and choose Serverless Application Repository.

  2. Browse or search for an application.

    Note

    To show applications that contain custom IAM roles or resource policies, select the Show apps that create custom IAM roles or resource policies check box. For more information about custom IAM roles and resource policies, see Acknowledging Application Capabilities.

  3. Choose an application to view details such as its permissions, capabilities, and the number of times it has been deployed by AWS customers.

    The deployment counts are shown for the AWS Region in which you are trying to deploy the application.

  4. On the application detail page, view the application's permissions and application resources by viewing the AWS SAM template, license, and readme file. On this page, you can also find the Source code URL link for applications that are publicly shared. If the application includes any nested applications, you can also view details of the nested applications on this page.

  5. Configure the application in the Application settings section. For guidance on configuring a particular application, see that application’s readme file.

    For example, configuration requirements might include specifying the name of a resource that you want the application to have access to. Such a resource might be an Amazon DynamoDB table, an Amazon S3 bucket, or an Amazon API Gateway API.

  6. Choose Deploy. Doing this takes you to the Deployment status page.

    Note

    If necessary, you must select the I acknowledge this application creates custom IAM roles or resource polices check box before deploying the application. Otherwise an error will result. For more information about custom IAM roles and resource policies, see Acknowledging Application Capabilities.

  7. On the Deployment status page, you can view the progress of your deployment. While waiting for your deployment to complete, you can search and browse for other applications, and return to this page through the Lambda console.

After your application has been successfully deployed, you can review and manage the resources that have been created using existing AWS tools.

Deleting Application Stacks

To delete an application that you previously deployed using the AWS Serverless Application Repository, follow the same procedure as for deleting an AWS CloudFormation stack: