Create a cluster

This page explains how to create a cluster in Google Kubernetes Engine (GKE) with Binary Authorization enabled. You perform this step at the command line using gcloud commands or in the Google Cloud console. This step is part of setting up Binary Authorization for GKE.

Before you begin

Create a cluster with Binary Authorization enabled (auditing-only)

Binary Authorization works with Autopilot or Standard clusters. To configure audit-only evaluation mode, you must specify at least one platform policy.

To create a cluster with Binary Authorization enabled with only auditing, do the following:

Console

The following steps configure a Standard cluster.

  1. In the Google Cloud console, go to the GKE page.

    Go to GKE

  2. Click Create Cluster. Enter values for the default fields as described in Creating a zonal cluster.

  3. In the navigation menu, click Security.

  4. Select Enable Binary Authorization.

  5. Select Audit-only and configure audit policies that you want Binary Authorization to evaluate your cluster's images against.

  6. Click Create.

gcloud

  1. Set your default Google Cloud project:

    gcloud config set project PROJECT_ID
    

    Replace PROJECT_ID with the ID of the project where you want to create the cluster.

  2. Create a cluster that uses only CV platform policy-based auditing:

    Before using any of the command data below, make the following replacements:

    • CLUSTER_NAME: a cluster name.
    • LOCATION: the location—for example, us-central1 or asia-south1.
    • POLICY_PROJECT_ID: the ID of the project where the policy is stored.
    • POLICY_ID: the policy ID.
    • CLUSTER_PROJECT_ID: the cluster project ID.

    Execute the following command:

    Linux, macOS, or Cloud Shell

    gcloud beta container clusters create CLUSTER_NAME \
        --location=LOCATION \
        --binauthz-evaluation-mode=POLICY_BINDINGS \
        --binauthz-policy-bindings=name=projects/POLICY_PROJECT_ID/platforms/gke/policies/POLICY_ID \
        --project=CLUSTER_PROJECT_ID
    

    Windows (PowerShell)

    gcloud beta container clusters create CLUSTER_NAME `
        --location=LOCATION `
        --binauthz-evaluation-mode=POLICY_BINDINGS `
        --binauthz-policy-bindings=name=projects/POLICY_PROJECT_ID/platforms/gke/policies/POLICY_ID `
        --project=CLUSTER_PROJECT_ID
    

    Windows (cmd.exe)

    gcloud beta container clusters create CLUSTER_NAME ^
        --location=LOCATION ^
        --binauthz-evaluation-mode=POLICY_BINDINGS ^
        --binauthz-policy-bindings=name=projects/POLICY_PROJECT_ID/platforms/gke/policies/POLICY_ID ^
        --project=CLUSTER_PROJECT_ID
    

It can take a few minutes for your cluster to be created.

Create a cluster with Binary Authorization enabled (enforce-only)

Binary Authorization works with Autopilot or Standard clusters. The enforcement policy is set to the project policy which by default allows all images. To change the project policy follow these instructions.

To create a cluster with Binary Authorization enabled with only enforcement enabled, do the following:

Console

The following steps configure a Standard cluster.

  1. In the Google Cloud console, go to the GKE page.

    Go to GKE

  2. Click Create Cluster. Enter values for the default fields as described in Creating a zonal cluster.

  3. In the navigation menu, click Security.

  4. Select Enable Binary Authorization.

  5. Select Enforce-only.

  6. Click Create.

gcloud

  1. Set your default Google Cloud project:

    gcloud config set project PROJECT_ID
    

    Replace PROJECT_ID with the ID of the project where you want to create the cluster.

  2. Create a cluster that uses policy enforcement only:

    Before using any of the command data below, make the following replacements:

    • CLUSTER_NAME: a cluster name.
    • LOCATION: the location—for example, us-central1 or asia-south1.
    • CLUSTER_PROJECT_ID: the cluster project ID.

    Execute the following command:

    Linux, macOS, or Cloud Shell

    gcloud beta container clusters create CLUSTER_NAME \
        --location=LOCATION \
        --binauthz-evaluation-mode=PROJECT_SINGLETON_POLICY_ENFORCE \
        --project=CLUSTER_PROJECT_ID
    

    Windows (PowerShell)

    gcloud beta container clusters create CLUSTER_NAME `
        --location=LOCATION `
        --binauthz-evaluation-mode=PROJECT_SINGLETON_POLICY_ENFORCE `
        --project=CLUSTER_PROJECT_ID
    

    Windows (cmd.exe)

    gcloud beta container clusters create CLUSTER_NAME ^
        --location=LOCATION ^
        --binauthz-evaluation-mode=PROJECT_SINGLETON_POLICY_ENFORCE ^
        --project=CLUSTER_PROJECT_ID
    

It can take a few minutes for your cluster to be created.

Create a cluster with Binary Authorization enabled (audit and enforce)

Binary Authorization works with Autopilot or Standard clusters.

The enforcement policy is set to the project policy which by default allows all images. To change the project policy follow these instructions.

You can configure your auditing platform policies. For auditing, you must specify at least one platform policy.

To create a cluster with Binary Authorization enabled with both auditing and enforcement, do the following:

Console

The following steps configure a Standard cluster.

  1. In the Google Cloud console, go to the GKE page.

    Go to GKE

  2. Click Create Cluster. Enter values for the default fields as described in Creating a zonal cluster.

  3. In the navigation menu, click Security.

  4. Select Enable Binary Authorization.

  5. Select Audit and Enforce and configure audit policies.

  6. Click Create.

gcloud

  1. Set your default Google Cloud project:

    gcloud config set project PROJECT_ID
    

    Replace PROJECT_ID with the ID of the project where you want to create the cluster.

  2. Create a cluster that uses both project-singleton policy enforcement and CV platform policy-based auditing:

    Before using any of the command data below, make the following replacements:

    • CLUSTER_NAME: a cluster name.
    • LOCATION: the location—for example, us-central1 or asia-south1.
    • POLICY_PROJECT_ID: the ID of the project where the policy is stored.
    • POLICY_ID: the policy ID.
    • CLUSTER_PROJECT_ID: the cluster project ID.

    Execute the following command:

    Linux, macOS, or Cloud Shell

    gcloud beta container clusters create CLUSTER_NAME \
        --location=LOCATION \
        --binauthz-evaluation-mode=POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE \
        --binauthz-policy-bindings=name=projects/POLICY_PROJECT_ID/platforms/gke/policies/POLICY_ID \
        --project=CLUSTER_PROJECT_ID
    

    Windows (PowerShell)

    gcloud beta container clusters create CLUSTER_NAME `
        --location=LOCATION `
        --binauthz-evaluation-mode=POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE `
        --binauthz-policy-bindings=name=projects/POLICY_PROJECT_ID/platforms/gke/policies/POLICY_ID `
        --project=CLUSTER_PROJECT_ID
    

    Windows (cmd.exe)

    gcloud beta container clusters create CLUSTER_NAME ^
        --location=LOCATION ^
        --binauthz-evaluation-mode=POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE ^
        --binauthz-policy-bindings=name=projects/POLICY_PROJECT_ID/platforms/gke/policies/POLICY_ID ^
        --project=CLUSTER_PROJECT_ID
    

It can take a few minutes for your cluster to be created.

Create a CV cluster that uses multiple platform policies (audit-only)

Binary Authorization works with Autopilot or Standard clusters.

You can create clusters with multiple platform policies bound to them (see GKE API Reference for more information).

Console

The following steps configure a Standard cluster.

  1. In the Google Cloud console, go to the GKE page.

    Go to GKE

  2. Click Create Cluster. Enter values for the default fields as described in Creating a zonal cluster.

  3. In the navigation menu, click Security.

  4. Select Enable Binary Authorization.

  5. Select Audit-only and configure one or more platform policies that you want Binary Authorization to evaluate your cluster against.

  6. Click Create.

gcloud

  1. Set your default Google Cloud project:

    gcloud config set project PROJECT_ID
    
  2. Create the cluster.

    Before using any of the command data below, make the following replacements:

    • CLUSTER_NAME: a cluster name.
    • LOCATION: the location — for example, us-central1 or asia-south1.
    • POLICY_PROJECT_ID_1: the ID of the project where the first platform policy is stored.
    • POLICY_ID_1: the policy ID of the first platform policy.
    • POLICY_PROJECT_ID_2: the ID of the project where the second platform policy is stored. Multiple policies can be stored in the same project or in different projects.
    • POLICY_ID_2: the policy ID of the second platform policy.
    • CLUSTER_PROJECT_ID: the cluster project ID.

    Execute the following command:

    Linux, macOS, or Cloud Shell

    gcloud beta container clusters create CLUSTER_NAME \
        --location=LOCATION \
        --binauthz-evaluation-mode=POLICY_BINDINGS \
        --binauthz-policy-bindings=name=projects/POLICY_PROJECT_ID_1/platforms/gke/policies/POLICY_ID_1 \
        --binauthz-policy-bindings=name=projects/POLICY_PROJECT_ID_2/platforms/gke/policies/POLICY_ID_2 \
        --project=CLUSTER_PROJECT_ID
    

    Windows (PowerShell)

    gcloud beta container clusters create CLUSTER_NAME `
        --location=LOCATION `
        --binauthz-evaluation-mode=POLICY_BINDINGS `
        --binauthz-policy-bindings=name=projects/POLICY_PROJECT_ID_1/platforms/gke/policies/POLICY_ID_1 `
        --binauthz-policy-bindings=name=projects/POLICY_PROJECT_ID_2/platforms/gke/policies/POLICY_ID_2 `
        --project=CLUSTER_PROJECT_ID
    

    Windows (cmd.exe)

    gcloud beta container clusters create CLUSTER_NAME ^
        --location=LOCATION ^
        --binauthz-evaluation-mode=POLICY_BINDINGS ^
        --binauthz-policy-bindings=name=projects/POLICY_PROJECT_ID_1/platforms/gke/policies/POLICY_ID_1 ^
        --binauthz-policy-bindings=name=projects/POLICY_PROJECT_ID_2/platforms/gke/policies/POLICY_ID_2 ^
        --project=CLUSTER_PROJECT_ID
    

It can take a few minutes for your cluster to be created.

Create a CV cluster that uses multiple platform policies (audit and enforce)

Binary Authorization works with Autopilot or Standard clusters.

You can create clusters with multiple platform policies bound to them (see GKE API Reference for more information).

Console

The following steps configure a Standard cluster.

  1. In the Google Cloud console, go to the GKE page.

    Go to GKE

  2. Click Create Cluster. Enter values for the default fields as described in Creating a zonal cluster.

  3. In the navigation menu, click Security.

  4. Select Enable Binary Authorization.

  5. Select Audit and Enforce and configure audit policies.

  6. Click Create.

gcloud

  1. Set your default Google Cloud project:

    gcloud config set project PROJECT_ID
    
  2. Create a cluster that uses both project-singleton policy enforcement and CV platform policy-based auditing:

    Before using any of the command data below, make the following replacements:

    • CLUSTER_NAME: a cluster name.
    • LOCATION: the location — for example, us-central1 or asia-south1.
    • POLICY_PROJECT_ID_1: the ID of the project where the first platform policy is stored.
    • POLICY_ID_1: the policy ID of the first platform policy.
    • POLICY_PROJECT_ID_2: the ID of the project where the second platform policy is stored. Multiple policies can be stored in the same project or in different projects.
    • POLICY_ID_2: the policy ID of the second platform policy.
    • CLUSTER_PROJECT_ID: the cluster project ID.

    Execute the following command:

    Linux, macOS, or Cloud Shell

    gcloud beta container clusters create CLUSTER_NAME \
        --location=LOCATION \
        --binauthz-evaluation-mode=POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE \
        --binauthz-policy-bindings=name=projects/POLICY_PROJECT_ID_1/platforms/gke/policies/POLICY_ID_1 \
        --binauthz-policy-bindings=name=projects/POLICY_PROJECT_ID_2/platforms/gke/policies/POLICY_ID_2 \
        --project=CLUSTER_PROJECT_ID
    

    Windows (PowerShell)

    gcloud beta container clusters create CLUSTER_NAME `
        --location=LOCATION `
        --binauthz-evaluation-mode=POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE `
        --binauthz-policy-bindings=name=projects/POLICY_PROJECT_ID_1/platforms/gke/policies/POLICY_ID_1 `
        --binauthz-policy-bindings=name=projects/POLICY_PROJECT_ID_2/platforms/gke/policies/POLICY_ID_2 `
        --project=CLUSTER_PROJECT_ID
    

    Windows (cmd.exe)

    gcloud beta container clusters create CLUSTER_NAME ^
        --location=LOCATION ^
        --binauthz-evaluation-mode=POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE ^
        --binauthz-policy-bindings=name=projects/POLICY_PROJECT_ID_1/platforms/gke/policies/POLICY_ID_1 ^
        --binauthz-policy-bindings=name=projects/POLICY_PROJECT_ID_2/platforms/gke/policies/POLICY_ID_2 ^
        --project=CLUSTER_PROJECT_ID
    

It can take a few minutes for your cluster to be created.

Verify that Binary Authorization is enabled

To verify that Binary Authorization is enabled for the cluster, do the following:

Console

  1. Open the GKE page in the Google Cloud console.

    Go to GKE

  2. Under Kubernetes clusters, find your cluster.

  3. Under Security, verify that Binary Authorization is set to Enabled.

gcloud

To list the policy bindings for your cluster, do the following:

gcloud beta container clusters describe CLUSTER_NAME --location LOCATION --project CLUSTER_PROJECT_ID | grep -A 10 policyBindings:

Note that there may be additional information after the policy binding listing.

What's next