/
trigger_types.go
151 lines (126 loc) · 5.48 KB
/
trigger_types.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
/*
* Copyright 2019 The Knative Authors
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package v1alpha1
import (
metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
"k8s.io/apimachinery/pkg/runtime"
"k8s.io/apimachinery/pkg/runtime/schema"
"knative.dev/pkg/apis"
duckv1 "knative.dev/pkg/apis/duck/v1"
"knative.dev/pkg/kmeta"
)
const (
// DependencyAnnotation is the annotation key used to mark the sources that the Trigger depends on.
// This will be used when the kn client creates an importer and trigger pair for the user such that the trigger only receives events produced by the paired importer.
DependencyAnnotation = "knative.dev/dependency"
// InjectionAnnotation is the annotation key used to enable knative eventing injection for a namespace and automatically create a default broker.
// This will be used when the client creates a trigger paired with default broker and the default broker doesn't exist in the namespace
InjectionAnnotation = "knative-eventing-injection"
)
// +genclient
// +genreconciler
// +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object
// Trigger represents a request to have events delivered to a consumer from a
// Broker's event pool.
type Trigger struct {
metav1.TypeMeta `json:",inline"`
// +optional
metav1.ObjectMeta `json:"metadata,omitempty"`
// Spec defines the desired state of the Trigger.
Spec TriggerSpec `json:"spec,omitempty"`
// Status represents the current state of the Trigger. This data may be out of
// date.
// +optional
Status TriggerStatus `json:"status,omitempty"`
}
var (
// Check that Trigger can be validated, can be defaulted, and has immutable fields.
_ apis.Validatable = (*Trigger)(nil)
_ apis.Defaultable = (*Trigger)(nil)
// Check that Trigger can return its spec untyped.
_ apis.HasSpec = (*Trigger)(nil)
// Check that Service can be converted to higher versions.
_ apis.Convertible = (*Trigger)(nil)
_ runtime.Object = (*Trigger)(nil)
// Check that we can create OwnerReferences to a Trigger.
_ kmeta.OwnerRefable = (*Trigger)(nil)
)
type TriggerSpec struct {
// Broker is the broker that this trigger receives events from. If not specified, will default
// to 'default'.
Broker string `json:"broker,omitempty"`
// Filter is the filter to apply against all events from the Broker. Only events that pass this
// filter will be sent to the Subscriber. If not specified, will default to allowing all events.
//
// +optional
Filter *TriggerFilter `json:"filter,omitempty"`
// Subscriber is the addressable that receives events from the Broker that pass the Filter. It
// is required.
Subscriber duckv1.Destination `json:"subscriber"`
}
type TriggerFilter struct {
// DeprecatedSourceAndType filters events based on exact matches on the
// CloudEvents type and source attributes. This field has been replaced by the
// Attributes field.
//
// +optional
DeprecatedSourceAndType *TriggerFilterSourceAndType `json:"sourceAndType,omitempty"`
// Attributes filters events by exact match on event context attributes.
// Each key in the map is compared with the equivalent key in the event
// context. An event passes the filter if all values are equal to the
// specified values.
//
// Nested context attributes are not supported as keys. Only string values are supported.
//
// +optional
Attributes *TriggerFilterAttributes `json:"attributes,omitempty"`
}
// TriggerFilterSourceAndType filters events based on exact matches on the cloud event's type and
// source attributes. Only exact matches will pass the filter. Either or both type and source can
// use the value '' to indicate all strings match.
type TriggerFilterSourceAndType struct {
Type string `json:"type,omitempty"`
Source string `json:"source,omitempty"`
}
// TriggerFilterAttributes is a map of context attribute names to values for
// filtering by equality. Only exact matches will pass the filter. You can use the value ''
// to indicate all strings match.
type TriggerFilterAttributes map[string]string
// TriggerStatus represents the current state of a Trigger.
type TriggerStatus struct {
// inherits duck/v1 Status, which currently provides:
// * ObservedGeneration - the 'Generation' of the Service that was last processed by the controller.
// * Conditions - the latest available observations of a resource's current state.
duckv1.Status `json:",inline"`
// SubscriberURI is the resolved URI of the receiver for this Trigger.
SubscriberURI *apis.URL `json:"subscriberURI,omitempty"`
}
// +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object
// TriggerList is a collection of Triggers.
type TriggerList struct {
metav1.TypeMeta `json:",inline"`
// +optional
metav1.ListMeta `json:"metadata,omitempty"`
Items []Trigger `json:"items"`
}
// GetGroupVersionKind returns GroupVersionKind for Triggers
func (t *Trigger) GetGroupVersionKind() schema.GroupVersionKind {
return SchemeGroupVersion.WithKind("Trigger")
}
// GetUntypedSpec returns the spec of the Trigger.
func (t *Trigger) GetUntypedSpec() interface{} {
return t.Spec
}