Google Cloud project setup
This page outlines the steps that the Cloud Deployment Team took when setting up a Google Cloud project before deploying the CDM.
Perform these steps before you deploy the CDM:
-
Log in to the Google Cloud Console and create a new project.
-
Authenticate to the Google Cloud SDK to obtain the permissions you’ll need to create a cluster:
-
Configure the Google Cloud SDK standard component to use your Google account. Run the following command:
$ gcloud auth login
-
A browser window appears, prompting you to select a Google account. Select the account you want to use for cluster creation.
A second screen requests several permissions. Select Allow.
A third screen should appear with the heading, You are now authenticated with the Google Cloud SDK!
-
Set the Google Cloud SDK configuration to reference your new project. Specify the project ID, not the project name, in the gcloud config set project command:
$ gcloud config set project my-project-id
-
-
Assign the following roles to users who will be creating Kubernetes clusters and deploying the CDM:
-
Editor
-
Kubernetes Engine Admin
-
Kubernetes Engine Cluster Admin
Remember, the CDM is a reference implementation, and is not for production use. The roles you assign in this step are suitable for the CDM. When you create a project plan, you’ll need to determine which Google Cloud roles are required.
-
-
Determine the region where you’ll deploy the CDM. Then, set that region as the default region in your Google Cloud SDK configuration. For example:
$ gcloud config set compute/region us-west1
-
Determine the cluster size: small, medium, or large.
-
Ensure that the cluster creation script will support your region:
-
Go to Google’s Regions and Zones page.
-
Determine if the
a
,b
, andc
zones are available in your region.If these zones are available, no additional action needs to be taken.
If they’re not available:
-
Change to the /path/to/forgeops/cluster/gke directory.
-
Open the script that sets environment variables for your selected cluster size. For example, open the small.sh script if you’re going to deploy a small-sized cluster.
-
Locate the statement that sets the
NODE_LOCATIONS
environment variable. -
Uncomment this statement.
-
Change the statement to configure CDM to use three zones available in your region.
-
Save your changes to the script.
-
-
-
Ensure that your region has an adequate CPU quota for the CDM:
-
Change to the /path/to/forgeops/cluster/gke directory.
-
Open the script that sets environment variables for your selected cluster size. For example, open the small.sh script if you’re going to deploy a small-sized cluster.
-
Locate the statements that set the
MACHINE
andDS_MACHINE
environment variables. -
Your quotas need to let you allocate six machines each of
MACHINE
andDS_MACHINE
types in your region. If your quotas are too low, request and wait for a quota increase from Google Cloud before attempting to create your CDM cluster.
-