fluxcd
/
notification-controller
mirror of https://github.com/fluxcd/notification-controller.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update controller-gen to v0.14.0 

Also update to use GOBIN if it exist

Signed-off-by: Soule BA <bah.soule@gmail.com>
(cherry picked from commit c2302f8fed)
This commit is contained in:
Soule BA 2024-03-12 15:01:35 +01:00 committed by github-actions[bot]
parent dd8e314f8c
commit 6e0e5dcfb6
8 changed files with 525 additions and 420 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
Makefile
View File

@ -9,7 +9,7 @@ REPOSITORY_ROOT := $(shell git rev-parse --show-toplevel)
BUILD_DIR := $(REPOSITORY_ROOT)/build BUILD_DIR := $(REPOSITORY_ROOT)/build
# API (doc) generation utilities # API (doc) generation utilities
CONTROLLER_GEN_VERSION ?= v0.12.0 CONTROLLER_GEN_VERSION ?= v0.14.0
GEN_API_REF_DOCS_VERSION ?= e327d0730470cbd61b06300f81c5fcf91c23c113 GEN_API_REF_DOCS_VERSION ?= e327d0730470cbd61b06300f81c5fcf91c23c113
# Get the currently used golang install path (in GOPATH/bin, unless GOBIN is set) # Get the currently used golang install path (in GOPATH/bin, unless GOBIN is set)
@ -153,13 +153,13 @@ fuzz-native:
./tests/fuzz/native_go_run.sh ./tests/fuzz/native_go_run.sh
# Find or download controller-gen # Find or download controller-gen
CONTROLLER_GEN = $(shell pwd)/bin/controller-gen CONTROLLER_GEN = $(GOBIN)/controller-gen
.PHONY: controller-gen .PHONY: controller-gen
controller-gen: ## Download controller-gen locally if necessary. controller-gen: ## Download controller-gen locally if necessary.
$(call go-install-tool,$(CONTROLLER_GEN),sigs.k8s.io/controller-tools/cmd/controller-gen@$(CONTROLLER_GEN_VERSION)) $(call go-install-tool,$(CONTROLLER_GEN),sigs.k8s.io/controller-tools/cmd/controller-gen@$(CONTROLLER_GEN_VERSION))
# Find or download gen-crd-api-reference-docs # Find or download gen-crd-api-reference-docs
GEN_CRD_API_REFERENCE_DOCS = $(shell pwd)/bin/gen-crd-api-reference-docs GEN_CRD_API_REFERENCE_DOCS = $(GOBIN)/gen-crd-api-reference-docs
.PHONY: gen-crd-api-reference-docs .PHONY: gen-crd-api-reference-docs
gen-crd-api-reference-docs: gen-crd-api-reference-docs:
$(call go-install-tool,$(GEN_CRD_API_REFERENCE_DOCS),github.com/ahmetb/gen-crd-api-reference-docs@$(GEN_API_REF_DOCS_VERSION)) $(call go-install-tool,$(GEN_CRD_API_REFERENCE_DOCS),github.com/ahmetb/gen-crd-api-reference-docs@$(GEN_API_REF_DOCS_VERSION))
@ -171,7 +171,7 @@ install-envtest: setup-envtest
mkdir -p ${ENVTEST_ASSETS_DIR} mkdir -p ${ENVTEST_ASSETS_DIR}
$(ENVTEST) use $(ENVTEST_KUBERNETES_VERSION) --arch=$(ENVTEST_ARCH) --bin-dir=$(ENVTEST_ASSETS_DIR) $(ENVTEST) use $(ENVTEST_KUBERNETES_VERSION) --arch=$(ENVTEST_ARCH) --bin-dir=$(ENVTEST_ASSETS_DIR)
ENVTEST = $(shell pwd)/bin/setup-envtest ENVTEST = $(GOBIN)/setup-envtest
.PHONY: envtest .PHONY: envtest
setup-envtest: ## Download envtest-setup locally if necessary. setup-envtest: ## Download envtest-setup locally if necessary.
$(call go-install-tool,$(ENVTEST),sigs.k8s.io/controller-runtime/tools/setup-envtest@latest) $(call go-install-tool,$(ENVTEST),sigs.k8s.io/controller-runtime/tools/setup-envtest@latest)
@ -185,7 +185,7 @@ TMP_DIR=$$(mktemp -d) ;\
cd $$TMP_DIR ;\ cd $$TMP_DIR ;\
go mod init tmp ;\ go mod init tmp ;\
echo "Downloading $(2)" ;\ echo "Downloading $(2)" ;\
GOBIN=$(PROJECT_DIR)/bin go install $(2) ;\ GOBIN=$(GOBIN) go install $(2) ;\
rm -rf $$TMP_DIR ;\ rm -rf $$TMP_DIR ;\
} }
endef endef

1
api/v1/zz_generated.deepcopy.go
View File

@ -1,5 +1,4 @@
//go:build !ignore_autogenerated //go:build !ignore_autogenerated
// +build !ignore_autogenerated
/* /*
Copyright 2023 The Flux authors Copyright 2023 The Flux authors

1
api/v1beta1/zz_generated.deepcopy.go
View File

@ -1,5 +1,4 @@
//go:build !ignore_autogenerated //go:build !ignore_autogenerated
// +build !ignore_autogenerated
/* /*
Copyright 2023 The Flux authors Copyright 2023 The Flux authors

1
api/v1beta2/zz_generated.deepcopy.go
View File

@ -1,5 +1,4 @@
//go:build !ignore_autogenerated //go:build !ignore_autogenerated
// +build !ignore_autogenerated
/* /*
Copyright 2023 The Flux authors Copyright 2023 The Flux authors

1
api/v1beta3/zz_generated.deepcopy.go
View File

@ -1,5 +1,4 @@
//go:build !ignore_autogenerated //go:build !ignore_autogenerated
// +build !ignore_autogenerated
/* /*
Copyright 2023 The Flux authors Copyright 2023 The Flux authors

306
config/crd/bases/notification.toolkit.fluxcd.io_alerts.yaml
View File

@ -3,7 +3,7 @@ apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition kind: CustomResourceDefinition
metadata: metadata:
annotations: annotations:
controller-gen.kubebuilder.io/version: v0.12.0 controller-gen.kubebuilder.io/version: v0.14.0
name: alerts.notification.toolkit.fluxcd.io name: alerts.notification.toolkit.fluxcd.io
spec: spec:
group: notification.toolkit.fluxcd.io group: notification.toolkit.fluxcd.io
@ -32,14 +32,19 @@ spec:
description: Alert is the Schema for the alerts API description: Alert is the Schema for the alerts API
properties: properties:
apiVersion: apiVersion:
description: 'APIVersion defines the versioned schema of this representation description: |-
of an object. Servers should convert recognized schemas to the latest APIVersion defines the versioned schema of this representation of an object.
internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources' 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
type: string type: string
kind: kind:
description: 'Kind is a string value representing the REST resource this description: |-
object represents. Servers may infer this from the endpoint the client Kind is a string value representing the REST resource this object represents.
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds' 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
type: string type: string
metadata: metadata:
type: object type: object
@ -49,7 +54,8 @@ spec:
properties: properties:
eventSeverity: eventSeverity:
default: info default: info
description: Filter events based on severity, defaults to ('info'). description: |-
Filter events based on severity, defaults to ('info').
If set to 'info' no events will be filtered. If set to 'info' no events will be filtered.
enum: enum:
- info - info
@ -58,8 +64,9 @@ spec:
eventSources: eventSources:
description: Filter events based on the involved objects. description: Filter events based on the involved objects.
items: items:
description: CrossNamespaceObjectReference contains enough information description: |-
to let you locate the typed referenced object at cluster level CrossNamespaceObjectReference contains enough information to let you locate the
typed referenced object at cluster level
properties: properties:
apiVersion: apiVersion:
description: API version of the referent description: API version of the referent
@ -81,11 +88,10 @@ spec:
matchLabels: matchLabels:
additionalProperties: additionalProperties:
type: string type: string
description: MatchLabels is a map of {key,value} pairs. A single description: |-
{key,value} in the matchLabels map is equivalent to an element MatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
of matchExpressions, whose key field is "key", the operator map is equivalent to an element of matchExpressions, whose key field is "key", the
is "In", and the values array contains only "value". The requirements operator is "In", and the values array contains only "value". The requirements are ANDed.
are ANDed.
type: object type: object
name: name:
description: Name of the referent description: Name of the referent
@ -120,8 +126,9 @@ spec:
description: Short description of the impact and affected cluster. description: Short description of the impact and affected cluster.
type: string type: string
suspend: suspend:
description: This flag tells the controller to suspend subsequent description: |-
events dispatching. Defaults to false. This flag tells the controller to suspend subsequent events dispatching.
Defaults to false.
type: boolean type: boolean
required: required:
- eventSources - eventSources
@ -135,42 +142,42 @@ spec:
conditions: conditions:
items: items:
description: "Condition contains details for one aspect of the current description: "Condition contains details for one aspect of the current
state of this API Resource. --- This struct is intended for direct state of this API Resource.\n---\nThis struct is intended for
use as an array at the field path .status.conditions. For example, direct use as an array at the field path .status.conditions. For
\n type FooStatus struct{ // Represents the observations of a example,\n\n\n\ttype FooStatus struct{\n\t // Represents the
foo's current state. // Known .status.conditions.type are: \"Available\", observations of a foo's current state.\n\t // Known .status.conditions.type
\"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge are: \"Available\", \"Progressing\", and \"Degraded\"\n\t //
// +listType=map // +listMapKey=type Conditions []metav1.Condition +patchMergeKey=type\n\t // +patchStrategy=merge\n\t // +listType=map\n\t
`json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\" \ // +listMapKey=type\n\t Conditions []metav1.Condition `json:\"conditions,omitempty\"
protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }" patchStrategy:\"merge\" patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"`\n\n\n\t
\ // other fields\n\t}"
properties: properties:
lastTransitionTime: lastTransitionTime:
description: lastTransitionTime is the last time the condition description: |-
transitioned from one status to another. This should be when lastTransitionTime is the last time the condition transitioned from one status to another.
the underlying condition changed. If that is not known, then This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
using the time when the API field changed is acceptable.
format: date-time format: date-time
type: string type: string
message: message:
description: message is a human readable message indicating description: |-
details about the transition. This may be an empty string. message is a human readable message indicating details about the transition.
This may be an empty string.
maxLength: 32768 maxLength: 32768
type: string type: string
observedGeneration: observedGeneration:
description: observedGeneration represents the .metadata.generation description: |-
that the condition was set based upon. For instance, if .metadata.generation observedGeneration represents the .metadata.generation that the condition was set based upon.
is currently 12, but the .status.conditions[x].observedGeneration For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
is 9, the condition is out of date with respect to the current with respect to the current state of the instance.
state of the instance.
format: int64 format: int64
minimum: 0 minimum: 0
type: integer type: integer
reason: reason:
description: reason contains a programmatic identifier indicating description: |-
the reason for the condition's last transition. Producers reason contains a programmatic identifier indicating the reason for the condition's last transition.
of specific condition types may define expected values and Producers of specific condition types may define expected values and meanings for this field,
meanings for this field, and whether the values are considered and whether the values are considered a guaranteed API.
a guaranteed API. The value should be a CamelCase string. The value should be a CamelCase string.
This field may not be empty. This field may not be empty.
maxLength: 1024 maxLength: 1024
minLength: 1 minLength: 1
@ -184,11 +191,12 @@ spec:
- Unknown - Unknown
type: string type: string
type: type:
description: type of condition in CamelCase or in foo.example.com/CamelCase. description: |-
--- Many .condition.type values are consistent across resources type of condition in CamelCase or in foo.example.com/CamelCase.
like Available, but because arbitrary conditions can be useful ---
(see .node.status.conditions), the ability to deconflict is Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be
important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt) useful (see .node.status.conditions), the ability to deconflict is important.
The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
maxLength: 316 maxLength: 316
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])$ 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])$
type: string type: string
@ -228,14 +236,19 @@ spec:
description: Alert is the Schema for the alerts API description: Alert is the Schema for the alerts API
properties: properties:
apiVersion: apiVersion:
description: 'APIVersion defines the versioned schema of this representation description: |-
of an object. Servers should convert recognized schemas to the latest APIVersion defines the versioned schema of this representation of an object.
internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources' 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
type: string type: string
kind: kind:
description: 'Kind is a string value representing the REST resource this description: |-
object represents. Servers may infer this from the endpoint the client Kind is a string value representing the REST resource this object represents.
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds' 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
type: string type: string
metadata: metadata:
type: object type: object
@ -246,27 +259,30 @@ spec:
eventMetadata: eventMetadata:
additionalProperties: additionalProperties:
type: string type: string
description: EventMetadata is an optional field for adding metadata description: |-
to events dispatched by the controller. This can be used for enhancing EventMetadata is an optional field for adding metadata to events dispatched by the
the context of the event. If a field would override one already controller. This can be used for enhancing the context of the event. If a field
present on the original event as generated by the emitter, then would override one already present on the original event as generated by the emitter,
the override doesn't happen, i.e. the original value is preserved, then the override doesn't happen, i.e. the original value is preserved, and an info
and an info log is printed. log is printed.
type: object type: object
eventSeverity: eventSeverity:
default: info default: info
description: EventSeverity specifies how to filter events based on description: |-
severity. If set to 'info' no events will be filtered. EventSeverity specifies how to filter events based on severity.
If set to 'info' no events will be filtered.
enum: enum:
- info - info
- error - error
type: string type: string
eventSources: eventSources:
description: EventSources specifies how to filter events based on description: |-
the involved object kind, name and namespace. EventSources specifies how to filter events based
on the involved object kind, name and namespace.
items: items:
description: CrossNamespaceObjectReference contains enough information description: |-
to let you locate the typed referenced object at cluster level CrossNamespaceObjectReference contains enough information to let you locate the
typed referenced object at cluster level
properties: properties:
apiVersion: apiVersion:
description: API version of the referent description: API version of the referent
@ -288,15 +304,16 @@ spec:
matchLabels: matchLabels:
additionalProperties: additionalProperties:
type: string type: string
description: MatchLabels is a map of {key,value} pairs. A single description: |-
{key,value} in the matchLabels map is equivalent to an element MatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
of matchExpressions, whose key field is "key", the operator map is equivalent to an element of matchExpressions, whose key field is "key", the
is "In", and the values array contains only "value". The requirements operator is "In", and the values array contains only "value". The requirements are ANDed.
are ANDed. MatchLabels requires the name to be set to `*`. MatchLabels requires the name to be set to `*`.
type: object type: object
name: name:
description: Name of the referent If multiple resources are description: |-
targeted `*` may be set. Name of the referent
If multiple resources are targeted `*` may be set.
maxLength: 53 maxLength: 53
minLength: 1 minLength: 1
type: string type: string
@ -311,13 +328,15 @@ spec:
type: object type: object
type: array type: array
exclusionList: exclusionList:
description: ExclusionList specifies a list of Golang regular expressions description: |-
ExclusionList specifies a list of Golang regular expressions
to be used for excluding messages. to be used for excluding messages.
items: items:
type: string type: string
type: array type: array
inclusionList: inclusionList:
description: InclusionList specifies a list of Golang regular expressions description: |-
InclusionList specifies a list of Golang regular expressions
to be used for including messages. to be used for including messages.
items: items:
type: string type: string
@ -338,8 +357,9 @@ spec:
maxLength: 255 maxLength: 255
type: string type: string
suspend: suspend:
description: Suspend tells the controller to suspend subsequent events description: |-
handling for this Alert. Suspend tells the controller to suspend subsequent
events handling for this Alert.
type: boolean type: boolean
required: required:
- eventSources - eventSources
@ -354,42 +374,42 @@ spec:
description: Conditions holds the conditions for the Alert. description: Conditions holds the conditions for the Alert.
items: items:
description: "Condition contains details for one aspect of the current description: "Condition contains details for one aspect of the current
state of this API Resource. --- This struct is intended for direct state of this API Resource.\n---\nThis struct is intended for
use as an array at the field path .status.conditions. For example, direct use as an array at the field path .status.conditions. For
\n type FooStatus struct{ // Represents the observations of a example,\n\n\n\ttype FooStatus struct{\n\t // Represents the
foo's current state. // Known .status.conditions.type are: \"Available\", observations of a foo's current state.\n\t // Known .status.conditions.type
\"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge are: \"Available\", \"Progressing\", and \"Degraded\"\n\t //
// +listType=map // +listMapKey=type Conditions []metav1.Condition +patchMergeKey=type\n\t // +patchStrategy=merge\n\t // +listType=map\n\t
`json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\" \ // +listMapKey=type\n\t Conditions []metav1.Condition `json:\"conditions,omitempty\"
protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }" patchStrategy:\"merge\" patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"`\n\n\n\t
\ // other fields\n\t}"
properties: properties:
lastTransitionTime: lastTransitionTime:
description: lastTransitionTime is the last time the condition description: |-
transitioned from one status to another. This should be when lastTransitionTime is the last time the condition transitioned from one status to another.
the underlying condition changed. If that is not known, then This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
using the time when the API field changed is acceptable.
format: date-time format: date-time
type: string type: string
message: message:
description: message is a human readable message indicating description: |-
details about the transition. This may be an empty string. message is a human readable message indicating details about the transition.
This may be an empty string.
maxLength: 32768 maxLength: 32768
type: string type: string
observedGeneration: observedGeneration:
description: observedGeneration represents the .metadata.generation description: |-
that the condition was set based upon. For instance, if .metadata.generation observedGeneration represents the .metadata.generation that the condition was set based upon.
is currently 12, but the .status.conditions[x].observedGeneration For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
is 9, the condition is out of date with respect to the current with respect to the current state of the instance.
state of the instance.
format: int64 format: int64
minimum: 0 minimum: 0
type: integer type: integer
reason: reason:
description: reason contains a programmatic identifier indicating description: |-
the reason for the condition's last transition. Producers reason contains a programmatic identifier indicating the reason for the condition's last transition.
of specific condition types may define expected values and Producers of specific condition types may define expected values and meanings for this field,
meanings for this field, and whether the values are considered and whether the values are considered a guaranteed API.
a guaranteed API. The value should be a CamelCase string. The value should be a CamelCase string.
This field may not be empty. This field may not be empty.
maxLength: 1024 maxLength: 1024
minLength: 1 minLength: 1
@ -403,11 +423,12 @@ spec:
- Unknown - Unknown
type: string type: string
type: type:
description: type of condition in CamelCase or in foo.example.com/CamelCase. description: |-
--- Many .condition.type values are consistent across resources type of condition in CamelCase or in foo.example.com/CamelCase.
like Available, but because arbitrary conditions can be useful ---
(see .node.status.conditions), the ability to deconflict is Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be
important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt) useful (see .node.status.conditions), the ability to deconflict is important.
The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
maxLength: 316 maxLength: 316
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])$ 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])$
type: string type: string
@ -420,9 +441,10 @@ spec:
type: object type: object
type: array type: array
lastHandledReconcileAt: lastHandledReconcileAt:
description: LastHandledReconcileAt holds the value of the most recent description: |-
reconcile request value, so a change of the annotation value can LastHandledReconcileAt holds the value of the most recent
be detected. reconcile request value, so a change of the annotation value
can be detected.
type: string type: string
observedGeneration: observedGeneration:
description: ObservedGeneration is the last observed generation. description: ObservedGeneration is the last observed generation.
@ -444,14 +466,19 @@ spec:
description: Alert is the Schema for the alerts API description: Alert is the Schema for the alerts API
properties: properties:
apiVersion: apiVersion:
description: 'APIVersion defines the versioned schema of this representation description: |-
of an object. Servers should convert recognized schemas to the latest APIVersion defines the versioned schema of this representation of an object.
internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources' 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
type: string type: string
kind: kind:
description: 'Kind is a string value representing the REST resource this description: |-
object represents. Servers may infer this from the endpoint the client Kind is a string value representing the REST resource this object represents.
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds' 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
type: string type: string
metadata: metadata:
type: object type: object
@ -462,27 +489,30 @@ spec:
eventMetadata: eventMetadata:
additionalProperties: additionalProperties:
type: string type: string
description: EventMetadata is an optional field for adding metadata description: |-
to events dispatched by the controller. This can be used for enhancing EventMetadata is an optional field for adding metadata to events dispatched by the
the context of the event. If a field would override one already controller. This can be used for enhancing the context of the event. If a field
present on the original event as generated by the emitter, then would override one already present on the original event as generated by the emitter,
the override doesn't happen, i.e. the original value is preserved, then the override doesn't happen, i.e. the original value is preserved, and an info
and an info log is printed. log is printed.
type: object type: object
eventSeverity: eventSeverity:
default: info default: info
description: EventSeverity specifies how to filter events based on description: |-
severity. If set to 'info' no events will be filtered. EventSeverity specifies how to filter events based on severity.
If set to 'info' no events will be filtered.
enum: enum:
- info - info
- error - error
type: string type: string
eventSources: eventSources:
description: EventSources specifies how to filter events based on description: |-
the involved object kind, name and namespace. EventSources specifies how to filter events based
on the involved object kind, name and namespace.
items: items:
description: CrossNamespaceObjectReference contains enough information description: |-
to let you locate the typed referenced object at cluster level CrossNamespaceObjectReference contains enough information to let you locate the
typed referenced object at cluster level
properties: properties:
apiVersion: apiVersion:
description: API version of the referent description: API version of the referent
@ -504,15 +534,16 @@ spec:
matchLabels: matchLabels:
additionalProperties: additionalProperties:
type: string type: string
description: MatchLabels is a map of {key,value} pairs. A single description: |-
{key,value} in the matchLabels map is equivalent to an element MatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
of matchExpressions, whose key field is "key", the operator map is equivalent to an element of matchExpressions, whose key field is "key", the
is "In", and the values array contains only "value". The requirements operator is "In", and the values array contains only "value". The requirements are ANDed.
are ANDed. MatchLabels requires the name to be set to `*`. MatchLabels requires the name to be set to `*`.
type: object type: object
name: name:
description: Name of the referent If multiple resources are description: |-
targeted `*` may be set. Name of the referent
If multiple resources are targeted `*` may be set.
maxLength: 53 maxLength: 53
minLength: 1 minLength: 1
type: string type: string
@ -527,13 +558,15 @@ spec:
type: object type: object
type: array type: array
exclusionList: exclusionList:
description: ExclusionList specifies a list of Golang regular expressions description: |-
ExclusionList specifies a list of Golang regular expressions
to be used for excluding messages. to be used for excluding messages.
items: items:
type: string type: string
type: array type: array
inclusionList: inclusionList:
description: InclusionList specifies a list of Golang regular expressions description: |-
InclusionList specifies a list of Golang regular expressions
to be used for including messages. to be used for including messages.
items: items:
type: string type: string
@ -554,8 +587,9 @@ spec:
maxLength: 255 maxLength: 255
type: string type: string
suspend: suspend:
description: Suspend tells the controller to suspend subsequent events description: |-
handling for this Alert. Suspend tells the controller to suspend subsequent
events handling for this Alert.
type: boolean type: boolean
required: required:
- eventSources - eventSources

250
config/crd/bases/notification.toolkit.fluxcd.io_providers.yaml
View File

@ -3,7 +3,7 @@ apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition kind: CustomResourceDefinition
metadata: metadata:
annotations: annotations:
controller-gen.kubebuilder.io/version: v0.12.0 controller-gen.kubebuilder.io/version: v0.14.0
name: providers.notification.toolkit.fluxcd.io name: providers.notification.toolkit.fluxcd.io
spec: spec:
group: notification.toolkit.fluxcd.io group: notification.toolkit.fluxcd.io
@ -32,14 +32,19 @@ spec:
description: Provider is the Schema for the providers API description: Provider is the Schema for the providers API
properties: properties:
apiVersion: apiVersion:
description: 'APIVersion defines the versioned schema of this representation description: |-
of an object. Servers should convert recognized schemas to the latest APIVersion defines the versioned schema of this representation of an object.
internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources' 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
type: string type: string
kind: kind:
description: 'Kind is a string value representing the REST resource this description: |-
object represents. Servers may infer this from the endpoint the client Kind is a string value representing the REST resource this object represents.
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds' 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
type: string type: string
metadata: metadata:
type: object type: object
@ -51,7 +56,8 @@ spec:
pattern: ^(http|https):// pattern: ^(http|https)://
type: string type: string
certSecretRef: certSecretRef:
description: CertSecretRef can be given the name of a secret containing description: |-
CertSecretRef can be given the name of a secret containing
a PEM-encoded CA certificate (`caFile`) a PEM-encoded CA certificate (`caFile`)
properties: properties:
name: name:
@ -68,7 +74,8 @@ spec:
pattern: ^(http|https):// pattern: ^(http|https)://
type: string type: string
secretRef: secretRef:
description: Secret reference containing the provider webhook URL description: |-
Secret reference containing the provider webhook URL
using "address" as data key using "address" as data key
properties: properties:
name: name:
@ -78,8 +85,9 @@ spec:
- name - name
type: object type: object
suspend: suspend:
description: This flag tells the controller to suspend subsequent description: |-
events handling. Defaults to false. This flag tells the controller to suspend subsequent events handling.
Defaults to false.
type: boolean type: boolean
timeout: timeout:
description: Timeout for sending alerts to the provider. description: Timeout for sending alerts to the provider.
@ -124,42 +132,42 @@ spec:
conditions: conditions:
items: items:
description: "Condition contains details for one aspect of the current description: "Condition contains details for one aspect of the current
state of this API Resource. --- This struct is intended for direct state of this API Resource.\n---\nThis struct is intended for
use as an array at the field path .status.conditions. For example, direct use as an array at the field path .status.conditions. For
\n type FooStatus struct{ // Represents the observations of a example,\n\n\n\ttype FooStatus struct{\n\t // Represents the
foo's current state. // Known .status.conditions.type are: \"Available\", observations of a foo's current state.\n\t // Known .status.conditions.type
\"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge are: \"Available\", \"Progressing\", and \"Degraded\"\n\t //
// +listType=map // +listMapKey=type Conditions []metav1.Condition +patchMergeKey=type\n\t // +patchStrategy=merge\n\t // +listType=map\n\t
`json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\" \ // +listMapKey=type\n\t Conditions []metav1.Condition `json:\"conditions,omitempty\"
protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }" patchStrategy:\"merge\" patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"`\n\n\n\t
\ // other fields\n\t}"
properties: properties:
lastTransitionTime: lastTransitionTime:
description: lastTransitionTime is the last time the condition description: |-
transitioned from one status to another. This should be when lastTransitionTime is the last time the condition transitioned from one status to another.
the underlying condition changed. If that is not known, then This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
using the time when the API field changed is acceptable.
format: date-time format: date-time
type: string type: string
message: message:
description: message is a human readable message indicating description: |-
details about the transition. This may be an empty string. message is a human readable message indicating details about the transition.
This may be an empty string.
maxLength: 32768 maxLength: 32768
type: string type: string
observedGeneration: observedGeneration:
description: observedGeneration represents the .metadata.generation description: |-
that the condition was set based upon. For instance, if .metadata.generation observedGeneration represents the .metadata.generation that the condition was set based upon.
is currently 12, but the .status.conditions[x].observedGeneration For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
is 9, the condition is out of date with respect to the current with respect to the current state of the instance.
state of the instance.
format: int64 format: int64
minimum: 0 minimum: 0
type: integer type: integer
reason: reason:
description: reason contains a programmatic identifier indicating description: |-
the reason for the condition's last transition. Producers reason contains a programmatic identifier indicating the reason for the condition's last transition.
of specific condition types may define expected values and Producers of specific condition types may define expected values and meanings for this field,
meanings for this field, and whether the values are considered and whether the values are considered a guaranteed API.
a guaranteed API. The value should be a CamelCase string. The value should be a CamelCase string.
This field may not be empty. This field may not be empty.
maxLength: 1024 maxLength: 1024
minLength: 1 minLength: 1
@ -173,11 +181,12 @@ spec:
- Unknown - Unknown
type: string type: string
type: type:
description: type of condition in CamelCase or in foo.example.com/CamelCase. description: |-
--- Many .condition.type values are consistent across resources type of condition in CamelCase or in foo.example.com/CamelCase.
like Available, but because arbitrary conditions can be useful ---
(see .node.status.conditions), the ability to deconflict is Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be
important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt) useful (see .node.status.conditions), the ability to deconflict is important.
The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
maxLength: 316 maxLength: 316
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])$ 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])$
type: string type: string
@ -217,14 +226,19 @@ spec:
description: Provider is the Schema for the providers API. description: Provider is the Schema for the providers API.
properties: properties:
apiVersion: apiVersion:
description: 'APIVersion defines the versioned schema of this representation description: |-
of an object. Servers should convert recognized schemas to the latest APIVersion defines the versioned schema of this representation of an object.
internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources' 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
type: string type: string
kind: kind:
description: 'Kind is a string value representing the REST resource this description: |-
object represents. Servers may infer this from the endpoint the client Kind is a string value representing the REST resource this object represents.
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds' 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
type: string type: string
metadata: metadata:
type: object type: object
@ -232,17 +246,21 @@ spec:
description: ProviderSpec defines the desired state of the Provider. description: ProviderSpec defines the desired state of the Provider.
properties: properties:
address: address:
description: Address specifies the endpoint, in a generic sense, to description: |-
where alerts are sent. What kind of endpoint depends on the specific Address specifies the endpoint, in a generic sense, to where alerts are sent.
Provider type being used. For the generic Provider, for example, What kind of endpoint depends on the specific Provider type being used.
this is an HTTP/S address. For other Provider types this could be For the generic Provider, for example, this is an HTTP/S address.
a project ID or a namespace. For other Provider types this could be a project ID or a namespace.
maxLength: 2048 maxLength: 2048
type: string type: string
certSecretRef: certSecretRef:
description: "CertSecretRef specifies the Secret containing a PEM-encoded description: |-
CA certificate (in the `ca.crt` key). \n Note: Support for the `caFile` CertSecretRef specifies the Secret containing
key has been deprecated." a PEM-encoded CA certificate (in the `ca.crt` key).
Note: Support for the `caFile` key has
been deprecated.
properties: properties:
name: name:
description: Name of the referent. description: Name of the referent.
@ -266,7 +284,8 @@ spec:
pattern: ^(http|https)://.*$ pattern: ^(http|https)://.*$
type: string type: string
secretRef: secretRef:
description: SecretRef specifies the Secret containing the authentication description: |-
SecretRef specifies the Secret containing the authentication
credentials for this Provider. credentials for this Provider.
properties: properties:
name: name:
@ -276,8 +295,9 @@ spec:
- name - name
type: object type: object
suspend: suspend:
description: Suspend tells the controller to suspend subsequent events description: |-
handling for this Provider. Suspend tells the controller to suspend subsequent
events handling for this Provider.
type: boolean type: boolean
timeout: timeout:
description: Timeout for sending alerts to the Provider. description: Timeout for sending alerts to the Provider.
@ -329,42 +349,42 @@ spec:
description: Conditions holds the conditions for the Provider. description: Conditions holds the conditions for the Provider.
items: items:
description: "Condition contains details for one aspect of the current description: "Condition contains details for one aspect of the current
state of this API Resource. --- This struct is intended for direct state of this API Resource.\n---\nThis struct is intended for
use as an array at the field path .status.conditions. For example, direct use as an array at the field path .status.conditions. For
\n type FooStatus struct{ // Represents the observations of a example,\n\n\n\ttype FooStatus struct{\n\t // Represents the
foo's current state. // Known .status.conditions.type are: \"Available\", observations of a foo's current state.\n\t // Known .status.conditions.type
\"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge are: \"Available\", \"Progressing\", and \"Degraded\"\n\t //
// +listType=map // +listMapKey=type Conditions []metav1.Condition +patchMergeKey=type\n\t // +patchStrategy=merge\n\t // +listType=map\n\t
`json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\" \ // +listMapKey=type\n\t Conditions []metav1.Condition `json:\"conditions,omitempty\"
protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }" patchStrategy:\"merge\" patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"`\n\n\n\t
\ // other fields\n\t}"
properties: properties:
lastTransitionTime: lastTransitionTime:
description: lastTransitionTime is the last time the condition description: |-
transitioned from one status to another. This should be when lastTransitionTime is the last time the condition transitioned from one status to another.
the underlying condition changed. If that is not known, then This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
using the time when the API field changed is acceptable.
format: date-time format: date-time
type: string type: string
message: message:
description: message is a human readable message indicating description: |-
details about the transition. This may be an empty string. message is a human readable message indicating details about the transition.
This may be an empty string.
maxLength: 32768 maxLength: 32768
type: string type: string
observedGeneration: observedGeneration:
description: observedGeneration represents the .metadata.generation description: |-
that the condition was set based upon. For instance, if .metadata.generation observedGeneration represents the .metadata.generation that the condition was set based upon.
is currently 12, but the .status.conditions[x].observedGeneration For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
is 9, the condition is out of date with respect to the current with respect to the current state of the instance.
state of the instance.
format: int64 format: int64
minimum: 0 minimum: 0
type: integer type: integer
reason: reason:
description: reason contains a programmatic identifier indicating description: |-
the reason for the condition's last transition. Producers reason contains a programmatic identifier indicating the reason for the condition's last transition.
of specific condition types may define expected values and Producers of specific condition types may define expected values and meanings for this field,
meanings for this field, and whether the values are considered and whether the values are considered a guaranteed API.
a guaranteed API. The value should be a CamelCase string. The value should be a CamelCase string.
This field may not be empty. This field may not be empty.
maxLength: 1024 maxLength: 1024
minLength: 1 minLength: 1
@ -378,11 +398,12 @@ spec:
- Unknown - Unknown
type: string type: string
type: type:
description: type of condition in CamelCase or in foo.example.com/CamelCase. description: |-
--- Many .condition.type values are consistent across resources type of condition in CamelCase or in foo.example.com/CamelCase.
like Available, but because arbitrary conditions can be useful ---
(see .node.status.conditions), the ability to deconflict is Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be
important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt) useful (see .node.status.conditions), the ability to deconflict is important.
The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
maxLength: 316 maxLength: 316
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])$ 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])$
type: string type: string
@ -395,9 +416,10 @@ spec:
type: object type: object
type: array type: array
lastHandledReconcileAt: lastHandledReconcileAt:
description: LastHandledReconcileAt holds the value of the most recent description: |-
reconcile request value, so a change of the annotation value can LastHandledReconcileAt holds the value of the most recent
be detected. reconcile request value, so a change of the annotation value
can be detected.
type: string type: string
observedGeneration: observedGeneration:
description: ObservedGeneration is the last reconciled generation. description: ObservedGeneration is the last reconciled generation.
@ -419,14 +441,19 @@ spec:
description: Provider is the Schema for the providers API description: Provider is the Schema for the providers API
properties: properties:
apiVersion: apiVersion:
description: 'APIVersion defines the versioned schema of this representation description: |-
of an object. Servers should convert recognized schemas to the latest APIVersion defines the versioned schema of this representation of an object.
internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources' 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
type: string type: string
kind: kind:
description: 'Kind is a string value representing the REST resource this description: |-
object represents. Servers may infer this from the endpoint the client Kind is a string value representing the REST resource this object represents.
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds' 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
type: string type: string
metadata: metadata:
type: object type: object
@ -434,17 +461,21 @@ spec:
description: ProviderSpec defines the desired state of the Provider. description: ProviderSpec defines the desired state of the Provider.
properties: properties:
address: address:
description: Address specifies the endpoint, in a generic sense, to description: |-
where alerts are sent. What kind of endpoint depends on the specific Address specifies the endpoint, in a generic sense, to where alerts are sent.
Provider type being used. For the generic Provider, for example, What kind of endpoint depends on the specific Provider type being used.
this is an HTTP/S address. For other Provider types this could be For the generic Provider, for example, this is an HTTP/S address.
a project ID or a namespace. For other Provider types this could be a project ID or a namespace.
maxLength: 2048 maxLength: 2048
type: string type: string
certSecretRef: certSecretRef:
description: "CertSecretRef specifies the Secret containing a PEM-encoded description: |-
CA certificate (in the `ca.crt` key). \n Note: Support for the `caFile` CertSecretRef specifies the Secret containing
key has been deprecated." a PEM-encoded CA certificate (in the `ca.crt` key).
Note: Support for the `caFile` key has
been deprecated.
properties: properties:
name: name:
description: Name of the referent. description: Name of the referent.
@ -458,8 +489,9 @@ spec:
maxLength: 2048 maxLength: 2048
type: string type: string
interval: interval:
description: Interval at which to reconcile the Provider with its description: |-
Secret references. Deprecated and not used in v1beta3. Interval at which to reconcile the Provider with its Secret references.
Deprecated and not used in v1beta3.
pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
type: string type: string
proxy: proxy:
@ -468,7 +500,8 @@ spec:
pattern: ^(http|https)://.*$ pattern: ^(http|https)://.*$
type: string type: string
secretRef: secretRef:
description: SecretRef specifies the Secret containing the authentication description: |-
SecretRef specifies the Secret containing the authentication
credentials for this Provider. credentials for this Provider.
properties: properties:
name: name:
@ -478,8 +511,9 @@ spec:
- name - name
type: object type: object
suspend: suspend:
description: Suspend tells the controller to suspend subsequent events description: |-
handling for this Provider. Suspend tells the controller to suspend subsequent
events handling for this Provider.
type: boolean type: boolean
timeout: timeout:
description: Timeout for sending alerts to the Provider. description: Timeout for sending alerts to the Provider.

375
config/crd/bases/notification.toolkit.fluxcd.io_receivers.yaml
View File

@ -3,7 +3,7 @@ apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition kind: CustomResourceDefinition
metadata: metadata:
annotations: annotations:
controller-gen.kubebuilder.io/version: v0.12.0 controller-gen.kubebuilder.io/version: v0.14.0
name: receivers.notification.toolkit.fluxcd.io name: receivers.notification.toolkit.fluxcd.io
spec: spec:
group: notification.toolkit.fluxcd.io group: notification.toolkit.fluxcd.io
@ -30,14 +30,19 @@ spec:
description: Receiver is the Schema for the receivers API. description: Receiver is the Schema for the receivers API.
properties: properties:
apiVersion: apiVersion:
description: 'APIVersion defines the versioned schema of this representation description: |-
of an object. Servers should convert recognized schemas to the latest APIVersion defines the versioned schema of this representation of an object.
internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources' 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
type: string type: string
kind: kind:
description: 'Kind is a string value representing the REST resource this description: |-
object represents. Servers may infer this from the endpoint the client Kind is a string value representing the REST resource this object represents.
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds' 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
type: string type: string
metadata: metadata:
type: object type: object
@ -45,8 +50,9 @@ spec:
description: ReceiverSpec defines the desired state of the Receiver. description: ReceiverSpec defines the desired state of the Receiver.
properties: properties:
events: events:
description: Events specifies the list of event types to handle, e.g. description: |-
'push' for GitHub or 'Push Hook' for GitLab. Events specifies the list of event types to handle,
e.g. 'push' for GitHub or 'Push Hook' for GitLab.
items: items:
type: string type: string
type: array type: array
@ -59,8 +65,9 @@ spec:
resources: resources:
description: A list of resources to be notified about changes. description: A list of resources to be notified about changes.
items: items:
description: CrossNamespaceObjectReference contains enough information description: |-
to let you locate the typed referenced object at cluster level CrossNamespaceObjectReference contains enough information to let you locate the
typed referenced object at cluster level
properties: properties:
apiVersion: apiVersion:
description: API version of the referent description: API version of the referent
@ -82,15 +89,16 @@ spec:
matchLabels: matchLabels:
additionalProperties: additionalProperties:
type: string type: string
description: MatchLabels is a map of {key,value} pairs. A single description: |-
{key,value} in the matchLabels map is equivalent to an element MatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
of matchExpressions, whose key field is "key", the operator map is equivalent to an element of matchExpressions, whose key field is "key", the
is "In", and the values array contains only "value". The requirements operator is "In", and the values array contains only "value". The requirements are ANDed.
are ANDed. MatchLabels requires the name to be set to `*`. MatchLabels requires the name to be set to `*`.
type: object type: object
name: name:
description: Name of the referent If multiple resources are description: |-
targeted `*` may be set. Name of the referent
If multiple resources are targeted `*` may be set.
maxLength: 53 maxLength: 53
minLength: 1 minLength: 1
type: string type: string
@ -105,7 +113,8 @@ spec:
type: object type: object
type: array type: array
secretRef: secretRef:
description: SecretRef specifies the Secret containing the token used description: |-
SecretRef specifies the Secret containing the token used
to validate the payload authenticity. to validate the payload authenticity.
properties: properties:
name: name:
@ -115,12 +124,14 @@ spec:
- name - name
type: object type: object
suspend: suspend:
description: Suspend tells the controller to suspend subsequent events description: |-
handling for this receiver. Suspend tells the controller to suspend subsequent
events handling for this receiver.
type: boolean type: boolean
type: type:
description: Type of webhook sender, used to determine the validation description: |-
procedure and payload deserialization. Type of webhook sender, used to determine
the validation procedure and payload deserialization.
enum: enum:
- generic - generic
- generic-hmac - generic-hmac
@ -148,42 +159,42 @@ spec:
description: Conditions holds the conditions for the Receiver. description: Conditions holds the conditions for the Receiver.
items: items:
description: "Condition contains details for one aspect of the current description: "Condition contains details for one aspect of the current
state of this API Resource. --- This struct is intended for direct state of this API Resource.\n---\nThis struct is intended for
use as an array at the field path .status.conditions. For example, direct use as an array at the field path .status.conditions. For
\n type FooStatus struct{ // Represents the observations of a example,\n\n\n\ttype FooStatus struct{\n\t // Represents the
foo's current state. // Known .status.conditions.type are: \"Available\", observations of a foo's current state.\n\t // Known .status.conditions.type
\"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge are: \"Available\", \"Progressing\", and \"Degraded\"\n\t //
// +listType=map // +listMapKey=type Conditions []metav1.Condition +patchMergeKey=type\n\t // +patchStrategy=merge\n\t // +listType=map\n\t
`json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\" \ // +listMapKey=type\n\t Conditions []metav1.Condition `json:\"conditions,omitempty\"
protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }" patchStrategy:\"merge\" patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"`\n\n\n\t
\ // other fields\n\t}"
properties: properties:
lastTransitionTime: lastTransitionTime:
description: lastTransitionTime is the last time the condition description: |-
transitioned from one status to another. This should be when lastTransitionTime is the last time the condition transitioned from one status to another.
the underlying condition changed. If that is not known, then This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
using the time when the API field changed is acceptable.
format: date-time format: date-time
type: string type: string
message: message:
description: message is a human readable message indicating description: |-
details about the transition. This may be an empty string. message is a human readable message indicating details about the transition.
This may be an empty string.
maxLength: 32768 maxLength: 32768
type: string type: string
observedGeneration: observedGeneration:
description: observedGeneration represents the .metadata.generation description: |-
that the condition was set based upon. For instance, if .metadata.generation observedGeneration represents the .metadata.generation that the condition was set based upon.
is currently 12, but the .status.conditions[x].observedGeneration For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
is 9, the condition is out of date with respect to the current with respect to the current state of the instance.
state of the instance.
format: int64 format: int64
minimum: 0 minimum: 0
type: integer type: integer
reason: reason:
description: reason contains a programmatic identifier indicating description: |-
the reason for the condition's last transition. Producers reason contains a programmatic identifier indicating the reason for the condition's last transition.
of specific condition types may define expected values and Producers of specific condition types may define expected values and meanings for this field,
meanings for this field, and whether the values are considered and whether the values are considered a guaranteed API.
a guaranteed API. The value should be a CamelCase string. The value should be a CamelCase string.
This field may not be empty. This field may not be empty.
maxLength: 1024 maxLength: 1024
minLength: 1 minLength: 1
@ -197,11 +208,12 @@ spec:
- Unknown - Unknown
type: string type: string
type: type:
description: type of condition in CamelCase or in foo.example.com/CamelCase. description: |-
--- Many .condition.type values are consistent across resources type of condition in CamelCase or in foo.example.com/CamelCase.
like Available, but because arbitrary conditions can be useful ---
(see .node.status.conditions), the ability to deconflict is Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be
important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt) useful (see .node.status.conditions), the ability to deconflict is important.
The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
maxLength: 316 maxLength: 316
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])$ 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])$
type: string type: string
@ -214,9 +226,10 @@ spec:
type: object type: object
type: array type: array
lastHandledReconcileAt: lastHandledReconcileAt:
description: LastHandledReconcileAt holds the value of the most recent description: |-
reconcile request value, so a change of the annotation value can LastHandledReconcileAt holds the value of the most recent
be detected. reconcile request value, so a change of the annotation value
can be detected.
type: string type: string
observedGeneration: observedGeneration:
description: ObservedGeneration is the last observed generation of description: ObservedGeneration is the last observed generation of
@ -224,8 +237,9 @@ spec:
format: int64 format: int64
type: integer type: integer
webhookPath: webhookPath:
description: WebhookPath is the generated incoming webhook address description: |-
in the format of '/hook/sha256sum(token+name+namespace)'. WebhookPath is the generated incoming webhook address in the format
of '/hook/sha256sum(token+name+namespace)'.
type: string type: string
type: object type: object
type: object type: object
@ -251,14 +265,19 @@ spec:
description: Receiver is the Schema for the receivers API description: Receiver is the Schema for the receivers API
properties: properties:
apiVersion: apiVersion:
description: 'APIVersion defines the versioned schema of this representation description: |-
of an object. Servers should convert recognized schemas to the latest APIVersion defines the versioned schema of this representation of an object.
internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources' 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
type: string type: string
kind: kind:
description: 'Kind is a string value representing the REST resource this description: |-
object represents. Servers may infer this from the endpoint the client Kind is a string value representing the REST resource this object represents.
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds' 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
type: string type: string
metadata: metadata:
type: object type: object
@ -266,16 +285,18 @@ spec:
description: ReceiverSpec defines the desired state of Receiver description: ReceiverSpec defines the desired state of Receiver
properties: properties:
events: events:
description: A list of events to handle, e.g. 'push' for GitHub or description: |-
'Push Hook' for GitLab. A list of events to handle,
e.g. 'push' for GitHub or 'Push Hook' for GitLab.
items: items:
type: string type: string
type: array type: array
resources: resources:
description: A list of resources to be notified about changes. description: A list of resources to be notified about changes.
items: items:
description: CrossNamespaceObjectReference contains enough information description: |-
to let you locate the typed referenced object at cluster level CrossNamespaceObjectReference contains enough information to let you locate the
typed referenced object at cluster level
properties: properties:
apiVersion: apiVersion:
description: API version of the referent description: API version of the referent
@ -297,11 +318,10 @@ spec:
matchLabels: matchLabels:
additionalProperties: additionalProperties:
type: string type: string
description: MatchLabels is a map of {key,value} pairs. A single description: |-
{key,value} in the matchLabels map is equivalent to an element MatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
of matchExpressions, whose key field is "key", the operator map is equivalent to an element of matchExpressions, whose key field is "key", the
is "In", and the values array contains only "value". The requirements operator is "In", and the values array contains only "value". The requirements are ANDed.
are ANDed.
type: object type: object
name: name:
description: Name of the referent description: Name of the referent
@ -318,8 +338,9 @@ spec:
type: object type: object
type: array type: array
secretRef: secretRef:
description: Secret reference containing the token used to validate description: |-
the payload authenticity Secret reference containing the token used
to validate the payload authenticity
properties: properties:
name: name:
description: Name of the referent. description: Name of the referent.
@ -328,12 +349,14 @@ spec:
- name - name
type: object type: object
suspend: suspend:
description: This flag tells the controller to suspend subsequent description: |-
events handling. Defaults to false. This flag tells the controller to suspend subsequent events handling.
Defaults to false.
type: boolean type: boolean
type: type:
description: Type of webhook sender, used to determine the validation description: |-
procedure and payload deserialization. Type of webhook sender, used to determine
the validation procedure and payload deserialization.
enum: enum:
- generic - generic
- generic-hmac - generic-hmac
@ -359,42 +382,42 @@ spec:
conditions: conditions:
items: items:
description: "Condition contains details for one aspect of the current description: "Condition contains details for one aspect of the current
state of this API Resource. --- This struct is intended for direct state of this API Resource.\n---\nThis struct is intended for
use as an array at the field path .status.conditions. For example, direct use as an array at the field path .status.conditions. For
\n type FooStatus struct{ // Represents the observations of a example,\n\n\n\ttype FooStatus struct{\n\t // Represents the
foo's current state. // Known .status.conditions.type are: \"Available\", observations of a foo's current state.\n\t // Known .status.conditions.type
\"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge are: \"Available\", \"Progressing\", and \"Degraded\"\n\t //
// +listType=map // +listMapKey=type Conditions []metav1.Condition +patchMergeKey=type\n\t // +patchStrategy=merge\n\t // +listType=map\n\t
`json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\" \ // +listMapKey=type\n\t Conditions []metav1.Condition `json:\"conditions,omitempty\"
protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }" patchStrategy:\"merge\" patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"`\n\n\n\t
\ // other fields\n\t}"
properties: properties:
lastTransitionTime: lastTransitionTime:
description: lastTransitionTime is the last time the condition description: |-
transitioned from one status to another. This should be when lastTransitionTime is the last time the condition transitioned from one status to another.
the underlying condition changed. If that is not known, then This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
using the time when the API field changed is acceptable.
format: date-time format: date-time
type: string type: string
message: message:
description: message is a human readable message indicating description: |-
details about the transition. This may be an empty string. message is a human readable message indicating details about the transition.
This may be an empty string.
maxLength: 32768 maxLength: 32768
type: string type: string
observedGeneration: observedGeneration:
description: observedGeneration represents the .metadata.generation description: |-
that the condition was set based upon. For instance, if .metadata.generation observedGeneration represents the .metadata.generation that the condition was set based upon.
is currently 12, but the .status.conditions[x].observedGeneration For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
is 9, the condition is out of date with respect to the current with respect to the current state of the instance.
state of the instance.
format: int64 format: int64
minimum: 0 minimum: 0
type: integer type: integer
reason: reason:
description: reason contains a programmatic identifier indicating description: |-
the reason for the condition's last transition. Producers reason contains a programmatic identifier indicating the reason for the condition's last transition.
of specific condition types may define expected values and Producers of specific condition types may define expected values and meanings for this field,
meanings for this field, and whether the values are considered and whether the values are considered a guaranteed API.
a guaranteed API. The value should be a CamelCase string. The value should be a CamelCase string.
This field may not be empty. This field may not be empty.
maxLength: 1024 maxLength: 1024
minLength: 1 minLength: 1
@ -408,11 +431,12 @@ spec:
- Unknown - Unknown
type: string type: string
type: type:
description: type of condition in CamelCase or in foo.example.com/CamelCase. description: |-
--- Many .condition.type values are consistent across resources type of condition in CamelCase or in foo.example.com/CamelCase.
like Available, but because arbitrary conditions can be useful ---
(see .node.status.conditions), the ability to deconflict is Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be
important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt) useful (see .node.status.conditions), the ability to deconflict is important.
The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
maxLength: 316 maxLength: 316
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])$ 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])$
type: string type: string
@ -429,7 +453,9 @@ spec:
format: int64 format: int64
type: integer type: integer
url: url:
description: Generated webhook URL in the format of '/hook/sha256sum(token+name+namespace)'. description: |-
Generated webhook URL in the format
of '/hook/sha256sum(token+name+namespace)'.
type: string type: string
type: object type: object
type: object type: object
@ -455,14 +481,19 @@ spec:
description: Receiver is the Schema for the receivers API. description: Receiver is the Schema for the receivers API.
properties: properties:
apiVersion: apiVersion:
description: 'APIVersion defines the versioned schema of this representation description: |-
of an object. Servers should convert recognized schemas to the latest APIVersion defines the versioned schema of this representation of an object.
internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources' 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
type: string type: string
kind: kind:
description: 'Kind is a string value representing the REST resource this description: |-
object represents. Servers may infer this from the endpoint the client Kind is a string value representing the REST resource this object represents.
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds' 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
type: string type: string
metadata: metadata:
type: object type: object
@ -470,8 +501,9 @@ spec:
description: ReceiverSpec defines the desired state of the Receiver. description: ReceiverSpec defines the desired state of the Receiver.
properties: properties:
events: events:
description: Events specifies the list of event types to handle, e.g. description: |-
'push' for GitHub or 'Push Hook' for GitLab. Events specifies the list of event types to handle,
e.g. 'push' for GitHub or 'Push Hook' for GitLab.
items: items:
type: string type: string
type: array type: array
@ -483,8 +515,9 @@ spec:
resources: resources:
description: A list of resources to be notified about changes. description: A list of resources to be notified about changes.
items: items:
description: CrossNamespaceObjectReference contains enough information description: |-
to let you locate the typed referenced object at cluster level CrossNamespaceObjectReference contains enough information to let you locate the
typed referenced object at cluster level
properties: properties:
apiVersion: apiVersion:
description: API version of the referent description: API version of the referent
@ -506,15 +539,16 @@ spec:
matchLabels: matchLabels:
additionalProperties: additionalProperties:
type: string type: string
description: MatchLabels is a map of {key,value} pairs. A single description: |-
{key,value} in the matchLabels map is equivalent to an element MatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
of matchExpressions, whose key field is "key", the operator map is equivalent to an element of matchExpressions, whose key field is "key", the
is "In", and the values array contains only "value". The requirements operator is "In", and the values array contains only "value". The requirements are ANDed.
are ANDed. MatchLabels requires the name to be set to `*`. MatchLabels requires the name to be set to `*`.
type: object type: object
name: name:
description: Name of the referent If multiple resources are description: |-
targeted `*` may be set. Name of the referent
If multiple resources are targeted `*` may be set.
maxLength: 53 maxLength: 53
minLength: 1 minLength: 1
type: string type: string
@ -529,7 +563,8 @@ spec:
type: object type: object
type: array type: array
secretRef: secretRef:
description: SecretRef specifies the Secret containing the token used description: |-
SecretRef specifies the Secret containing the token used
to validate the payload authenticity. to validate the payload authenticity.
properties: properties:
name: name:
@ -539,12 +574,14 @@ spec:
- name - name
type: object type: object
suspend: suspend:
description: Suspend tells the controller to suspend subsequent events description: |-
handling for this receiver. Suspend tells the controller to suspend subsequent
events handling for this receiver.
type: boolean type: boolean
type: type:
description: Type of webhook sender, used to determine the validation description: |-
procedure and payload deserialization. Type of webhook sender, used to determine
the validation procedure and payload deserialization.
enum: enum:
- generic - generic
- generic-hmac - generic-hmac
@ -571,42 +608,42 @@ spec:
description: Conditions holds the conditions for the Receiver. description: Conditions holds the conditions for the Receiver.
items: items:
description: "Condition contains details for one aspect of the current description: "Condition contains details for one aspect of the current
state of this API Resource. --- This struct is intended for direct state of this API Resource.\n---\nThis struct is intended for
use as an array at the field path .status.conditions. For example, direct use as an array at the field path .status.conditions. For
\n type FooStatus struct{ // Represents the observations of a example,\n\n\n\ttype FooStatus struct{\n\t // Represents the
foo's current state. // Known .status.conditions.type are: \"Available\", observations of a foo's current state.\n\t // Known .status.conditions.type
\"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge are: \"Available\", \"Progressing\", and \"Degraded\"\n\t //
// +listType=map // +listMapKey=type Conditions []metav1.Condition +patchMergeKey=type\n\t // +patchStrategy=merge\n\t // +listType=map\n\t
`json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\" \ // +listMapKey=type\n\t Conditions []metav1.Condition `json:\"conditions,omitempty\"
protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }" patchStrategy:\"merge\" patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"`\n\n\n\t
\ // other fields\n\t}"
properties: properties:
lastTransitionTime: lastTransitionTime:
description: lastTransitionTime is the last time the condition description: |-
transitioned from one status to another. This should be when lastTransitionTime is the last time the condition transitioned from one status to another.
the underlying condition changed. If that is not known, then This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
using the time when the API field changed is acceptable.
format: date-time format: date-time
type: string type: string
message: message:
description: message is a human readable message indicating description: |-
details about the transition. This may be an empty string. message is a human readable message indicating details about the transition.
This may be an empty string.
maxLength: 32768 maxLength: 32768
type: string type: string
observedGeneration: observedGeneration:
description: observedGeneration represents the .metadata.generation description: |-
that the condition was set based upon. For instance, if .metadata.generation observedGeneration represents the .metadata.generation that the condition was set based upon.
is currently 12, but the .status.conditions[x].observedGeneration For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
is 9, the condition is out of date with respect to the current with respect to the current state of the instance.
state of the instance.
format: int64 format: int64
minimum: 0 minimum: 0
type: integer type: integer
reason: reason:
description: reason contains a programmatic identifier indicating description: |-
the reason for the condition's last transition. Producers reason contains a programmatic identifier indicating the reason for the condition's last transition.
of specific condition types may define expected values and Producers of specific condition types may define expected values and meanings for this field,
meanings for this field, and whether the values are considered and whether the values are considered a guaranteed API.
a guaranteed API. The value should be a CamelCase string. The value should be a CamelCase string.
This field may not be empty. This field may not be empty.
maxLength: 1024 maxLength: 1024
minLength: 1 minLength: 1
@ -620,11 +657,12 @@ spec:
- Unknown - Unknown
type: string type: string
type: type:
description: type of condition in CamelCase or in foo.example.com/CamelCase. description: |-
--- Many .condition.type values are consistent across resources type of condition in CamelCase or in foo.example.com/CamelCase.
like Available, but because arbitrary conditions can be useful ---
(see .node.status.conditions), the ability to deconflict is Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be
important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt) useful (see .node.status.conditions), the ability to deconflict is important.
The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
maxLength: 316 maxLength: 316
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])$ 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])$
type: string type: string
@ -637,9 +675,10 @@ spec:
type: object type: object
type: array type: array
lastHandledReconcileAt: lastHandledReconcileAt:
description: LastHandledReconcileAt holds the value of the most recent description: |-
reconcile request value, so a change of the annotation value can LastHandledReconcileAt holds the value of the most recent
be detected. reconcile request value, so a change of the annotation value
can be detected.
type: string type: string
observedGeneration: observedGeneration:
description: ObservedGeneration is the last observed generation of description: ObservedGeneration is the last observed generation of
@ -647,13 +686,15 @@ spec:
format: int64 format: int64
type: integer type: integer
url: url:
description: 'URL is the generated incoming webhook address in the description: |-
format of ''/hook/sha256sum(token+name+namespace)''. Deprecated: URL is the generated incoming webhook address in the format
Replaced by WebhookPath.' of '/hook/sha256sum(token+name+namespace)'.
Deprecated: Replaced by WebhookPath.
type: string type: string
webhookPath: webhookPath:
description: WebhookPath is the generated incoming webhook address description: |-
in the format of '/hook/sha256sum(token+name+namespace)'. WebhookPath is the generated incoming webhook address in the format
of '/hook/sha256sum(token+name+namespace)'.
type: string type: string
type: object type: object
type: object type: object