Last generated May 26, 2020

Cluster

Cluster is the Schema for the clusters API

Full name:
clusters.cluster.x-k8s.io
Group:
cluster.x-k8s.io
Singular name:
cluster
Plural name:
clusters
Scope:
Namespaced
Versions:
v1alpha2

Version v1alpha2

Example CR


apiVersion: infrastructure.giantswarm.io/v1alpha2
kind: Cluster
metadata:
  annotations:
    giantswarm.io/docs: https://pkg.go.dev/sigs.k8s.io/cluster-api/api/v1alpha2?tab=doc#Cluster
  creationTimestamp: null
  name: ca1p0
spec:
  infrastructureRef:
    apiVersion: infrastructure.giantswarm.io/v1alpha2
    kind: AWSCluster
    name: ca1p0
    namespace: default
    resourceVersion: "57975957"
    uid: 2dc05fcd-ba76-4135-b9ea-76955e3a7966

Properties

.apiVersion

string

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

string

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

.metadata

object

.spec

object

ClusterSpec defines the desired state of Cluster

.spec.clusterNetwork

object

Cluster network configuration

.spec.clusterNetwork.apiServerPort

integer

APIServerPort specifies the port the API Server should bind to. Defaults to 6443.

.spec.clusterNetwork.pods

object

The network ranges from which Pod networks are allocated.

.spec.clusterNetwork.pods.cidrBlocks

array Required

.spec.clusterNetwork.pods.cidrBlocks[*]

string

.spec.clusterNetwork.serviceDomain

string

Domain name for services.

.spec.clusterNetwork.services

object

The network ranges from which service VIPs are allocated.

.spec.clusterNetwork.services.cidrBlocks

array Required

.spec.clusterNetwork.services.cidrBlocks[*]

string

.spec.infrastructureRef

object

InfrastructureRef is a reference to a provider-specific resource that holds the details for provisioning infrastructure for a cluster in said provider.

.spec.infrastructureRef.apiVersion

string

API version of the referent.

.spec.infrastructureRef.fieldPath

string

If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: “spec.containers{name}” (where “name” refers to the name of the container that triggered the event) or if no container name is specified “spec.containers[2]” (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object. TODO: this design is not final and this field is subject to change in the future.

.spec.infrastructureRef.kind

.spec.infrastructureRef.name

.spec.infrastructureRef.namespace

.spec.infrastructureRef.resourceVersion

string

.spec.infrastructureRef.uid

.status

object

ClusterStatus defines the observed state of Cluster

.status.apiEndpoints

array

APIEndpoints represents the endpoints to communicate with the control plane.

.status.apiEndpoints[*]

object

APIEndpoint represents a reachable Kubernetes API endpoint.

.status.apiEndpoints[*].host

string Required

The hostname on which the API server is serving.

.status.apiEndpoints[*].port

integer Required

The port on which the API server is serving.

.status.controlPlaneInitialized

boolean

ControlPlaneInitialized defines if the control plane has been initialized.

.status.errorMessage

string

ErrorMessage indicates that there is a problem reconciling the state, and will be set to a descriptive error message.

.status.errorReason

string

ErrorReason indicates that there is a problem reconciling the state, and will be set to a token value suitable for programmatic interpretation.

.status.infrastructureReady

boolean

InfrastructureReady is the state of the infrastructure provider.

.status.phase

string

Phase represents the current phase of cluster actuation. E.g. Pending, Running, Terminating, Failed etc.


This documentation page shows information based on apiextensions v0.4.0.