Add GCE hostprovider

Daria Barysheva

This topic shows how to add the Google Compute Engine (GCE) hostprovider, which allows to create virtual machines in the Google Cloud.

IMPORTANT

Before adding the GCE hostprovider, make sure that:

  • The Project exists in the Google Cloud.

  • The subnet is created in the Google Cloud.

  • ADCM can establish the connection to the specified subnet in the Google Cloud.

  • The user that creates the virtual machine has all necessary rights.

A typical installation sequence for the GCE hostprovider includes the following steps.

Step 1. Download a hostprovider bundle

Hostprovider distributions for ADCM come in bundles. Regarding the GCE hostprovider, a bundle is a regular archive that includes a description and logic to interact with the Google Cloud.

The steps for downloading a bundle are given below:

  1. Go to the Arenadata Cluster Manager product website and click Download.

    adcm hostprovider add 01
    Switching to the Arenadata Cluster Manager downloading page

    Another way — go to https://network.arenadata.io/ and choose Arenadata Cluster Manager.

  2. On the next page, download a required bundle. GCE hostprovider bundles are called Google Compute Engine Bundle.

Step 2. Upload a hostprovider bundle to ADCM

To upload a bundle to ADCM, follow these steps in the ADCM web interface:

  1. Open the BUNDLES tab and click Upload bundle.

  2. Select the downloaded bundle in the Open File Dialog.

    google bundle upload dark
    Switching to uploading a bundle
    google bundle upload light
    Switching to uploading a bundle

  3. As a result of the performed actions, the uploaded bundle is displayed at the BUNDLES tab.

    google bundle success
    The result of successful uploading a bundle

Step 3. Create a hostprovider based on the uploaded bundle

To add a new hostprovider to ADCM on the base of the uploaded bundle, follow these steps in the ADCM web interface:

  1. Open the HOSTPROVIDERS tab and click Create provider.

    google hostprovider add
    Creating a new hostprovider

  2. In the opened window:

    • Select the uploaded bundle in the Bundle field.

    • Select the desired version of the bundle in the Version field. Several versions become available in the case of different versions of the same bundle being uploaded. By default, the latest version is displayed.

    • Enter the hostprovider name in the Hostprovider name field.

    • Enter the hostprovider description in the Description field, if necessary.

    • Click Create.

    google hostprovider card
    Filling in the new hostprovider parameters

  3. As a result of the performed actions, the created hostprovider is displayed at the HOSTPROVIDERS tab.

    google hostprovider success
    The result of successful adding a hostprovider

Step 4. Configure a hostprovider

In order to configure the access to the cloud, perform the following actions:

  1. Open the HOSTPROVIDERS tab, find the row with a desired hostprovider, and click the gear icon in the Config column.

    google hostprovider config
    Switching to configuring the hostprovider

  2. In the next window set the Advanced flag, fill in the necessary parameters, and click Save.

    google hostprovider config card
    Configuring the hostprovider

    The assignment of parameters is listed below.

    Configuration parameters
    Parameter Mandatory Description

    Project ID

    Yes

    A unique project identifier in the Google Cloud. Can be copied from the Id column in the Manage resources section of the Google Cloud platform

    Service Account email

    Yes

    A service account email. You can create and view service accounts of the project in the Service accounts section of the Google Cloud platform

    Credentials JSON

    Yes

    Credentials of the service account in the JSON format. To upload credentials in the JSON format, navigate to the Service accounts section of the Google Cloud platform, select Create key in the Actions context menu, and get the credentials

    Ssh keys

    No

    A list of OpenSSH keys with the user@hostname data in the end. When adding virtual machines, the users list is parsed from this field. Every user is created with the corresponding key

  3. Return to the HOSTPROVIDERS tab. As a result, the orange exclamation mark stops being displayed in the Actions column. The actions available for the configured hostprovider can be opened by clicking the icon in the Actions column.

    google hostprovider result
    The result of successful hostprovider configuring

Step 5. Configure ADCM

  1. Open the ADCM home page and select the Settings item in the left navigation menu.

  2. Fill in the credentials for Google Cloud authorization in the Google Auth pane. The parameters purpose is described in the table below.

    Google authorization parameters
    Parameter Description

    client_id

    A Сlient ID. See more details in the Google Cloud documentation

    secret

    A secret key. See more details in the Google Cloud documentation

    whitelisted_domains

    Domains from which the ADCM authorization is possible. For example, arenadata.io

  3. Click Save.

    google adcm configure
    Configuring Google authorization in ADCM
Found a mistake? Seleсt text and press Ctrl+Enter to report it