Google Cloud


We utilize multiple Google Cloud projects and folders to organize our workloads and manage access control for our engineers, as well as limit the scope of roles and service accounts across projects.

All Permanent Projects and permissions are defined in infrastructure/gcp. Temporary projects should be created as needed in Engineering Projects

Root Projects

These projects contain per-project permissions.

  • TelligentSourcegraph: Data pipeline and storage for pings and Cloud event logging.
  • Universities: Sourcegraph instances for universities.
  • sourcegraph-interviews: Shared project for interviews.


Engineering Projects

Contains projects used by individual engineers. Engineers are expected to remove all their resources once they are done testing. All projects must be prefixed with $name- (the name of the owner).

Generally, these projects should be short-lived and shutdown by the engineer when it is no longer needed (this will delete all resources in the project). Longer lived projects should be put in another folder and cloud-devops should be contacted for review. Short term projects do not need to be added via Terraform but longer term projects should be stood up via Terraform in the infrastructure repo.

Note: Customer Support team members should provision clusters within the cse-k8s project.

Sourcegraph Cloud

Sourcegraph Cloud projects.

  • Sourcegraph: Services for
  • Sourcegraph Auxiliary: Testing clusters, deployments and VMs.
  • sourcegraph-code-intel: Services for Code Intel code execution that are separated from our production project for extra isolation.
  • Sourcegraph CI: Services for our CI cluster and temporary CI resources.

Sourcegraph Security

Sourcegraph Security projects.

Other Projects

Misc Projects with permissions set at the project level.

  • sourcegraph-calend: Owned by @sqs.
  • sourcegraph-orgtool: Owned by @sqs.

Managed Instances

Multiple sourcegraph-managed-$name projects, one for each our managed deployments to guarantee separation of privileges and access control.

Committed use discounts

Compute Engine lets you purchase committed use contracts in return for deeply discounted prices for VM usage. These discounts are referred to as committed use discounts.

Current commitments

We do not have any ongoing commitments as of right now since the most recent commitment expired. The DevExp team is currently investigating resource usage as part of an effort to rightsize GCP consumption.

Assessing commitments

We will review the previous commitments and our billing reports to identify new commitment opportunities. Unless there are interesting cost-saving opportunities, we will keep a single active commitment to simplify its calculation and review.

Previous commitment and utilization

Review previous commitments and utilization reports to asses if we can increase or supplement our commitments.

  • Sign in to Billing in the Google Cloud Console
  • From the Billing navigation menu, select Commitments
  • To the predefined filters State: Active OR State: Inactive, add OR State: Expired
  • Review VCPU, RAM and other commitments over the last year

Billing reports

Review the billing reports and look for cost-saving opportunities by understanding which are the most expensive resources.

  • Sign in to Cloud Billing in the Google Cloud Console
  • From the Billing navigation menu, select Reports
  • Change the Filters -> Time range to “Year to date”
  • Change the Filters -> Group by to SKU
  • Review Predefined Instance Ram
  • Review Predefined Instance Core

Creating a commitment

Once we have reviewed the current utilization and commitments, we will create a new commitment as required.

  • Sign in to Commitment List
  • Check for any active commitment
  • If there is not active commitment, or the current commitment is about to expire select Purchase commitment
  • Fill in the commitment information, modify the example below as required from your assessment
    • Name: ${month}${year} (july2020)
    • Region: us-central1
    • Commitment type: General-purpose N1
    • Period: 1 year
  • Select Purchase -> Purchase