docs: BinaryAuthorization.enabled field is marked as deprecated

Google APIs · copybara-github · commit 901a2a2b94c1 · 2022-08-02T01:35:25.000-07:00
PiperOrigin-RevId: 464729205
diff --git a/google/container/v1beta1/cluster_service.proto b/google/container/v1beta1/cluster_service.proto
@@ -1262,7 +1262,7 @@ message NetworkPolicy {
 
 // Configuration for controlling how IPs are allocated in the cluster.
 message IPAllocationPolicy {
-  // IP stack type
+  // Possible values for IP stack type
   enum StackType {
     // By default, the clusters will be IPV4 only
     STACK_TYPE_UNSPECIFIED = 0;
@@ -1446,9 +1446,10 @@ message BinaryAuthorization {
     PROJECT_SINGLETON_POLICY_ENFORCE = 2;
   }
 
-  // Enable Binary Authorization for this cluster. If enabled, all container
-  // images will be validated by Binary Authorization.
-  bool enabled = 1;
+  // This field is deprecated. Leave this unset and instead configure
+  // BinaryAuthorization using evaluation_mode. If evaluation_mode is set to
+  // anything other than EVALUATION_MODE_UNSPECIFIED, this field is ignored.
+  bool enabled = 1 [deprecated = true];
 
   // Mode of operation for binauthz policy evaluation. Currently the only
   // options are equivalent to enable/disable. If unspecified, defaults to
@@ -1920,7 +1921,7 @@ message NodePoolDefaults {
 
 // Subset of NodeConfig message that has defaults.
 message NodeConfigDefaults {
-  // GCFS (Google Container File System, a.k.a. Riptide) options.
+  // GCFS (Google Container File System, also known as Riptide) options.
   GcfsConfig gcfs_config = 1;
 }
 
@@ -3718,7 +3719,7 @@ message SetNodePoolSizeRequest {
 message CompleteNodePoolUpgradeRequest {
   // The name (project, location, cluster, node pool id) of the node pool to
   // complete upgrade.
-  // Specified in the format 'projects/*/locations/*/clusters/*/nodePools/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*/nodePools/*`.
   string name = 1;
 }
 
@@ -3849,7 +3850,8 @@ message AutoprovisioningNodePoolDefaults {
   // information, read [how to specify min CPU
   // platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
   // This field is deprecated, min_cpu_platform should be specified using
-  // cloud.google.com/requested-min-cpu-platform label selector on the pod.
+  // https://cloud.google.com/requested-min-cpu-platform label selector on the
+  // pod.
   // To unset the min cpu platform field pass "automatic"
   // as field value.
   string min_cpu_platform = 5 [deprecated = true];
@@ -4291,7 +4293,7 @@ message Location {
   // Specified in the format `projects/*/locations/*`.
   string name = 2;
 
-  // Whether the location is recomended for GKE cluster scheduling.
+  // Whether the location is recommended for GKE cluster scheduling.
   bool recommended = 3;
 }
 
