Spring cloud aws sample

This is a sample application for demonstration purposes only. It is a very simple application devoted to managing advertisements (actually, it doesn't allow deletion and update of ads). The idea is demonstrate Spring Cloud AWS capabilities. In order to run it, you need a minimum AWS configuration (see below).

The application allows users to create ads with a picture. Ads are stored in a RDS database in AWS. The project is configured to use MySQL, but that can be changed to use a different database (for instance, PostgreSQL). Pictures within ads are stored in a bucket in S3.

Prerequisites

Some configurations are required in your AWS account for this sample to work. Basically, an S3 bucket (by default spring-cloud-aws-sample is used, but it can be changed using cloud.aws.s3.bucket property), and an RDS MySQL instance open to the world. Additionally, we need an IAM user with access key and programmatic access to AWS API so that we can access AWS resources from our development machine.

Create an IAM User

• Enable programmatic access
• Generate an access key for the user
• Give the user the following permissions: ** AmazonS3FullAccess ** AmazonRDSFullAccess

Create an RDS Instance

WARNING: These instructions allow you to run and test the application from within your development environment (i.e., without deploying it to AWS) using an RDS instance open to the world, which is something you should avoid in production.

First, create a security group that will be used to allow ingress connections from outside AWS. Whithin the security group just created, create a new access rule with the following configuration:

• Type: MySQL/Aurora
• Source: Anywhere
• CIDR: 0.0.0.0/0

Then, create an RDS instance, with these properties:

• Engine MySQL
• Type dev/test
• DB Instance Class: t2.micro
• Multizone AZ: no
• DB Instance identifier: springaws (we will provide this as app argument cloud.aws.rds.dbInstanceIdentifier)
• Master username: springaws (we will provide this as app argument cloud.aws.rds.springaws.username)
• Master password: (we will provide this as app argument cloud.aws.rds.springaws.password)
• Ensure Default VPC is enabled
• Ensure Publicly accessible is yes
• VPC security group: choose the security group previously created
• Database name: springaws
• Launch!!

Create an S3 bucket

Finally, create an S3 bucket, name it spring-cloud-aws-sample and give read permissions to anonymous users. Just copy and paste this aws policy to enable anonymous read access:

{
  "Version":"2012-10-17",
  "Statement":[
    {
      "Sid":"AddPerm",
      "Effect":"Allow",
      "Principal": "*",
      "Action":["s3:GetObject"],
      "Resource":["arn:aws:s3:::spring-cloud-aws-sample/*"]
    }
  ]
}

Run the application

For the impatient...

git clone https://github.com/codeurjc/spring-cloud-aws-sample
cd spring-cloud-aws-sample 
mvn package
cd target
java -jar spring-cloud-aws-sample-0.0.1-SNAPSHOT.jar  --cloud.aws.rds.dbInstanceIdentifier=springaws --cloud.aws.rds.springaws.password=<your pass> --cloud.aws.rds.springaws.username=springaws --cloud.aws.rds.springaws.databaseName=springaws --cloud.aws.credentials.accessKey="key" --cloud.aws.credentials.secretKey="secret"