Configuring GCP

Use this guide to configure the assets you'll need to use GCP as a provider on Cycle.

GCP Account Status

This guide assumes the user has already signed up for a GCP account.

Initial Project Setup & Compute Engine Activization

Connecting GCP to Cycle is done through a configuration file which can be downloaded after creating the appropriate project and user.

  1. Log into the GCP account and either select and existing project to be used or create a new project by clicking on the projects dropdown at the top of the page and selecting the "New Project" button in the modal.
  2. After the project is created enter Compute Engine API into the search bar and navigate to the compute engine API page. On this page, enable this service.

Billing Enabled

There may be a prompt here to add billing if the billing for the project has not been set up.

Create Credentials

When compute engine API is enabled, the screen will move to the Enabled API's and Services page with the compute engine API selected.

Next, click Create Credentials.

Other Services

If you're asked whether you'll be using any other services with this credential, select "No" unless you have a strict usecase you've talked with someone on the Cycle team about adding them.

On the first page, select Compute Engine API if its not already selected in the Select an API dropdown. For the data type, Application data best describes the type of data being accessed.

Clicking on Next reveals the Service Account Details form. Filling in the name automatically fills in the ID. If there is a need for a custom ID, please reference GCP's documentation on updating that value.

After progressing past Service Account details, use the optional service account access to add the Compute Admin role to the service account.

Generating the Config

After working through the create credentials wizard, the compute engine api is still selected. Using the search bar, select IAM & Admin.

Choose Service Accounts from the IAM & Admin maing navigation. Then select the service account that was just created.

Click Keys then Add Key followed by Create New Key with JSON type. The JSON file output is what will be used to configure the integration on the Cycle side.

Add Credentials To Cycle

Head back to your Cycle hub:

  1. Expand the Hub section in the main navigation.
  2. Select the Integrations tab.
  3. Expand the GCP section and click the Add Integration button in the upper right
  4. Complete the form with the credentials generated above, and then click Add

Info

All IPs attached to nodes on GCP are ephemeral and could change if the server is restarted. Cycle will handle the change in network automatically if this occurs.

Congratulations, you're now ready to use GCP as an infrastructure provider on Cycle!