diff --git a/docs/index.md b/docs/index.md index 11d4db8..8bc3a7d 100644 --- a/docs/index.md +++ b/docs/index.md @@ -16,3 +16,4 @@ Below are the different versions of Custom Resource Definitions: - [v0.6.0](./v0.6.0.md) - [v0.7.0](./v0.7.0.md) - [v0.7.1](./v0.7.1.md) +- [v0.7.2](./v0.7.2.md) diff --git a/docs/v0.7.2.md b/docs/v0.7.2.md new file mode 100644 index 0000000..3023d19 --- /dev/null +++ b/docs/v0.7.2.md @@ -0,0 +1,1095 @@ +--- +layout: default +--- + +# API Reference + +Packages: + +- [ivaltryek.github.com/v1](#ivaltryekgithubcomv1) + +# ivaltryek.github.com/v1 + +Resource Types: + +- [Nimble](#nimble) + + + + +## Nimble +[↩ Parent](#ivaltryekgithubcomv1 ) + + + + + + +Auto-generated derived type for NimbleSpec via `CustomResource` + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
apiVersionstringivaltryek.github.com/v1true
kindstringNimbletrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject +
+
true
+ + +### Nimble.spec +[↩ Parent](#nimble) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
deploymentobject + Spec for Deployment Object
+
true
hpaobject + Spec for Autoscaling (HPA) Object
+
false
ingressobject + Spec for Ingress Object
+
false
serviceobject + Spec for Service Object
+
false
+ + +### Nimble.spec.deployment +[↩ Parent](#nimblespec) + + + +Spec for Deployment Object + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
containers[]object + Containers to run in the deployment.
+
true
labelsmap[string]string + Labels to be applied to the deployment and its pods.
+
true
annotationsmap[string]string + Annotations to be applied to the deployment and its pods.
+
+ Default: map[app.kubernetes.io/managed-by:kube-nimble]
+
false
+ + +### Nimble.spec.deployment.containers[index] +[↩ Parent](#nimblespecdeployment) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
imagestring + Image to use for a container.
+
true
namestring + Name of the container.
+
true
command[]string + override entrypoint command for a container.
+
false
env[]object + List of environment variables to set in the container. Cannot be updated.
+
false
envFrom[]object + List of sources to populate environment variables in the container. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the container is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated.
+
false
limitsobject + Limits describes the maximum amount of compute resources allowed. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
+
false
livenessProbeobject + Periodic probe of container liveness. Container will be restarted if the probe fails. Cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
+
false
readinessProbeobject + Periodic probe of container service readiness. Container will be removed from service endpoints if the probe fails. Cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
+
false
requestsobject + Requests describes the minimum amount of compute resources required. If Requests is omitted for a container, it defaults to Limits if that is explicitly specified, otherwise to an implementation-defined value. Requests cannot exceed Limits. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
+
false
startupProbeobject + StartupProbe indicates that the Pod has successfully initialized. If specified, no other probes are executed until this completes successfully. If this probe fails, the Pod will be restarted, just as if the livenessProbe failed. This can be used to provide different probe parameters at the beginning of a Pod’s lifecycle, when it might take a long time to load data or warm a cache, than during steady-state operation. This cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
+
false
+ + +### Nimble.spec.deployment.containers[index].env[index] +[↩ Parent](#nimblespecdeploymentcontainersindex) + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
namestring + Name of environment variable
+
true
valuestring + Variable references $(VAR_NAME) are expanded using the previously defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. Double $$ are reduced to a single $, which allows for escaping the $(VAR_NAME) syntax: i.e. “$$(VAR_NAME)” will produce the string literal “$(VAR_NAME)”. Escaped references will never be expanded, regardless of whether the variable exists or not. Defaults to “”.
+
false
+ + +### Nimble.spec.deployment.containers[index].envFrom[index] +[↩ Parent](#nimblespecdeploymentcontainersindex) + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
configMapRefstring + The ConfigMap to select from
+
false
secretRefstring + The Secret to select from
+
false
+ + +### Nimble.spec.deployment.containers[index].limits +[↩ Parent](#nimblespecdeploymentcontainersindex) + + + +Limits describes the maximum amount of compute resources allowed. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
cpustring + cpu config (requests/limits) for the container.
+
false
memorystring + memory config (requests/limits) for the container.
+
false
+ + +### Nimble.spec.deployment.containers[index].livenessProbe +[↩ Parent](#nimblespecdeploymentcontainersindex) + + + +Periodic probe of container liveness. Container will be restarted if the probe fails. Cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
exec[]string + Exec specifies the action to take.
+
false
httpGetobject + HTTPGet specifies the http request to perform.
+
false
initialDelaySecondsinteger + Number of seconds after the container has started before liveness probes are initiated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
+
+ Format: int32
+ Default: 0
+
false
periodSecondsinteger + How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1.
+
+ Format: int32
+ Default: 10
+
false
successThresholdinteger + Minimum consecutive successes for the probe to be considered successful after having failed. Defaults to 1. Must be 1 for liveness and startup. Minimum value is 1.
+
+ Format: int32
+ Default: 1
+
false
tcpSocketobject + TCPSocket specifies an action involving a TCP port.
+
false
+ + +### Nimble.spec.deployment.containers[index].livenessProbe.httpGet +[↩ Parent](#nimblespecdeploymentcontainersindexlivenessprobe) + + + +HTTPGet specifies the http request to perform. + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
pathstring + Path to access on the HTTP server.
+
true
portinteger + Name or number of the port to access on the container. Number must be in the range 1 to 65535.
+
+ Format: int32
+
true
+ + +### Nimble.spec.deployment.containers[index].livenessProbe.tcpSocket +[↩ Parent](#nimblespecdeploymentcontainersindexlivenessprobe) + + + +TCPSocket specifies an action involving a TCP port. + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
portinteger + TCP Port to make checks against.
+
+ Format: int32
+
true
+ + +### Nimble.spec.deployment.containers[index].readinessProbe +[↩ Parent](#nimblespecdeploymentcontainersindex) + + + +Periodic probe of container service readiness. Container will be removed from service endpoints if the probe fails. Cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
exec[]string + Exec specifies the action to take.
+
false
httpGetobject + HTTPGet specifies the http request to perform.
+
false
initialDelaySecondsinteger + Number of seconds after the container has started before liveness probes are initiated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
+
+ Format: int32
+ Default: 0
+
false
periodSecondsinteger + How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1.
+
+ Format: int32
+ Default: 10
+
false
successThresholdinteger + Minimum consecutive successes for the probe to be considered successful after having failed. Defaults to 1. Must be 1 for liveness and startup. Minimum value is 1.
+
+ Format: int32
+ Default: 1
+
false
tcpSocketobject + TCPSocket specifies an action involving a TCP port.
+
false
+ + +### Nimble.spec.deployment.containers[index].readinessProbe.httpGet +[↩ Parent](#nimblespecdeploymentcontainersindexreadinessprobe) + + + +HTTPGet specifies the http request to perform. + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
pathstring + Path to access on the HTTP server.
+
true
portinteger + Name or number of the port to access on the container. Number must be in the range 1 to 65535.
+
+ Format: int32
+
true
+ + +### Nimble.spec.deployment.containers[index].readinessProbe.tcpSocket +[↩ Parent](#nimblespecdeploymentcontainersindexreadinessprobe) + + + +TCPSocket specifies an action involving a TCP port. + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
portinteger + TCP Port to make checks against.
+
+ Format: int32
+
true
+ + +### Nimble.spec.deployment.containers[index].requests +[↩ Parent](#nimblespecdeploymentcontainersindex) + + + +Requests describes the minimum amount of compute resources required. If Requests is omitted for a container, it defaults to Limits if that is explicitly specified, otherwise to an implementation-defined value. Requests cannot exceed Limits. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
cpustring + cpu config (requests/limits) for the container.
+
false
memorystring + memory config (requests/limits) for the container.
+
false
+ + +### Nimble.spec.deployment.containers[index].startupProbe +[↩ Parent](#nimblespecdeploymentcontainersindex) + + + +StartupProbe indicates that the Pod has successfully initialized. If specified, no other probes are executed until this completes successfully. If this probe fails, the Pod will be restarted, just as if the livenessProbe failed. This can be used to provide different probe parameters at the beginning of a Pod’s lifecycle, when it might take a long time to load data or warm a cache, than during steady-state operation. This cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
exec[]string + Exec specifies the action to take.
+
false
httpGetobject + HTTPGet specifies the http request to perform.
+
false
initialDelaySecondsinteger + Number of seconds after the container has started before liveness probes are initiated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
+
+ Format: int32
+ Default: 0
+
false
periodSecondsinteger + How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1.
+
+ Format: int32
+ Default: 10
+
false
successThresholdinteger + Minimum consecutive successes for the probe to be considered successful after having failed. Defaults to 1. Must be 1 for liveness and startup. Minimum value is 1.
+
+ Format: int32
+ Default: 1
+
false
tcpSocketobject + TCPSocket specifies an action involving a TCP port.
+
false
+ + +### Nimble.spec.deployment.containers[index].startupProbe.httpGet +[↩ Parent](#nimblespecdeploymentcontainersindexstartupprobe) + + + +HTTPGet specifies the http request to perform. + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
pathstring + Path to access on the HTTP server.
+
true
portinteger + Name or number of the port to access on the container. Number must be in the range 1 to 65535.
+
+ Format: int32
+
true
+ + +### Nimble.spec.deployment.containers[index].startupProbe.tcpSocket +[↩ Parent](#nimblespecdeploymentcontainersindexstartupprobe) + + + +TCPSocket specifies an action involving a TCP port. + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
portinteger + TCP Port to make checks against.
+
+ Format: int32
+
true
+ + +### Nimble.spec.hpa +[↩ Parent](#nimblespec) + + + +Spec for Autoscaling (HPA) Object + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
maxinteger + maxReplicas is the upper limit for the number of replicas to which the autoscaler can scale up. It cannot be less that minReplicas.
+
+ Format: int32
+
true
annotationsmap[string]string + Annotations to be applied to the HPA object
+
+ Default: map[app.kubernetes.io/managed-by:kube-nimble]
+
false
mininteger + minReplicas is the lower limit for the number of replicas to which the autoscaler can scale down. It defaults to 1 pod. minReplicas is allowed to be 0 if the alpha feature gate HPAScaleToZero is enabled and at least one Object or External metric is configured. Scaling is active as long as at least one metric value is available.
+
+ Format: int32
+ Default: 1
+
false
resourcePolicyobject + resource refers to a resource metric (such as those specified in requests and limits) known to Kubernetes describing each pod in the current scale target (e.g. CPU or memory).
+
false
+ + +### Nimble.spec.hpa.resourcePolicy +[↩ Parent](#nimblespechpa) + + + +resource refers to a resource metric (such as those specified in requests and limits) known to Kubernetes describing each pod in the current scale target (e.g. CPU or memory). + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
namestring + name is the name of the resource in question.
+
true
typestring + type represents whether the metric type is Utilization, Value, or AverageValue
+
true
avgUtilinteger + avgUtil is the target value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods. Currently only valid for Resource metric source type
+
+ Format: int32
+
false
+ + +### Nimble.spec.ingress +[↩ Parent](#nimblespec) + + + +Spec for Ingress Object + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
annotationsmap[string]string + annotations to be applied on Ingress Object
+
+ Default: map[app.kubernetes.io/managed-by:kube-nimble]
+
false
classstring + ingressClassName is the name of an IngressClass cluster resource. Ingress controller implementations use this field to know whether they should be serving this Ingress resource, by a transitive connection (controller -> IngressClass -> Ingress resource). Although the kubernetes.io/ingress.class annotation (simple constant name) was never formally defined, it was widely supported by Ingress controllers to create a direct binding between Ingress controller and Ingress resources. Newly created Ingress resources should prefer using the field. However, even though the annotation is officially deprecated, for backwards compatibility reasons, ingress controllers should still honor that annotation if present.
+
false
rules[]object + rules is a list of host rules used to configure the Ingress. If unspecified, or no rule matches, all traffic is sent to the default backend.
+
false
+ + +### Nimble.spec.ingress.rules[index] +[↩ Parent](#nimblespecingress) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
pathTypestring + pathType determines the interpretation of the path matching. PathType can be one of the following values: * Exact: Matches the URL path exactly. * Prefix: Matches based on a URL path prefix split by ‘/’. Matching is done on a path element by element basis. A path element refers is the list of labels in the path split by the ‘/’ separator. A request is a match for path p if every p is an element-wise prefix of p of the request path. Note that if the last element of the path is a substring of the last element in request path, it is not a match (e.g. /foo/bar matches /foo/bar/baz, but does not match /foo/barbaz).
+
true
hoststring + host can be “precise” which is a domain name without the terminating dot of a network host (e.g. “foo.bar.com”) or “wildcard”, which is a domain name prefixed with a single wildcard label (e.g. “.foo.com”). The wildcard character ‘’ must appear by itself as the first DNS label and matches only a single label. You cannot have a wildcard label by itself (e.g. Host == “*”). Requests will be matched against the Host field in the following way: 1. If host is precise, the request matches this rule if the http host header is equal to Host. 2. If host is a wildcard, then the request matches this rule if the http host header is to equal to the suffix (removing the first label) of the wildcard rule.
+
false
pathstring + path is matched against the path of an incoming request. Currently it can contain characters disallowed from the conventional “path” part of a URL as defined by RFC 3986. Paths must begin with a ‘/’ and must be present when using PathType with value “Exact” or “Prefix”.
+
false
portinteger + port of the referenced service. A port name or port number is required for a IngressServiceBackend.
+
+ Format: int32
+
false
+ + +### Nimble.spec.service +[↩ Parent](#nimblespec) + + + +Spec for Service Object + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
annotationsmap[string]string + Annotations to be applied to the service.
+
+ Default: map[app.kubernetes.io/managed-by:kube-nimble]
+
false
ports[]object + The list of ports that are exposed by this service. More info: https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies
+
false
selectormap[string]string + Route service traffic to pods with label keys and values matching this selector. If empty or not present, the service is assumed to have an external process managing its endpoints, which Kubernetes will not modify. Only applies to types ClusterIP, NodePort, and LoadBalancer. Ignored if type is ExternalName. More info: https://kubernetes.io/docs/concepts/services-networking/service/
+
false
typestring + type determines how the Service is exposed. Defaults to ClusterIP. Valid options are ExternalName, ClusterIP, NodePort, and LoadBalancer. “ClusterIP” allocates a cluster-internal IP address for load-balancing to endpoints. Endpoints are determined by the selector or if that is not specified, by manual construction of an Endpoints object or EndpointSlice objects. If clusterIP is “None”, no virtual IP is allocated and the endpoints are published as a set of endpoints rather than a virtual IP. “NodePort” builds on ClusterIP and allocates a port on every node which routes to the same endpoints as the clusterIP. “LoadBalancer” builds on NodePort and creates an external load-balancer (if supported in the current cloud) which routes to the same endpoints as the clusterIP. “ExternalName” aliases this service to the specified externalName. Several other fields do not apply to ExternalName services. More info: https://kubernetes.io/docs/concepts/services-networking/service/#publishing-services-service-types
+
+ Default: ClusterIP
+
false
+ + +### Nimble.spec.service.ports[index] +[↩ Parent](#nimblespecservice) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescriptionRequired
portinteger + The port that will be exposed by this service.
+
+ Format: int32
+
true
namestring + The name of this port within the service. This must be a DNS_LABEL. All ports within a ServiceSpec must have unique names. When considering the endpoints for a Service, this must match the ‘name’ field in the EndpointPort. Optional if only one ServicePort is defined on this service.
+
false
nodePortinteger + The port on each node on which this service is exposed when type is NodePort or LoadBalancer. Usually assigned by the system. If a value is specified, in-range, and not in use it will be used, otherwise the operation will fail. If not specified, a port will be allocated if this Service requires one. If this field is specified when creating a Service which does not need it, creation will fail. This field will be wiped when updating a Service to no longer need it (e.g. changing type from NodePort to ClusterIP). More info: https://kubernetes.io/docs/concepts/services-networking/service/#type-nodeport
+
+ Format: int32
+
false
protocolstring + The IP protocol for this port. Supports “TCP”, “UDP”, and “SCTP”. Default is TCP.
+
+ Default: TCP
+
false
targetPortinteger + Number or name of the port to access on the pods targeted by the service. Number must be in the range 1 to 65535. Name must be an IANA_SVC_NAME. If this is a string, it will be looked up as a named port in the target Pod’s container ports. If this is not specified, the value of the ‘port’ field is used (an identity map). This field is ignored for services with clusterIP=None, and should be omitted or set equal to the ‘port’ field. More info: https://kubernetes.io/docs/concepts/services-networking/service/#defining-a-service
+
+ Format: int32
+
false