GCPManagedCluster is the Schema for the gcpmanagedclusters API.
GCPManagedCluster is the Schema for the gcpmanagedclusters API.
object
Property | Type | Description |
---|---|---|
|
|
APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata |
|
|
|
GCPManagedClusterSpec defines the desired state of GCPManagedCluster. |
|
|
GCPManagedClusterStatus defines the observed state of GCPManagedCluster. |
GCPManagedClusterSpec defines the desired state of GCPManagedCluster.
object
project
region
Property | Type | Description |
---|---|---|
|
|
AdditionalLabels is an optional set of tags to add to GCP resources managed by the GCP provider, in addition to the ones added by default. |
|
|
ControlPlaneEndpoint represents the endpoint used to communicate with the control plane. |
|
|
CredentialsRef is a reference to a Secret that contains the credentials to use for provisioning this cluster. If not supplied then the credentials of the controller will be used. |
|
|
LoadBalancerSpec contains configuration for one or more LoadBalancers. |
|
|
NetworkSpec encapsulates all things related to the GCP network. |
|
|
Project is the name of the project to deploy the cluster to. |
|
|
The GCP Region the cluster lives in. |
|
|
ResourceManagerTags is an optional set of tags to apply to GCP resources managed by the GCP provider. GCP supports a maximum of 50 tags per resource. |
|
|
ResourceManagerTag is a tag to apply to GCP resources managed by the GCP provider. |
ControlPlaneEndpoint represents the endpoint used to communicate with the control plane.
object
host
port
Property | Type | Description |
---|---|---|
|
|
The hostname on which the API server is serving. |
|
|
The port on which the API server is serving. |
CredentialsRef is a reference to a Secret that contains the credentials to use for provisioning this cluster. If not supplied then the credentials of the controller will be used.
object
name
namespace
Property | Type | Description |
---|---|---|
|
|
Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
LoadBalancerSpec contains configuration for one or more LoadBalancers.
object
Property | Type | Description |
---|---|---|
|
|
APIServerInstanceGroupTagOverride overrides the default setting for the tag used when creating the API Server Instance Group. |
|
|
InternalLoadBalancer is the configuration for an Internal Passthrough Network Load Balancer. |
|
|
LoadBalancerType defines the type of Load Balancer that should be created. If not set, a Global External Proxy Load Balancer will be created by default. |
InternalLoadBalancer is the configuration for an Internal Passthrough Network Load Balancer.
object
Property | Type | Description |
---|---|---|
|
|
Name is the name of the Load Balancer. If not set a default name will be used. For an Internal Load Balancer service the default name is "api-internal". |
|
|
Subnet is the name of the subnet to use for a regional Load Balancer. A subnet is required for the Load Balancer, if not defined the first configured subnet will be used. |
NetworkSpec encapsulates all things related to the GCP network.
object
Property | Type | Description |
---|---|---|
|
|
AutoCreateSubnetworks: When set to true, the VPC network is created in "auto" mode. When set to false, the VPC network is created in "custom" mode. An auto mode VPC network starts with one subnet per region. Each subnet has a predetermined range as described in Auto mode VPC network IP ranges. Defaults to true. |
|
|
HostProject is the name of the project hosting the shared VPC network resources. |
|
|
Allow for configuration of load balancer backend (useful for changing apiserver port) |
|
|
Name is the name of the network to be used. |
|
|
Subnets configuration. |
|
|
SubnetSpec configures an GCP Subnet. |
SubnetSpec configures an GCP Subnet.
object
Property | Type | Description |
---|---|---|
|
|
CidrBlock is the range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 192.168.0.0/16. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field can be set only at resource creation time. |
|
|
Description is an optional description associated with the resource. |
|
|
EnableFlowLogs: Whether to enable flow logging for this subnetwork. If this field is not explicitly set, it will not appear in get listings. If not set the default behavior is to disable flow logging. |
|
|
Name defines a unique identifier to reference this resource. |
|
|
PrivateGoogleAccess defines whether VMs in this subnet can access Google services without assigning external IP addresses |
|
|
Purpose: The purpose of the resource. If unspecified, the purpose defaults to PRIVATE_RFC_1918. The enableFlowLogs field isn’t supported with the purpose field set to INTERNAL_HTTPS_LOAD_BALANCER. Possible values: "INTERNAL_HTTPS_LOAD_BALANCER" - Subnet reserved for Internal HTTP(S) Load Balancing. "PRIVATE" - Regular user created or automatically created subnet. "PRIVATE_RFC_1918" - Regular user created or automatically created subnet. "PRIVATE_SERVICE_CONNECT" - Subnetworks created for Private Service Connect in the producer network. "REGIONAL_MANAGED_PROXY" - Subnetwork used for Regional Internal/External HTTP(S) Load Balancing. |
|
|
Region is the name of the region where the Subnetwork resides. |
|
|
SecondaryCidrBlocks defines secondary CIDR ranges, from which secondary IP ranges of a VM may be allocated |
ResourceManagerTags is an optional set of tags to apply to GCP resources managed by the GCP provider. GCP supports a maximum of 50 tags per resource.
array
ResourceManagerTag is a tag to apply to GCP resources managed by the GCP provider.
object
key
parentID
value
Property | Type | Description |
---|---|---|
|
|
Key is the key part of the tag. A tag key can have a maximum of 63 characters and cannot
be empty. Tag key must begin and end with an alphanumeric character, and must contain
only uppercase, lowercase alphanumeric characters, and the following special
characters |
|
|
ParentID is the ID of the hierarchical resource where the tags are defined e.g. at the Organization or the Project level. To find the Organization or Project ID ref https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects An OrganizationID must consist of decimal numbers, and cannot have leading zeroes. A ProjectID must be 6 to 30 characters in length, can only contain lowercase letters, numbers, and hyphens, and must start with a letter, and cannot end with a hyphen. |
|
|
Value is the value part of the tag. A tag value can have a maximum of 63 characters and
cannot be empty. Tag value must begin and end with an alphanumeric character, and must
contain only uppercase, lowercase alphanumeric characters, and the following special
characters |
GCPManagedClusterStatus defines the observed state of GCPManagedCluster.
object
ready
Property | Type | Description |
---|---|---|
|
|
Conditions specifies the conditions for the managed control plane |
|
|
Condition defines an observation of a Cluster API resource operational state. |
|
|
FailureDomains is a slice of FailureDomains. |
|
|
FailureDomainSpec is the Schema for Cluster API failure domains. It allows controllers to understand how many failure domains a cluster can optionally span across. |
|
|
Network encapsulates GCP networking resources. |
|
|
Conditions specifies the conditions for the managed control plane
array
Condition defines an observation of a Cluster API resource operational state.
object
lastTransitionTime
status
type
Property | Type | Description |
---|---|---|
|
|
Last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable. |
|
|
A human readable message indicating details about the transition. This field may be empty. |
|
|
The reason for the condition’s last transition in CamelCase. The specific API may choose whether or not this field is considered a guaranteed API. This field may not be empty. |
|
|
Severity provides an explicit classification of Reason code, so the users or machines can immediately understand the current situation and act accordingly. The Severity field MUST be set only when Status=False. |
|
|
Status of the condition, one of True, False, Unknown. |
|
|
Type of condition in CamelCase or in foo.example.com/CamelCase. Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be useful (see .node.status.conditions), the ability to deconflict is important. |
FailureDomainSpec is the Schema for Cluster API failure domains. It allows controllers to understand how many failure domains a cluster can optionally span across.
object
Property | Type | Description |
---|---|---|
|
|
Attributes is a free form map of attributes an infrastructure provider might use or require. |
|
|
ControlPlane determines if this failure domain is suitable for use by control plane machines. |
Network encapsulates GCP networking resources.
object
Property | Type | Description |
---|---|---|
|
|
APIInternalBackendService is the full reference to the backend service created for the internal Load Balancer. |
|
|
APIInternalForwardingRule is the full reference to the forwarding rule created for the internal Load Balancer. |
|
|
APIInternalHealthCheck is the full reference to the health check created for the internal Load Balancer. |
|
|
APIInternalAddress is the IPV4 regional address assigned to the internal Load Balancer. |
|
|
APIServerBackendService is the full reference to the backend service created for the API Server. |
|
|
APIServerForwardingRule is the full reference to the forwarding rule created for the API Server. |
|
|
APIServerHealthCheck is the full reference to the health check created for the API Server. |
|
|
APIServerInstanceGroups is a map from zone to the full reference to the instance groups created for the control plane nodes created in the same zone. |
|
|
APIServerAddress is the IPV4 global address assigned to the load balancer created for the API Server. |
|
|
APIServerTargetProxy is the full reference to the target proxy created for the API Server. |
|
|
FirewallRules is a map from the name of the rule to its full reference. |
|
|
Router is the full reference to the router created within the network it’ll contain the cloud nat gateway |
|
|
SelfLink is the link to the Network used for this cluster. |
The following API endpoints are available:
/apis/infrastructure.cluster.x-k8s.io/v1beta1/gcpmanagedclusters
GET
: list objects of kind GCPManagedCluster
/apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/gcpmanagedclusters
DELETE
: delete collection of GCPManagedCluster
GET
: list objects of kind GCPManagedCluster
POST
: create a GCPManagedCluster
/apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/gcpmanagedclusters/{name}
DELETE
: delete a GCPManagedCluster
GET
: read the specified GCPManagedCluster
PATCH
: partially update the specified GCPManagedCluster
PUT
: replace the specified GCPManagedCluster
/apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/gcpmanagedclusters/{name}/status
GET
: read status of the specified GCPManagedCluster
PATCH
: partially update status of the specified GCPManagedCluster
PUT
: replace status of the specified GCPManagedCluster
GET
list objects of kind GCPManagedCluster
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
DELETE
delete collection of GCPManagedCluster
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
GET
list objects of kind GCPManagedCluster
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
POST
create a GCPManagedCluster
Parameter | Type | Description |
---|---|---|
|
|
When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed |
|
|
fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized |
Empty |
Parameter | Type | Description |
---|---|---|
|
|
name of the GCPManagedCluster |
DELETE
delete a GCPManagedCluster
Parameter | Type | Description |
---|---|---|
|
|
When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed |
HTTP code | Reponse body |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized |
Empty |
GET
read the specified GCPManagedCluster
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
PATCH
partially update the specified GCPManagedCluster
Parameter | Type | Description |
---|---|---|
|
|
When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed |
|
|
fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
PUT
replace the specified GCPManagedCluster
Parameter | Type | Description |
---|---|---|
|
|
When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed |
|
|
fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized |
Empty |
Parameter | Type | Description |
---|---|---|
|
|
name of the GCPManagedCluster |
GET
read status of the specified GCPManagedCluster
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
PATCH
partially update status of the specified GCPManagedCluster
Parameter | Type | Description |
---|---|---|
|
|
When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed |
|
|
fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
PUT
replace status of the specified GCPManagedCluster
Parameter | Type | Description |
---|---|---|
|
|
When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed |
|
|
fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized |
Empty |