Adding GCP Cloud Accounts

To manage your Google Cloud Platform (GCP) service account's resources in Commander, add the service account as a cloud account. To do so, provide the private key for the service account.

Important: See Getting started with GCP for a list of tasks to complete before adding a GCP cloud account.

Access through:

Views > Inventory

Available to:

Commander Roles of Superuser and Enterprise Admin

To add a GCP cloud account to Commander:

  1. Click the Infrastructure, Applications, or Storage tab.
  2. Select the root node of the Infrastructure, Applications, or Storage tree.
  3. At the top of the Summary page, click Add Cloud Account.
  4. In the Add Cloud Account dialog, from Cloud Account Type, select Google Cloud Platform.
  5. For Name, enter a name that will help identify this cloud account. Note that Service Portal users may see this name if they have permission.
  6. For Private Key (JSON) File, browse to the location of the private key for the Commander service account.

    Note: If you haven't already created a service account and downloaded its private key, see Create a service account for Commander to access GCP.

    Commander validates the file to ensure that it's a private key file in JSON format. If the file is valid, Commander displays the Client ID and the Client Email for this service account.

  7. For Update Frequency, enter a value from 10 to 180, in minutes. Commander retrieves changes from GCP and generates events based on these changes. By default, Commander waits 60 minutes between updates.

    This setting affects only how often configuration changes made in GCP are retrieved; changes made within Commander are displayed as soon as the task has finished.

    Note: More frequent updates (meaning lower values for this setting) may impact performance, especially in large installations.

  8. If Internet access is established through a web proxy server, enable Use Public Cloud Proxy.
  9. Note: If you haven't already integrated your web proxy server with Commander, click Add Public Cloud Proxy Server and configure the proxy. This task requires the Superuser role. See Connecting Public Clouds through Web Proxy Servers for instructions.

  10. If you want to synchronize GCP labels and Commander custom attributes, for Sync Labels and Custom Attributes, click Configure.
    1. In the Synchronize GCP Labels and Commander Custom Attributes dialog, enable Import GCP Labels as Commander Custom Attribute as required.
    2. To exclude certain GCP labels from synchronization, enter them as a comma-separated list in the Excluded Labels text field.
    3. Click OK.

    To learn more, see Synchronizing GCP Labels and Commander Custom Attributes.

  11. Click OK to add the cloud account.
  12. Once the cloud account is added to Commander, details are displayed in its Summary tab. You can change what's displayed in the Details section (see Customizing the Commander Display).

Updating permissions for GCP cloud accounts

If you need to change the permissions granted to a GCP cloud account — for example, to change the visibility of resources — you can create a new service account and upload a new private key file.

Access through:

Views > Inventory

Available to:

Commander Roles of Superuser and Enterprise Admin

To update the permissions granted to a GCP cloud account:

  1. In the GCP console, create a new service account and grant it permissions. Follow the steps in Create a service account for Commander to access GCP, Enable the required APIs, and Grant permissions to the Commander service account
  2. In Commander, click the Infrastructure, Applications, or Storage tab.
  3. From the Inventory tree, select a cloud account.

    Select Actions > Edit Cloud Account.

  4. In the Edit Cloud Account dialog, for Private Key (JSON) File, browse to the location of the new private key for the Commander service account.

    Commander validates the file to ensure that it's a private key file in JSON format. If the file is valid, Commander displays the Client ID and the Client Email for this service account.

  5. Click OK.