Tutorials

Creating an app on AWS

What you will learn

This tutorial will teach you how to create an application on Amazon Web Services (AWS).

AWS Account

This tutorial assumes you already have an AWS account. If you do not have one, read our docs on how to create an AWS account .

AWS Free tier

Amazon Web Services (AWS) provides a generous free tier for new accounts. Read How much will it cost? to learn more.

Video

Creating an application with Coherence

Go to https://app.withcoherence.com/ to create a new account. Click on the “Sign up” link at the bottom of the login form.

coherence-signup.png

Enter your email address and a password then click the “Continue” button.

coherence-email-password.png

Complete your profile by filling out the necessary fields and click the continue button at the bottom.

App Details

First, you will need to provide a name for your application.

app-name.png

Cloud project ID

Next, you will need to add your AWS account ID. This can be found by clicking on your account name in the upper right of your AWS dashboard. There is a copy to clipboard button to the right of your account ID which makes it easy for you to simply paste the ID back into Coherence.

aws-account-ID.png

Now paste your AWS ID back into Coherence.

coherence-aws-id.png

Create a repo

Next, we will create a new repo using one of the starter templates provided by the Coherence team. You can, of course, deploy your own application, but using one of our starter templates is the easiest way to get started; allowing you to get a sense of all that the platform offers.

Starter Templates

We are updating these starter templates all of the time, so you may not see the same templates as listed in this tutorial. However, the steps are exactly the same regardless of the starter template you choose.

Click the create button next to the starter template you want to use.

Create a repo

Next, give your repository a name and then click the "Create respository from template" button.

It does not matter if the repo is public or private.

gh-repo-url.png

gh-repo-url.png

Once your repo is created, copy the URL at the top.

gh-repo-url.png

Paste your repo's URL back into Coherence.

gh-repo-url.png

Click the continue button

Authorize GitHub

Install the GitHub app

Next, we will need to install the Coherence GitHub app in the starter template repo we just imported. Click on the “Install the app” button.

install-the-app.png

This will launch a new window so you can configure the Coherence GitHub app. Click on your GitHub account.

install-gha.png

You then need to give the Coherence app access to your repository. It is best to give access only to the starter template repo we imported and not “All repositories.” Click the green “Save” button once you have added your repo.

repo-access.png

Authorize GitHub

Next, we will need to authorize GitHub so Coherence can push and pull code on our behalf.

install-the-app.png

Then click on the "Authorize Coherence Platform" button.

Authorize Coherence Platform

You should see a success message.

GitHub auth successful

Close the window and click the Continue button.

GitHub auth successful

Connect cloud

Create a new IAM role

Next, we need to connect AWS with Coherence and create a new IAM role. This will give Coherence the necessary access to create the infrastructure necessary for your app.

First, click on the copy to clipboard button next to the “Custom trust policy” JSON data.

connect-cloud.png

Then within your AWS console, search for “IAM” in the search bar at the top of the page. Then click on the “IAM” service in the search results.

IAM-services.png

Click on “Roles” in the left sidebar.

roles.png

Then click the “Create role” button.

create-role-button.png

Select the “Custom trust policy” tab.

custom-trust-policy.png

Then, delete the JSON data in the Custom trust policy and paste in the JSON you copied from Coherence.

custom-json.png

Click on the “Next” button at the bottom.

Add permissions

Back in Coherence click the copy to clipboard button next to the Permission Policy.

add-permissions.png

Back in AWS, paste this into the search bar and select “AdministratorAccess.”

admin-access.png

Click the “Next” button.

Role name

Finally, back in Coherence, copy the role name.

role-name-copy.png

Paste the role name into AWS.

paste-role-name.png

Click the “Create role” button at the bottom.

You should then see a message that says the role was created.

role-created.png

Now that our role is created, click the “Continue” button in Coherence.

continue-btn.png

Configure

Next, you will be taken to the “Configure Infrastructure” screen. Click the “Configure” button.

configure-infra-btn.png

Coherence is now creating all of the infrastructure necessary for your application. The process can take up to 20 mins.

almost-done.png

Once Coherence has finished setting everything up, you will then have access to the dashboard and can begin using the Coherence platform!

Previous
Coherence overview