Tutorials

Creating an app on GCP

What you will learn

This tutorial will teach you how to create an application on Google Cloud Platform (GCP).

GCP Account

This tutorial assumes you already have a GCP account. If you do not have one, create one at https://cloud.google.com/ .

GCP Free tier

Google Cloud Platform (GCP) provides a generous free tier for new accounts. Read How much will it cost? to learn more.

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 GCP Project ID. Click the copy to clipboard button next to your Project ID in the GCP dashboard.

GCP project ID

Now paste your GCP Project 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

Click on the copy to clipboard button next to the service account.

connect your cloud

Then go to your GCP dashboard, open up the navigation menu, and click on IAM & Admin.

connect your cloud

You can also search for "iam" in the search bar at the top and then click on IAM & Admin.

connect your cloud

Then click on the "Grant access" button at the top.

grant access

Paste the service name you copied from Coherence into the "New principals" field.

new principals

Next, click on the "Select a role" dropdown and hover your mouse over "Basic" and select "Owner."

owner role

Click on the save button to save the role.

Finally, click the continue button in Coherence.

connect cloud continue button

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
Creating an app on AWS