InstallPlan [operators.coreos.com/v1alpha1]
Description
InstallPlan defines the installation of a set of operators.
Type
object
Required
metadata
spec
Specification
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. |
.spec
Description
InstallPlanSpec defines a set of Application resources to be installed
Type
object
Required
approval
approved
clusterServiceVersionNames
Property | Type | Description |
---|---|---|
|
| Approval is the user approval policy for an InstallPlan. It must be one of “Automatic” or “Manual”. |
|
| |
|
| |
|
| |
|
| |
|
|
.status
Description
InstallPlanStatus represents the information about the status of steps required to complete installation. Status may trail the actual state of a system.
Type
object
Required
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. |
.status.attenuatedServiceAccountRef
Description
AttenuatedServiceAccountRef references the service account that is used to do scoped operator install.
Type
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 |
.status.bundleLookups
Description
BundleLookups is the set of in-progress requests to pull and unpackage bundle content to the cluster.
Type
array
.status.bundleLookups[]
Description
BundleLookup is a request to pull and unpackage the content of a bundle to the cluster.
Type
object
Required
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. |
.status.bundleLookups[].catalogSourceRef
Description
CatalogSourceRef is a reference to the CatalogSource the bundle path was resolved from.
Type
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 |
.status.bundleLookups[].conditions
Description
Conditions represents the overall state of a BundleLookup.
Type
array
.status.bundleLookups[].conditions[]
Description
Type
object
Required
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. |
.status.conditions
Description
Type
array
.status.conditions[]
Description
InstallPlanCondition represents the overall status of the execution of an InstallPlan.
Type
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. |
.status.plan
Description
Type
array
.status.plan[]
Description
Step represents the status of an individual step in an InstallPlan.
Type
object
Required
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 |
.status.plan[].resource
Description
StepResource represents the status of a resource to be tracked by an InstallPlan.
Type
object
Required
group
kind
name
sourceName
sourceNamespace
version
Property | Type | Description |
---|---|---|
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
|
API endpoints
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 InstallPlanGET
: list objects of kind InstallPlanPOST
: create an InstallPlan
/apis/operators.coreos.com/v1alpha1/namespaces/{namespace}/installplans/{name}
DELETE
: delete an InstallPlanGET
: read the specified InstallPlanPATCH
: partially update the specified InstallPlanPUT
: replace the specified InstallPlan
/apis/operators.coreos.com/v1alpha1/namespaces/{namespace}/installplans/{name}/status
GET
: read status of the specified InstallPlanPATCH
: partially update status of the specified InstallPlanPUT
: replace status of the specified InstallPlan
/apis/operators.coreos.com/v1alpha1/installplans
HTTP method
GET
Description
list objects of kind InstallPlan
HTTP code | Reponse body |
---|---|
200 - OK | InstallPlanList schema |
401 - Unauthorized | Empty |
/apis/operators.coreos.com/v1alpha1/namespaces/{namespace}/installplans
HTTP method
DELETE
Description
delete collection of InstallPlan
HTTP code | Reponse body |
---|---|
200 - OK | Status schema |
401 - Unauthorized | Empty |
HTTP method
GET
Description
list objects of kind InstallPlan
HTTP code | Reponse body |
---|---|
200 - OK | InstallPlanList schema |
401 - Unauthorized | Empty |
HTTP method
POST
Description
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 |
---|---|---|
| InstallPlan schema |
HTTP code | Reponse body |
---|---|
200 - OK | InstallPlan schema |
201 - Created | InstallPlan schema |
202 - Accepted | InstallPlan schema |
401 - Unauthorized | Empty |
/apis/operators.coreos.com/v1alpha1/namespaces/{namespace}/installplans/{name}
Parameter | Type | Description |
---|---|---|
|
| name of the InstallPlan |
HTTP method
DELETE
Description
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 | Status schema |
202 - Accepted | Status schema |
401 - Unauthorized | Empty |
HTTP method
GET
Description
read the specified InstallPlan
HTTP code | Reponse body |
---|---|
200 - OK | InstallPlan schema |
401 - Unauthorized | Empty |
HTTP method
PATCH
Description
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 | InstallPlan schema |
401 - Unauthorized | Empty |
HTTP method
PUT
Description
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 |
---|---|---|
| InstallPlan schema |
HTTP code | Reponse body |
---|---|
200 - OK | InstallPlan schema |
201 - Created | InstallPlan schema |
401 - Unauthorized | Empty |
/apis/operators.coreos.com/v1alpha1/namespaces/{namespace}/installplans/{name}/status
Parameter | Type | Description |
---|---|---|
|
| name of the InstallPlan |
HTTP method
GET
Description
read status of the specified InstallPlan
HTTP code | Reponse body |
---|---|
200 - OK | InstallPlan schema |
401 - Unauthorized | Empty |
HTTP method
PATCH
Description
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 | InstallPlan schema |
401 - Unauthorized | Empty |
HTTP method
PUT
Description
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 |
---|---|---|
| InstallPlan schema |
HTTP code | Reponse body |
---|---|
200 - OK | InstallPlan schema |
201 - Created | InstallPlan schema |
401 - Unauthorized | Empty |