getting-started.md

Install

You can install mup and @sny7/mup-aws-beanstalk by running

npm i -g mup @sny7/mup-aws-beanstalk
OR
yarn global add mup @sny7/mup-aws-beanstalk

The AWS Beanstalk plugin requires Node 4 or newer and Meteor Up 1.3.5 or newer.

Step 1: Initialize your project

In the terminal, run

cd path/to/app
mkdir .deploy && cd .deploy
mup init

This will create a .deploy folder in your app, and mup init will add a Meteor settings file and mup config in it.

Step 2: Customize your Mup Config

You can replace the mup config in .deploy/mup.js with this:

module.exports = {
    app: {
        // Tells mup that the AWS Beanstalk plugin will manage the app
        type: 'aws-beanstalk',
        name: 'myApp',
        path: '../',
        env: {
            ROOT_URL: 'http://app.com',
            MONGO_URL: 'mongodb://user:pass@domain.com'
        },
        auth: {
            id: '12345',
            secret: '6789'
        },
        minInstances: 1
    },
    plugins: ['@sny7/mup-aws-beanstalk']
};

You will want to modify:

1. The app name. It must be at least 4 characters
2. app.env.ROOT_URL
3. app.env.MONGO_URL You will need to get a database from mLab, Compose, or another DBaaS provider

The next step will provide the values for the app.auth object.

Step 3: Create AWS user

You will need to create an Amazon account if you do not have one.

Next, create an IAM user at https://console.aws.amazon.com/iam/home?region=us-east-1#/users

The access type should be Programmatic access. You can select Add user to group and create a new group. The group should have the following permissions:

• AWSElasticBeanstalkFullAccess
• IAMFullAccess This is used to create the roles and Instance Profiles needed by Elastic Beanstalk. After the first deploy, you can replace it with IAMReadOnlyAccess
• AWSCertificateManagerFullAccess Used to create and manage SSL certificates for the app
• S3 // TBC

In your mup config, set app.auth.id to the Access Key ID, and app.auth.secret to the Secret access key AWS gives you after creating the user.

Step 4: Deploy

Simply run:

mup deploy

It will setup and deploy your app.