Getting Started with Spring Boot, Cloud and AWS - online Live Training at https://safaribooksonline.com
- This project is based on Spring Cloud AWS 2.3.1, Spring Boot 2.4.5 and AWS SDK 1.X
- For AWS SDK 2.x (no Spring Cloud AWS support yet), visit my [second repository] (https://github.com/madhusudhankonda/olt-boot-cloud-aws-v2)
The following tools/frameworks are expected to be setup as part of this course.
- AWS Account: We need to create an AWS account for consuming the services. We can surely use Free Tier for our training
- AWS CLI: We need to use the Command Line Interface to configure our AWS access
- IDE for development: I work on IntelliJ IDEA but any Java IDE should be okay)
Let's look at these steps in the next few sections.
Visit Amazon's AWS and register. You can use Free Tier for most/all of the training sessions. Once you;ve completed the registration, visit [AWS Console Home] (https://console.aws.amazon.com) to log in. Once you are logged in, next step is to create keys for programmatic access using AWS's Identity and Access Management(IAM) service, described in the next section.
Our programs interact with the AWS services programmatically. We need to create a user/group with appropriate access controls. Head over to IAM service and follow the instructions to create a user, group and permissions.
-
Click on Users -> Add User (see Image below)
-
Select Prgorammatic Acess and navigate to next page to create a group.
-
Click on the Create Group
-
Provide the group name and add as Administrator (be aware - this will grant the full access to all of the services - make sure you make granular level access instead). Navigate to next page, which enables the Tags. We can ignore tags for these exercises.
-
Ignore Tags and go to Review page. Once satisfied, click on the Create User button, which will create the user and outputs the keys to the console as shown below:
-
As you can see this page outputs the access and secret keys. Copy them to your running notes. These key are only shown once - you cannot retive them once you navigate away from this page. Of coruse, you can re-create them which will generate a brand new set of keys anyway. It is a good idea to save, download or email them to yourself. Click on the Download as CSV button to download or follow instructions to receive them by email.
Now that we have our AWS Account created and keys generated, it's time to configure them on my machine for development.
The AWS SDK for Java expects us to provide few properties - access key, secret key and region. There are multitude ways of configuring our SDK to pick up these keys, one way being asking AWS CLI to configure us with credentials file as pofiles in our local home directory. Let's follow the steps to get the AWS CLI downloaded and installed. Once it's ready, we use it to configure our environment.
Depending OS, download your CLI binary from here AWS CLI.
Once downloaded, follow the instructions to get it installed. Issue aws s3 ls command - you may see a list (or none) of S3 buckets as shown here in the image:
It's time to configure our environment to start developing projects to consume AWS.
At your command prompt/terminal, issue the aws configure command and follow the instructions.
It asks for your access key and secret key - enter them at the command prompt.
It will also ask for Region - input yoru appropriate region. The regions are provided in the form of EU-WEST-2, US-EAST-1, etc., as shown in the image here:
.
CLI will create a .aws folder in your home directory.
Once the configuration is done, you should see two files in the user's home directory ~/.aws created by CLI - the credentials and config file - keys and region documented in those files respectively. If you are not sure where these are, you can visit <your_home_directory>/.aws folder:
$>aws configure
AWS Access Key ID [None]: ****************. <<provide your access key here>>
AWS Secret Access Key [****************/djt]: <<provide your secret access key here>>
Default region name [eu-west-2]: <<provide your region here>>
Default output format [None]:
All the source code is available on GitHub, so using your favourite IDE, you can clone the repository. I've used IntelliJ IDE for the development purposes but there's no reason why you can't use any other IDE. The projects are maven based.
There are two variants of the projects that I had developed olt-boot-cloud-aws and olt-boot-cloud-aws-v2. The fundamental difference is the AWS SDK's version.
The olt-boot-cloud-aws project uses AWS SDK 1.x version with Spring Cloud AWS 2.3.1 and Spring Boot 2.4.5 (there's a new variat of Spring cloud - awspring - see details below)
On the other hand olt-boot-cloud-aws-v2 uses AWS SDK 2.x version with Spring Boot 2.4.5 (no Cloud AWS support yet for AWS SDK 2.x). My intention is to provide a mechanism to work with AWS SDK 2.x version within Spring Applications untill the Spring Cloud AWS new release comes along.
| AWS Service | GitHub Code |
|---|---|
| Simple Queue Service | SQS Code |
| Simple Notification Service | SNS Code |
| Relational Databse Service | RDS Code |
| Simple Storage Service | S3 Code |
| AWS Service | GitHub Code |
|---|---|
| Simple Queue Service | SQS Code |