Skip to content

Latest commit

 

History

History
146 lines (91 loc) · 3.36 KB

README.md

File metadata and controls

146 lines (91 loc) · 3.36 KB

Run GCP Project Controls

Retrieves all GCP projects and runs a subquery on each to get control counts and other details.

For further reference, see Turbot's GraphQL API documentation.

Prerequisites

To run the script, you must have:

Setup

This section details how to set up an environment in order to run the script.

Virtual Environment Activation

We recommend the use of a virtual environment.

To set up a virtual environment:

python3 -m venv .venv

Once created, to activate the environment:

source .venv/bin/activate

Dependencies

Then install Python library dependencies:

pip3 install -r requirements.txt

Turbot configuration

Credentials and end point details need to be configure before being able to connect to a Turbot installation. This configuration can be entered either using environment variables or a configuration file.

Environment variables

Use either configuration for your Turbot installation:

export TURBOT_WORKSPACE="https://<environment-name>.cloud.turbot.com/"
export TURBOT_ACCESS_KEY_ID=ac61d2e4-730c-4b54-8c3c-6ef172390814
export TURBOT_SECRET_ACCESS_KEY=151b296b-0694-4a28-94c4-4b67fa82ab2c

or

export TURBOT_GRAPHQL_ENDPOINT="https://<environment-name>.cloud.turbot.com/api/latest/graphql"
export TURBOT_ACCESS_KEY_ID=ac61d2e4-730c-4b54-8c3c-6ef180150814
export TURBOT_SECRET_ACCESS_KEY=151b296b-0694-4a28-94c4-4767fa82bb2c

Configuration file

Example configuration file:

default:
  accessKey: dc61d2e4-730c-4b54-8c3c-6ef180150814
  secretKey: 6ef18015-7d0c-2b51-4d2c-dc61d2e63a22
  workspace: "https://demo-acme.cloud.turbot.com/"

This script will automatically search for a credentials.yml file in ~/.config/turbot/ or you can save the yaml configuration file anywhere and provide the --config /path/to/config.yml --profile default as a command line option.

Executing the script

To run a the Python script:

  1. Install and configure the pre-requisites
  2. Using the command line, navigate to the directory for the Python script
  3. Create and activate the Python virtual environment
  4. Install dependencies
  5. Run the Python script using the command line
  6. Deactivate the Python virtual environment

Synopsis

python3 list_control_totals.py [options]

Options

Details

-c, --config-file

[String] Pass an optional yaml config file.

-p, --profile

[String] Profile to be used from config file.

--help

Lists all the options and their usages.

Example usage

Example 1

Run the script using default credentials.

python3 list_control_totals.py
Example 2

Run the script using a specific credentials file credentials.yml.

python3 list_control_totals.py -c /path/to/credentials.yml
Example 3

Run the script using a specific Turbot CLI profile:

python3 list_control_totals.py -p demo-dev

Virtual environments deactivation

Once the script has been run, it is advised to deactivate the virtual environment if a virtual environment was used to install the script dependencies.

This is accomplished by running the command:

deactivate