You are viewing documentation for Flux version: 2.0
Version 2.0 of the documentation is no longer actively maintained. The site that you are currently viewing is an archived snapshot. For up-to-date documentation, see the latest version.
Notification API reference v1beta2
Packages:
notification.toolkit.fluxcd.io/v1beta2
Package v1beta2 contains API Schema definitions for the notification v1beta2 API group.
Resource Types:Alert
Alert is the Schema for the alerts API
| Field | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersionstring | notification.toolkit.fluxcd.io/v1beta2 | ||||||||||||||||
kindstring | Alert | ||||||||||||||||
metadataKubernetes meta/v1.ObjectMeta | Refer to the Kubernetes API documentation for the fields of the
metadata field. | ||||||||||||||||
specAlertSpec |
| ||||||||||||||||
statusAlertStatus |
Provider
Provider is the Schema for the providers API.
| Field | Description | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersionstring | notification.toolkit.fluxcd.io/v1beta2 | ||||||||||||||||||||
kindstring | Provider | ||||||||||||||||||||
metadataKubernetes meta/v1.ObjectMeta | Refer to the Kubernetes API documentation for the fields of the
metadata field. | ||||||||||||||||||||
specProviderSpec |
| ||||||||||||||||||||
statusProviderStatus |
Receiver
Receiver is the Schema for the receivers API.
| Field | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersionstring | notification.toolkit.fluxcd.io/v1beta2 | ||||||||||||
kindstring | Receiver | ||||||||||||
metadataKubernetes meta/v1.ObjectMeta | Refer to the Kubernetes API documentation for the fields of the
metadata field. | ||||||||||||
specReceiverSpec |
| ||||||||||||
statusReceiverStatus |
AlertSpec
(Appears on: Alert)
AlertSpec defines an alerting rule for events involving a list of objects.
| Field | Description |
|---|---|
providerRefgithub.com/fluxcd/pkg/apis/meta.LocalObjectReference | ProviderRef specifies which Provider this Alert should use. |
eventSeveritystring | (Optional) EventSeverity specifies how to filter events based on severity. If set to ‘info’ no events will be filtered. |
eventSources[]github.com/fluxcd/notification-controller/api/v1.CrossNamespaceObjectReference | EventSources specifies how to filter events based on the involved object kind, name and namespace. |
inclusionList[]string | (Optional) InclusionList specifies a list of Golang regular expressions to be used for including messages. |
eventMetadatamap[string]string | (Optional) EventMetadata is an optional field for adding metadata to events dispatched by the controller. This can be used for enhancing the context of the event. If a field would override one already present on the original event as generated by the emitter, then the override doesn’t happen, i.e. the original value is preserved, and an info log is printed. |
exclusionList[]string | (Optional) ExclusionList specifies a list of Golang regular expressions to be used for excluding messages. |
summarystring | (Optional) Summary holds a short description of the impact and affected cluster. |
suspendbool | (Optional) Suspend tells the controller to suspend subsequent events handling for this Alert. |
AlertStatus
(Appears on: Alert)
AlertStatus defines the observed state of the Alert.
| Field | Description |
|---|---|
ReconcileRequestStatusgithub.com/fluxcd/pkg/apis/meta.ReconcileRequestStatus | (Members of |
conditions[]Kubernetes meta/v1.Condition | (Optional) Conditions holds the conditions for the Alert. |
observedGenerationint64 | (Optional) ObservedGeneration is the last observed generation. |
CrossNamespaceObjectReference
CrossNamespaceObjectReference contains enough information to let you locate the typed referenced object at cluster level
| Field | Description |
|---|---|
apiVersionstring | (Optional) API version of the referent. |
kindstring | Kind of the referent. |
namestring | Name of the referent. |
namespacestring | (Optional) Namespace of the referent. |
matchLabelsmap[string]string | (Optional) MatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is “key”, the operator is “In”, and the values array contains only “value”. The requirements are ANDed. |
ProviderSpec
(Appears on: Provider)
ProviderSpec defines the desired state of the Provider.
| Field | Description |
|---|---|
typestring | Type specifies which Provider implementation to use. |
intervalKubernetes meta/v1.Duration | (Optional) Interval at which to reconcile the Provider with its Secret references. |
channelstring | (Optional) Channel specifies the destination channel where events should be posted. |
usernamestring | (Optional) Username specifies the name under which events are posted. |
addressstring | (Optional) Address specifies the endpoint, in a generic sense, to where alerts are sent. What kind of endpoint depends on the specific Provider type being used. For the generic Provider, for example, this is an HTTP/S address. For other Provider types this could be a project ID or a namespace. |
timeoutKubernetes meta/v1.Duration | (Optional) Timeout for sending alerts to the Provider. |
proxystring | (Optional) Proxy the HTTP/S address of the proxy server. |
secretRefgithub.com/fluxcd/pkg/apis/meta.LocalObjectReference | (Optional) SecretRef specifies the Secret containing the authentication credentials for this Provider. |
certSecretRefgithub.com/fluxcd/pkg/apis/meta.LocalObjectReference | (Optional) CertSecretRef specifies the Secret containing
a PEM-encoded CA certificate ( |
suspendbool | (Optional) Suspend tells the controller to suspend subsequent events handling for this Provider. |
ProviderStatus
(Appears on: Provider)
ProviderStatus defines the observed state of the Provider.
| Field | Description |
|---|---|
ReconcileRequestStatusgithub.com/fluxcd/pkg/apis/meta.ReconcileRequestStatus | (Members of |
conditions[]Kubernetes meta/v1.Condition | (Optional) Conditions holds the conditions for the Provider. |
observedGenerationint64 | (Optional) ObservedGeneration is the last reconciled generation. |
ReceiverSpec
(Appears on: Receiver)
ReceiverSpec defines the desired state of the Receiver.
| Field | Description |
|---|---|
typestring | Type of webhook sender, used to determine the validation procedure and payload deserialization. |
intervalKubernetes meta/v1.Duration | (Optional) Interval at which to reconcile the Receiver with its Secret references. |
events[]string | (Optional) Events specifies the list of event types to handle, e.g. ‘push’ for GitHub or ‘Push Hook’ for GitLab. |
resources[]github.com/fluxcd/notification-controller/api/v1.CrossNamespaceObjectReference | A list of resources to be notified about changes. |
secretRefgithub.com/fluxcd/pkg/apis/meta.LocalObjectReference | SecretRef specifies the Secret containing the token used to validate the payload authenticity. |
suspendbool | (Optional) Suspend tells the controller to suspend subsequent events handling for this receiver. |
ReceiverStatus
(Appears on: Receiver)
ReceiverStatus defines the observed state of the Receiver.
| Field | Description |
|---|---|
ReconcileRequestStatusgithub.com/fluxcd/pkg/apis/meta.ReconcileRequestStatus | (Members of |
conditions[]Kubernetes meta/v1.Condition | (Optional) Conditions holds the conditions for the Receiver. |
urlstring | (Optional) URL is the generated incoming webhook address in the format of ‘/hook/sha256sum(token+name+namespace)’. Deprecated: Replaced by WebhookPath. |
webhookPathstring | (Optional) WebhookPath is the generated incoming webhook address in the format of ‘/hook/sha256sum(token+name+namespace)’. |
observedGenerationint64 | (Optional) ObservedGeneration is the last observed generation of the Receiver object. |
This page was automatically generated with gen-crd-api-reference-docs