InstallPlan defines the installation of a set of operators.
InstallPlan defines the installation of a set of operators.
object
metadata
spec
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 |
|
|
|
InstallPlanSpec defines a set of Application resources to be installed |
|
|
InstallPlanStatus represents the information about the status of steps required to complete installation. Status may trail the actual state of a system. |
InstallPlanSpec defines a set of Application resources to be installed
object
approval
approved
clusterServiceVersionNames
Property | Type | Description |
---|---|---|
|
|
Approval is the user approval policy for an InstallPlan. It must be one of "Automatic" or "Manual". |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
InstallPlanStatus represents the information about the status of steps required to complete installation. Status may trail the actual state of a system.
object
catalogSources
phase
Property | Type | Description |
---|---|---|
|
|
AttenuatedServiceAccountRef references the service account that is used to do scoped operator install. |
|
|
BundleLookups is the set of in-progress requests to pull and unpackage bundle content to the cluster. |
|
|
BundleLookup is a request to pull and unpackage the content of a bundle to the cluster. |
|
|
|
|
|
|
|
|
InstallPlanCondition represents the overall status of the execution of an InstallPlan. |
|
|
Message is a human-readable message containing detailed information that may be important to understanding why the plan has its current status. |
|
|
InstallPlanPhase is the current status of a InstallPlan as a whole. |
|
|
|
|
|
Step represents the status of an individual step in an InstallPlan. |
|
|
StartTime is the time when the controller began applying the resources listed in the plan to the cluster. |
AttenuatedServiceAccountRef references the service account that is used to do scoped operator install.
object
Property | Type | Description |
---|---|---|
|
|
API version of the referent. |
|
|
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. |
|
|
Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
|
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/ |
|
|
Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
|
UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
BundleLookups is the set of in-progress requests to pull and unpackage bundle content to the cluster.
array
BundleLookup is a request to pull and unpackage the content of a bundle to the cluster.
object
catalogSourceRef
identifier
path
replaces
Property | Type | Description |
---|---|---|
|
|
CatalogSourceRef is a reference to the CatalogSource the bundle path was resolved from. |
|
|
Conditions represents the overall state of a BundleLookup. |
|
|
|
|
|
Identifier is the catalog-unique name of the operator (the name of the CSV for bundles that contain CSVs) |
|
|
Path refers to the location of a bundle to pull. It’s typically an image reference. |
|
|
The effective properties of the unpacked bundle. |
|
|
Replaces is the name of the bundle to replace with the one found at Path. |
CatalogSourceRef is a reference to the CatalogSource the bundle path was resolved from.
object
Property | Type | Description |
---|---|---|
|
|
API version of the referent. |
|
|
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. |
|
|
Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
|
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/ |
|
|
Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
|
UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
Conditions represents the overall state of a BundleLookup.
array
object
status
type
Property | Type | Description |
---|---|---|
|
|
Last time the condition transitioned from one status to another. |
|
|
Last time the condition was probed. |
|
|
A human readable message indicating details about the transition. |
|
|
The reason for the condition’s last transition. |
|
|
Status of the condition, one of True, False, Unknown. |
|
|
Type of condition. |
InstallPlanCondition represents the overall status of the execution of an InstallPlan.
object
Property | Type | Description |
---|---|---|
|
|
|
|
|
|
|
|
|
|
|
ConditionReason is a camelcased reason for the state transition. |
|
|
|
|
|
InstallPlanConditionType describes the state of an InstallPlan at a certain point as a whole. |
Step represents the status of an individual step in an InstallPlan.
object
resolving
resource
status
Property | Type | Description |
---|---|---|
|
|
|
|
|
|
|
|
StepResource represents the status of a resource to be tracked by an InstallPlan. |
|
|
StepStatus is the current status of a particular resource an in InstallPlan |
StepResource represents the status of a resource to be tracked by an InstallPlan.
object
group
kind
name
sourceName
sourceNamespace
version
Property | Type | Description |
---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
The following API endpoints are available:
/apis/operators.coreos.com/v1alpha1/installplans
GET
: list objects of kind InstallPlan
/apis/operators.coreos.com/v1alpha1/namespaces/{namespace}/installplans
DELETE
: delete collection of InstallPlan
GET
: list objects of kind InstallPlan
POST
: create an InstallPlan
/apis/operators.coreos.com/v1alpha1/namespaces/{namespace}/installplans/{name}
DELETE
: delete an InstallPlan
GET
: read the specified InstallPlan
PATCH
: partially update the specified InstallPlan
PUT
: replace the specified InstallPlan
/apis/operators.coreos.com/v1alpha1/namespaces/{namespace}/installplans/{name}/status
GET
: read status of the specified InstallPlan
PATCH
: partially update status of the specified InstallPlan
PUT
: replace status of the specified InstallPlan
GET
list objects of kind InstallPlan
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
DELETE
delete collection of InstallPlan
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
GET
list objects of kind InstallPlan
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
POST
create an InstallPlan
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 InstallPlan |
DELETE
delete an InstallPlan
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 InstallPlan
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
PATCH
partially update the specified InstallPlan
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 InstallPlan
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 InstallPlan |
GET
read status of the specified InstallPlan
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
PATCH
partially update status of the specified InstallPlan
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 InstallPlan
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 |