Last generated October 19, 2020
AzureCluster is the Schema for the azureclusters API
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
AzureClusterSpec defines the desired state of AzureCluster
AdditionalTags is an optional set of tags to add to Azure resources managed by the Azure provider, in addition to the ones added by default.
ControlPlaneEndpoint represents the endpoint used to communicate with the control plane.
The hostname on which the API server is serving.
The port on which the API server is serving.
NetworkSpec encapsulates all things related to Azure network.
Subnets is the configuration for the control-plane subnet and the node subnet.
SubnetSpec configures an Azure subnet.
CidrBlock is the CIDR block to be used when the provider creates a managed Vnet. DEPRECATED: Use CIDRBlocks instead
CIDRBlocks defines the subnet’s address space, specified as one or more address prefixes in CIDR notation.
ID defines a unique identifier to reference this resource.
InternalLBIPAddress is the IP address that will be used as the internal LB private IP. For the control plane subnet only.
Name defines a name for the subnet resource.
Role defines the subnet role (eg. Node, ControlPlane)
RouteTable defines the route table that should be attached to this subnet.
SecurityGroup defines the NSG (network security group) that should be attached to this subnet.
IngressRules is a slice of Azure ingress rules for security groups.
IngressRule defines an Azure ingress rule for security groups.
Destination - The destination address prefix. CIDR or destination IP range. Asterix ‘*’ can also be used to match all source IPs. Default tags such as ‘VirtualNetwork’, ‘AzureLoadBalancer’ and ‘Internet’ can also be used.
DestinationPorts - The destination port or range. Integer or range between 0 and 65535. Asterix ‘*’ can also be used to match all ports.
Priority - A number between 100 and 4096. Each rule should have a unique value for priority. Rules are processed in priority order, with lower numbers processed before higher numbers. Once traffic matches a rule, processing stops.
SecurityGroupProtocol defines the protocol type for a security group rule.
Source - The CIDR or source IP range. Asterix ‘*’ can also be used to match all source IPs. Default tags such as ‘VirtualNetwork’, ‘AzureLoadBalancer’ and ‘Internet’ can also be used. If this is an ingress rule, specifies where network traffic originates from.
SourcePorts - The source port or range. Integer or range between 0 and 65535. Asterix ‘*’ can also be used to match all ports.
Tags defines a map of tags.
Vnet is the configuration for the Azure virtual network.
CidrBlock is the CIDR block to be used when the provider creates a managed virtual network. DEPRECATED: Use CIDRBlocks instead
CIDRBlocks defines the virtual network’s address space, specified as one or more address prefixes in CIDR notation.
ID is the identifier of the virtual network this provider should use to create resources.
Name defines a name for the virtual network resource.
ResourceGroup is the name of the resource group of the existing virtual network or the resource group where a managed virtual network should be created.
Tags is a collection of tags describing the resource.
AzureClusterStatus defines the observed state of AzureCluster
Conditions defines current service state of the AzureCluster.
Condition defines an observation of a Cluster API resource operational state.
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.
FailureDomains specifies the list of unique failure domains for the location/region of the cluster. A FailureDomain maps to Availability Zone with an Azure Region (if the region support them). An Availability Zone is a separate data center within a region and they can be used to ensure the cluster is more resilient to failure. See: https://docs.microsoft.com/en-us/azure/availability-zones/az-overview This list will be used by Cluster API to try and spread the machines across the failure domains.
Network encapsulates the state of Azure networking resources.
APIServerIP is the Kubernetes API server public IP address.
APIServerLB is the Kubernetes API server load balancer.
BackendPool defines a load balancer backend pool
FrontendIPConfig - DO NOT USE this empty struct is here to preserve backwards compatibility and should be removed in v1alpha4
SKU defines an Azure load balancer SKU.
Tags defines a map of tags.
Ready is true when the provider resource is ready.
This documentation page shows information based on apiextensions v3.2.0.
Need help with the Control Plane Kubernetes API?
We listen in your Slack support channel. And of course, we welcome your pull requests to improve these docs!