Seed is a fully-configured code pipeline for building and deploying Serverless apps on AWS. Simply add your Git repository and IAM credentials and your entire team can git push to deploy updates to your Serverless app.

Seed currently supports the following:

Support for other platforms and repositories are coming soon. Send us an email to let us know what you would like us to support next.

Prerequisites

Seed needs very little configuration on your part and there is no CLI to install. But to add your project you need to:

  1. Add your project repository with your Git provider
  2. Create an IAM Role for your AWS account

To start with, Seed will ask you to create a new app by adding your project from your repository.

Create a new app

Once you select your Git provider (GitHub for example), you’ll be asked to login to your Github.

Login to GitHub

Here you’ll be asked to authorize Seed. Make sure to select the Repositories and Organization access you need.

Authorize Seed on GitHub

Once authorized, you can select your repo. Seed will look for the serverless.yml file in your project root.

If you are unable to find your repo, it might be because Seed doesn’t have the permissions to access your repo. You can read about how to fix this here.

Auto-detect serverless.yml for new app

If detected, you can select to add this service. And Seed will create your app with it.

Confirm default service for new app

Alternatively, you can add a different service by picking a different path.

Pick different default service for new app

You can always add additional services later. Or continue (even if Seed is unable to detect a serverless.yml), by hitting Do this later.

Continue without detecting service for new app

Next, you’ll be asked to configure the IAM user for your app.

Configure IAM user for a new app

If you’ve added an app before, you have the option of configuring your new app with the settings of an existing app. Hit the Inherit Settings tab.

Here you can select one of your existing apps.

Select existing app settings for new app

Seed will create your new app using the following from the selected app:

  • Stages
  • CI settings
  • IAM settings
  • Stage IAM settings
  • Stage notification settings
  • Stage environment variables

A personal app can only inherit the settings from another personal app. And the same applies to organization apps.

This is useful when you are adding multiple apps and they all share similar settings. This way you won’t have to configure all the settings for a new app by hand. Note that, you can still tweak the settings manually even if they have been inherited.

Next, let’s look at how to create an AWS IAM User.