Setting up your environment

This page shows you how to set up your network environment before you can create and use private pools. If you're not familiar with private pools, read Private pools overview.

Understanding the network configuration options

Private pools are hosted in a Google-owned Virtual Private Cloud network called the service producer network. When setting up a private pool, you can either choose to use the service producer network or set up a private connection between the service producer network and the VPC network that contains your resources.

Choose one of the following network configuration schemes depending on the needs of your organization:

  • Use the service producer network by itself: Use this option if:

    This is the default network option for creating the private pool and does not require any network set up. If you're interested in this option, proceed to creating the private pool.

  • Set up a private connection between the service producer network and your VPC network: The private connection enables VM instances in your VPC network and private pools to communicate exclusively using internal IP addresses. Use this option if:

    • you want builds to access resources in your VPC network
    • you want configurable machine types and sizes

Setting up a private connection between your VPC network and the service producer network

  1. You must have an existing VPC network that you will use to connect to the service producer network.

  2. To use the command-line examples in this guide, install and configure the Cloud SDK.

  3. Enable API:

    Console


    Enable the Cloud Build and the Service Networking APIs.

    Enable the APIs

    gcloud

    Enable the Cloud Build and the Service Networking APIs:

    gcloud services enable cloudbuild.googleapis.com servicenetworking.googleapis.com
    
  4. Make sure you have the Compute Engine Network Admin IAM role for the project in which your VPC network resides; this role is required to set up the private connection.

  5. In the VPC network, allocate a named IP range:

    The IP range you specify here will be subject to firewall rules that are defined in the VPC network.

    Cloud Build reserves the IP range 192.168.10.0/24 for the Docker bridge network. When allocating the IP ranges for resources in your project(s), we recommend selecting a range outside of 192.168.10.0/24 in cases when Cloud Build builders are to access these resources.

    For example, Google Kubernetes Engine Control plane address range 192.168.10.96/28 wouldn't be accessible from Cloud Build gke_deploy builder due to the overlap.

    Console

    1. Go to the VPC networks page in the Google Cloud Console.

      Go to the VPC networks page

    2. Select the VPC network that will connect to the private pool's VPC network.

    3. Select the Private service connection tab.

    4. In the Private service connection tab, select the Allocated IP ranges for services tab.

    5. Click Allocate IP range.

    6. Enter a Name and Description for the allocated range.

    7. Specify an IP range for the allocation:

      • To specify an IP address range, select Custom and then enter a CIDR block.
      • To specify a prefix length and let Google select an available range, select Automatic and then enter a prefix length. The prefix length must be /23 or lower, such as /22, /21, etc.
    8. Click Allocate to create the allocated range.

    gcloud

    To specify an address range and a prefix length (subnet mask), use the addresses and prefix-length flags. The prefix length must be /23 or lower, such as /22, /21, etc. For example, to allocate the CIDR block 192.168.0.0/16, specify 192.168.0.0 for the address and 16 for the prefix length.

      gcloud compute addresses create RESERVED_RANGE_NAME \
          --global \
          --purpose=VPC_PEERING \
          --addresses=192.168.0.0 \
          --prefix-length=16 \
          --description=DESCRIPTION \
          --network=VPC_NETWORK
    

    To specify just a prefix length (subnet mask), just use the prefix-length flag. When you omit the address range, Google Cloud automatically selects an unused address range in your VPC network. The following example selects an unused IP address range with a 16 bit prefix length.

      gcloud compute addresses create RESERVED_RANGE_NAME \
          --global \
          --purpose=VPC_PEERING \
          --prefix-length=16 \
          --description=DESCRIPTION \
          --network=VPC_NETWORK
    

    Replace the placeholder values in the command with the following:

    • RESERVED_RANGE_NAME: a name for the allocated range, such as my-allocated-range.
    • DESCRIPTION: a description for the range, such as allocated for my-service.
    • VPC_NETWORK: the name of your VPC network, such as my-vpc-network.
  6. Create a private connection between the service producer network and your VPC network:

    Console

    1. Go to the VPC networks page in the Cloud Console.

      Go to the VPC networks page

    2. Select the VPC network that will connect to the private pool's VPC network.

    3. Select the Private service connection tab.

    4. In the Private service connection tab, select the Private connections to services tab.

    5. Click Create connection to create a private connection between your network and the service producer network.

    6. For the Assigned allocation, select the allocated range that you created in the previous step.

    7. Click Connect to create the connection.

    gcloud

    1. Create a private connection:

      gcloud services vpc-peerings connect \
          --service=servicenetworking.googleapis.com \
          --ranges=ALLOCATED_RANGE_NAME \
          --network=VPC_NETWORK \
          --project=PROJECT_ID
      

      Replace the placeholder values in the command with the following:

      • ALLOCATED_RANGE_NAME: the name allocated range you created in the previous step.
      • VPC_NETWORK: the name of your VPC network.
      • PROJECT_ID: the ID of the project that contains your VPC network.

      The command initiates a long-running operation, returning an operation name.

    2. Check whether the operation was successful, replacing OPERATION_NAME with the operation name that was returned from the previous step.

      gcloud services vpc-peerings operations describe \
          --name=OPERATION_NAME
      
  7. [OPTIONAL: Shared VPC scenario]. If you are using Shared VPC, create the allocated IP range and private connection in the host project. Typically, a network administrator in the host project must do these tasks. After the host project is set up with the private connection, VM instances in service projects can use the private connection with the service producer network. The project that hosts the VPC connection and the project that contains the private pool must be part of the same organization.

  8. [OPTIONAL: Using firewall rules]. If you're creating an ingress firewall rule in the VPC network, specify the same IP range that you allocate here in the source filter for the ingress rule.

What's next