ProvisioningRequest
autoscaling.x-k8s.io / v1
apiVersion: autoscaling.x-k8s.io/v1
kind: ProvisioningRequest
metadata:
name: example
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 required
Spec contains specification of the ProvisioningRequest object.
More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status.
The spec is immutable, to make changes to the request users are expected to delete an existing
and create a new object with the corrected fields.
parameters
object
Parameters contains all other parameters classes may require.
'atomic-scale-up.kubernetes.io' supports 'ValidUntilSeconds' parameter, which should contain
a string denoting duration for which we should retry (measured since creation fo the CR).
podSets []object required
PodSets lists groups of pods for which we would like to provision
resources.
minItems:
1maxItems:
32
count
integer required
Count contains the number of pods that will be created with a given
template.
format:
int32minimum:
1podTemplateRef object required
PodTemplateRef is a reference to a PodTemplate object that is representing pods
that will consume this reservation (must be within the same namespace).
Users need to make sure that the fields relevant to scheduler (e.g. node selector tolerations)
are consistent between this template and actual pods consuming the Provisioning Request.
name
string required
Name of the referenced object.
More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names
pattern:
^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$maxLength:
253
provisioningClassName
string required
ProvisioningClassName describes the different modes of provisioning the resources.
Currently there is no support for 'ProvisioningClass' objects.
Supported values:
* check-capacity.kubernetes.io - check if current cluster state can fullfil this request,
do not reserve the capacity. Users should provide a reference to a valid PodTemplate object.
CA will check if there is enough capacity in cluster to fulfill the request and put
the answer in 'CapacityAvailable' condition.
* atomic-scale-up.kubernetes.io - provision the resources in an atomic manner.
Users should provide a reference to a valid PodTemplate object.
CA will try to create the VMs in an atomic manner, clean any partially provisioned VMs
and re-try the operation in a exponential back-off manner. Users can configure the timeout
duration after which the request will fail by 'ValidUntilSeconds' key in 'Parameters'.
CA will set 'Failed=true' or 'Provisioned=true' condition according to the outcome.
* ... - potential other classes that are specific to the cloud providers.
'kubernetes.io' suffix is reserved for the modes defined in Kubernetes projects.
pattern:
^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$maxLength:
253status object
Status of the ProvisioningRequest. CA constantly reconciles this field.
conditions []object
Conditions represent the observations of a Provisioning Request's
current state. Those will contain information whether the capacity
was found/created or if there were any issues. The condition types
may differ between different provisioning classes.
lastTransitionTime
string required
lastTransitionTime is the 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.
format:
date-time
message
string required
message is a human readable message indicating details about the transition.
This may be an empty string.
maxLength:
32768
observedGeneration
integer
observedGeneration represents the .metadata.generation that the condition was set based upon.
For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
with respect to the current state of the instance.
format:
int64minimum:
0
reason
string required
reason contains a programmatic identifier indicating the reason for the condition's last transition.
Producers of specific condition types may define expected values and meanings for this field,
and whether the values are considered a guaranteed API.
The value should be a CamelCase string.
This field may not be empty.
pattern:
^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$minLength:
1maxLength:
1024
status
string required
status of the condition, one of True, False, Unknown.
enum:
True, False, Unknown
type
string required
type of condition in CamelCase or in foo.example.com/CamelCase.
pattern:
^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$maxLength:
316
provisioningClassDetails
object
ProvisioningClassDetails contains all other values custom provisioning classes may
want to pass to end users.
No matches. Try .spec.parameters for an exact path