|
2111 | 2111 | }
|
2112 | 2112 | }
|
2113 | 2113 | },
|
2114 |
| -"revision": "20241206", |
| 2114 | +"revision": "20250103", |
2115 | 2115 | "rootUrl": "https://gkehub.googleapis.com/",
|
2116 | 2116 | "schemas": {
|
2117 | 2117 | "AppDevExperienceFeatureSpec": {
|
|
2647 | 2647 | "properties": {
|
2648 | 2648 | "allowVerticalScale": {
|
2649 | 2649 | "deprecated": true,
|
2650 |
| -"description": "Set to true to allow the vertical scaling. Defaults to false which disallows vertical scaling. This field is deprecated.", |
| 2650 | +"description": "Optional. Set to true to allow the vertical scaling. Defaults to false which disallows vertical scaling. This field is deprecated.", |
2651 | 2651 | "type": "boolean"
|
2652 | 2652 | },
|
2653 | 2653 | "enabled": {
|
2654 |
| -"description": "Enables the installation of ConfigSync. If set to true, ConfigSync resources will be created and the other ConfigSync fields will be applied if exist. If set to false, all other ConfigSync fields will be ignored, ConfigSync resources will be deleted. If omitted, ConfigSync resources will be managed depends on the presence of the git or oci field.", |
| 2654 | +"description": "Optional. Enables the installation of ConfigSync. If set to true, ConfigSync resources will be created and the other ConfigSync fields will be applied if exist. If set to false, all other ConfigSync fields will be ignored, ConfigSync resources will be deleted. If omitted, ConfigSync resources will be managed depends on the presence of the git or oci field.", |
2655 | 2655 | "type": "boolean"
|
2656 | 2656 | },
|
2657 | 2657 | "git": {
|
2658 | 2658 | "$ref": "ConfigManagementGitConfig",
|
2659 |
| -"description": "Git repo configuration for the cluster." |
| 2659 | +"description": "Optional. Git repo configuration for the cluster." |
2660 | 2660 | },
|
2661 | 2661 | "metricsGcpServiceAccountEmail": {
|
2662 | 2662 | "deprecated": true,
|
2663 |
| -"description": "The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.", |
| 2663 | +"description": "Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.", |
2664 | 2664 | "type": "string"
|
2665 | 2665 | },
|
2666 | 2666 | "oci": {
|
2667 | 2667 | "$ref": "ConfigManagementOciConfig",
|
2668 |
| -"description": "OCI repo configuration for the cluster" |
| 2668 | +"description": "Optional. OCI repo configuration for the cluster" |
2669 | 2669 | },
|
2670 | 2670 | "preventDrift": {
|
2671 |
| -"description": "Set to true to enable the Config Sync admission webhook to prevent drifts. If set to `false`, disables the Config Sync admission webhook and does not prevent drifts.", |
| 2671 | +"description": "Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to `false`, disables the Config Sync admission webhook and does not prevent drifts.", |
2672 | 2672 | "type": "boolean"
|
2673 | 2673 | },
|
2674 | 2674 | "sourceFormat": {
|
2675 |
| -"description": "Specifies whether the Config Sync Repo is in \"hierarchical\" or \"unstructured\" mode.", |
| 2675 | +"description": "Optional. Specifies whether the Config Sync Repo is in \"hierarchical\" or \"unstructured\" mode.", |
2676 | 2676 | "type": "string"
|
2677 | 2677 | },
|
2678 | 2678 | "stopSyncing": {
|
2679 |
| -"description": "Set to true to stop syncing configs for a single cluster. Default to false.", |
| 2679 | +"description": "Optional. Set to true to stop syncing configs for a single cluster. Default to false.", |
2680 | 2680 | "type": "boolean"
|
2681 | 2681 | }
|
2682 | 2682 | },
|
|
2867 | 2867 | "id": "ConfigManagementConfigSyncState",
|
2868 | 2868 | "properties": {
|
2869 | 2869 | "clusterLevelStopSyncingState": {
|
2870 |
| -"description": "Whether syncing resources to the cluster is stopped at the cluster level.", |
| 2870 | +"description": "Output only. Whether syncing resources to the cluster is stopped at the cluster level.", |
2871 | 2871 | "enum": [
|
2872 | 2872 | "STOP_SYNCING_STATE_UNSPECIFIED",
|
2873 | 2873 | "NOT_STOPPED",
|
|
2880 | 2880 | "Some reconcilers stop syncing resources to the cluster, while others are still syncing.",
|
2881 | 2881 | "Syncing resources to the cluster is stopped at the cluster level."
|
2882 | 2882 | ],
|
| 2883 | +"readOnly": true, |
2883 | 2884 | "type": "string"
|
2884 | 2885 | },
|
2885 | 2886 | "crCount": {
|
|
2890 | 2891 | },
|
2891 | 2892 | "deploymentState": {
|
2892 | 2893 | "$ref": "ConfigManagementConfigSyncDeploymentState",
|
2893 |
| -"description": "Information about the deployment of ConfigSync, including the version of the various Pods deployed" |
| 2894 | +"description": "Output only. Information about the deployment of ConfigSync, including the version of the various Pods deployed", |
| 2895 | +"readOnly": true |
2894 | 2896 | },
|
2895 | 2897 | "errors": {
|
2896 |
| -"description": "Errors pertaining to the installation of Config Sync.", |
| 2898 | +"description": "Output only. Errors pertaining to the installation of Config Sync.", |
2897 | 2899 | "items": {
|
2898 | 2900 | "$ref": "ConfigManagementConfigSyncError"
|
2899 | 2901 | },
|
| 2902 | +"readOnly": true, |
2900 | 2903 | "type": "array"
|
2901 | 2904 | },
|
2902 | 2905 | "reposyncCrd": {
|
2903 |
| -"description": "The state of the Reposync CRD", |
| 2906 | +"description": "Output only. The state of the Reposync CRD", |
2904 | 2907 | "enum": [
|
2905 | 2908 | "CRD_STATE_UNSPECIFIED",
|
2906 | 2909 | "NOT_INSTALLED",
|
|
2915 | 2918 | "CRD is terminating (i.e., it has been deleted and is cleaning up)",
|
2916 | 2919 | "CRD is installing"
|
2917 | 2920 | ],
|
| 2921 | +"readOnly": true, |
2918 | 2922 | "type": "string"
|
2919 | 2923 | },
|
2920 | 2924 | "rootsyncCrd": {
|
2921 |
| -"description": "The state of the RootSync CRD", |
| 2925 | +"description": "Output only. The state of the RootSync CRD", |
2922 | 2926 | "enum": [
|
2923 | 2927 | "CRD_STATE_UNSPECIFIED",
|
2924 | 2928 | "NOT_INSTALLED",
|
|
2933 | 2937 | "CRD is terminating (i.e., it has been deleted and is cleaning up)",
|
2934 | 2938 | "CRD is installing"
|
2935 | 2939 | ],
|
| 2940 | +"readOnly": true, |
2936 | 2941 | "type": "string"
|
2937 | 2942 | },
|
2938 | 2943 | "state": {
|
2939 |
| -"description": "The state of CS This field summarizes the other fields in this message.", |
| 2944 | +"description": "Output only. The state of CS This field summarizes the other fields in this message.", |
2940 | 2945 | "enum": [
|
2941 | 2946 | "STATE_UNSPECIFIED",
|
2942 | 2947 | "CONFIG_SYNC_NOT_INSTALLED",
|
|
2951 | 2956 | "CS encounters errors.",
|
2952 | 2957 | "CS is installing or terminating."
|
2953 | 2958 | ],
|
| 2959 | +"readOnly": true, |
2954 | 2960 | "type": "string"
|
2955 | 2961 | },
|
2956 | 2962 | "syncState": {
|
2957 | 2963 | "$ref": "ConfigManagementSyncState",
|
2958 |
| -"description": "The state of ConfigSync's process to sync configs to a cluster" |
| 2964 | +"description": "Output only. The state of ConfigSync's process to sync configs to a cluster", |
| 2965 | +"readOnly": true |
2959 | 2966 | },
|
2960 | 2967 | "version": {
|
2961 | 2968 | "$ref": "ConfigManagementConfigSyncVersion",
|
2962 |
| -"description": "The version of ConfigSync deployed" |
| 2969 | +"description": "Output only. The version of ConfigSync deployed", |
| 2970 | +"readOnly": true |
2963 | 2971 | }
|
2964 | 2972 | },
|
2965 | 2973 | "type": "object"
|
|
3096 | 3104 | "id": "ConfigManagementGitConfig",
|
3097 | 3105 | "properties": {
|
3098 | 3106 | "gcpServiceAccountEmail": {
|
3099 |
| -"description": "The Google Cloud Service Account Email used for auth when secret_type is gcpServiceAccount.", |
| 3107 | +"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is gcpServiceAccount.", |
3100 | 3108 | "type": "string"
|
3101 | 3109 | },
|
3102 | 3110 | "httpsProxy": {
|
3103 |
| -"description": "URL for the HTTPS proxy to be used when communicating with the Git repo.", |
| 3111 | +"description": "Optional. URL for the HTTPS proxy to be used when communicating with the Git repo.", |
3104 | 3112 | "type": "string"
|
3105 | 3113 | },
|
3106 | 3114 | "policyDir": {
|
3107 |
| -"description": "The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.", |
| 3115 | +"description": "Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.", |
3108 | 3116 | "type": "string"
|
3109 | 3117 | },
|
3110 | 3118 | "secretType": {
|
3111 |
| -"description": "Type of secret configured for access to the Git repo. Must be one of ssh, cookiefile, gcenode, token, gcpserviceaccount or none. The validation of this is case-sensitive. Required.", |
| 3119 | +"description": "Required. Type of secret configured for access to the Git repo. Must be one of ssh, cookiefile, gcenode, token, gcpserviceaccount or none. The validation of this is case-sensitive. Required.", |
3112 | 3120 | "type": "string"
|
3113 | 3121 | },
|
3114 | 3122 | "syncBranch": {
|
3115 |
| -"description": "The branch of the repository to sync from. Default: master.", |
| 3123 | +"description": "Optional. The branch of the repository to sync from. Default: master.", |
3116 | 3124 | "type": "string"
|
3117 | 3125 | },
|
3118 | 3126 | "syncRepo": {
|
3119 |
| -"description": "The URL of the Git repository to use as the source of truth.", |
| 3127 | +"description": "Optional. The URL of the Git repository to use as the source of truth.", |
3120 | 3128 | "type": "string"
|
3121 | 3129 | },
|
3122 | 3130 | "syncRev": {
|
3123 |
| -"description": "Git revision (tag or hash) to check out. Default HEAD.", |
| 3131 | +"description": "Optional. Git revision (tag or hash) to check out. Default HEAD.", |
3124 | 3132 | "type": "string"
|
3125 | 3133 | },
|
3126 | 3134 | "syncWaitSecs": {
|
3127 |
| -"description": "Period in seconds between consecutive syncs. Default: 15.", |
| 3135 | +"description": "Optional. Period in seconds between consecutive syncs. Default: 15.", |
3128 | 3136 | "format": "int64",
|
3129 | 3137 | "type": "string"
|
3130 | 3138 | }
|
|
3258 | 3266 | "id": "ConfigManagementMembershipSpec",
|
3259 | 3267 | "properties": {
|
3260 | 3268 | "cluster": {
|
3261 |
| -"description": "The user-specified cluster name used by Config Sync cluster-name-selector annotation or ClusterSelector, for applying configs to only a subset of clusters. Omit this field if the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector. Set this field if a name different from the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector.", |
| 3269 | +"description": "Optional. The user-specified cluster name used by Config Sync cluster-name-selector annotation or ClusterSelector, for applying configs to only a subset of clusters. Omit this field if the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector. Set this field if a name different from the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector.", |
3262 | 3270 | "type": "string"
|
3263 | 3271 | },
|
3264 | 3272 | "configSync": {
|
3265 | 3273 | "$ref": "ConfigManagementConfigSync",
|
3266 |
| -"description": "Config Sync configuration for the cluster." |
| 3274 | +"description": "Optional. Config Sync configuration for the cluster." |
3267 | 3275 | },
|
3268 | 3276 | "hierarchyController": {
|
3269 | 3277 | "$ref": "ConfigManagementHierarchyControllerConfig",
|
3270 |
| -"description": "Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead." |
| 3278 | +"deprecated": true, |
| 3279 | +"description": "Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead." |
3271 | 3280 | },
|
3272 | 3281 | "management": {
|
3273 |
| -"description": "Enables automatic Feature management.", |
| 3282 | +"description": "Optional. Enables automatic Feature management.", |
3274 | 3283 | "enum": [
|
3275 | 3284 | "MANAGEMENT_UNSPECIFIED",
|
3276 | 3285 | "MANAGEMENT_AUTOMATIC",
|
|
3285 | 3294 | },
|
3286 | 3295 | "policyController": {
|
3287 | 3296 | "$ref": "ConfigManagementPolicyController",
|
3288 |
| -"description": "Policy Controller configuration for the cluster. Deprecated: Configuring Policy Controller through the configmanagement feature is no longer recommended. Use the policycontroller feature instead." |
| 3297 | +"deprecated": true, |
| 3298 | +"description": "Optional. Policy Controller configuration for the cluster. Deprecated: Configuring Policy Controller through the configmanagement feature is no longer recommended. Use the policycontroller feature instead." |
3289 | 3299 | },
|
3290 | 3300 | "version": {
|
3291 |
| -"description": "Version of ACM installed.", |
| 3301 | +"description": "Optional. Version of ACM installed.", |
3292 | 3302 | "type": "string"
|
3293 | 3303 | }
|
3294 | 3304 | },
|
|
3299 | 3309 | "id": "ConfigManagementMembershipState",
|
3300 | 3310 | "properties": {
|
3301 | 3311 | "clusterName": {
|
3302 |
| -"description": "This field is set to the `cluster_name` field of the Membership Spec if it is not empty. Otherwise, it is set to the cluster's fleet membership name.", |
| 3312 | +"description": "Output only. This field is set to the `cluster_name` field of the Membership Spec if it is not empty. Otherwise, it is set to the cluster's fleet membership name.", |
| 3313 | +"readOnly": true, |
3303 | 3314 | "type": "string"
|
3304 | 3315 | },
|
3305 | 3316 | "configSyncState": {
|
3306 | 3317 | "$ref": "ConfigManagementConfigSyncState",
|
3307 |
| -"description": "Current sync status" |
| 3318 | +"description": "Output only. Current sync status", |
| 3319 | +"readOnly": true |
3308 | 3320 | },
|
3309 | 3321 | "hierarchyControllerState": {
|
3310 | 3322 | "$ref": "ConfigManagementHierarchyControllerState",
|
3311 |
| -"description": "Hierarchy Controller status" |
| 3323 | +"description": "Output only. Hierarchy Controller status", |
| 3324 | +"readOnly": true |
3312 | 3325 | },
|
3313 | 3326 | "membershipSpec": {
|
3314 | 3327 | "$ref": "ConfigManagementMembershipSpec",
|
3315 |
| -"description": "Membership configuration in the cluster. This represents the actual state in the cluster, while the MembershipSpec in the FeatureSpec represents the intended state" |
| 3328 | +"description": "Output only. Membership configuration in the cluster. This represents the actual state in the cluster, while the MembershipSpec in the FeatureSpec represents the intended state", |
| 3329 | +"readOnly": true |
3316 | 3330 | },
|
3317 | 3331 | "operatorState": {
|
3318 | 3332 | "$ref": "ConfigManagementOperatorState",
|
3319 |
| -"description": "Current install status of ACM's Operator" |
| 3333 | +"description": "Output only. Current install status of ACM's Operator", |
| 3334 | +"readOnly": true |
3320 | 3335 | },
|
3321 | 3336 | "policyControllerState": {
|
3322 | 3337 | "$ref": "ConfigManagementPolicyControllerState",
|
3323 |
| -"description": "PolicyController status" |
| 3338 | +"description": "Output only. PolicyController status", |
| 3339 | +"readOnly": true |
3324 | 3340 | }
|
3325 | 3341 | },
|
3326 | 3342 | "type": "object"
|
|
3330 | 3346 | "id": "ConfigManagementOciConfig",
|
3331 | 3347 | "properties": {
|
3332 | 3348 | "gcpServiceAccountEmail": {
|
3333 |
| -"description": "The Google Cloud Service Account Email used for auth when secret_type is gcpServiceAccount.", |
| 3349 | +"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is gcpServiceAccount.", |
3334 | 3350 | "type": "string"
|
3335 | 3351 | },
|
3336 | 3352 | "policyDir": {
|
3337 |
| -"description": "The absolute path of the directory that contains the local resources. Default: the root directory of the image.", |
| 3353 | +"description": "Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.", |
3338 | 3354 | "type": "string"
|
3339 | 3355 | },
|
3340 | 3356 | "secretType": {
|
3341 |
| -"description": "Type of secret configured for access to the Git repo.", |
| 3357 | +"description": "Optional. Type of secret configured for access to the Git repo.", |
3342 | 3358 | "type": "string"
|
3343 | 3359 | },
|
3344 | 3360 | "syncRepo": {
|
3345 |
| -"description": "The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.", |
| 3361 | +"description": "Optional. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.", |
3346 | 3362 | "type": "string"
|
3347 | 3363 | },
|
3348 | 3364 | "syncWaitSecs": {
|
3349 |
| -"description": "Period in seconds between consecutive syncs. Default: 15.", |
| 3365 | +"description": "Optional. Period in seconds between consecutive syncs. Default: 15.", |
3350 | 3366 | "format": "int64",
|
3351 | 3367 | "type": "string"
|
3352 | 3368 | }
|
|
0 commit comments