[Feature] [Platform] EventsV1 Integration (#1977)

Author: ajanikow

.golangci.yaml

@@ -37,6 +37,10 @@ linters-settings:
         pkg: github.com/arangodb/kube-arangodb/integrations/meta/v1
       - alias: pbMetaV1
         pkg: github.com/arangodb/kube-arangodb/integrations/meta/v1/definition
+      - alias: pbImplEventsV1
+        pkg: github.com/arangodb/kube-arangodb/integrations/events/v1
+      - alias: pbEventsV1
+        pkg: github.com/arangodb/kube-arangodb/integrations/events/v1/definition
       - alias: pbImplAuthenticationV1
         pkg: github.com/arangodb/kube-arangodb/integrations/authentication/v1
       - alias: pbAuthenticationV1

CHANGELOG.md

@@ -6,6 +6,7 @@
 - (Feature) (License) Activation CLI
 - (Bugfix) (DP) Propagate Timeout Across Subcommands
 - (Maintenance) Bump Dependencies
+- (Feature) (Platform) EventsV1 Integration
 
 ## [1.3.1](https://github.com/arangodb/kube-arangodb/tree/1.3.1) (2025-10-07)
 - (Documentation) Add ArangoPlatformStorage Docs & Examples

README.md

@@ -204,7 +204,7 @@ Flags:
       --kubernetes.qps float32                                 Number of queries per second for k8s API. If set to 0 or less, API calls won't be throttled (default 32)
       --leader.label.skip                                      Skips Leader Label for the Pod
       --log.format string                                      Set log format. Allowed values: 'pretty', 'JSON'. If empty, default format is used (default "pretty")
-      --log.level stringArray                                  Set log levels in format <level> or <logger>=<level>. Possible loggers: action, agency, api-server, assertion, backup-operator, chaos-monkey, crd, deployment, deployment-ci, deployment-reconcile, deployment-replication, deployment-resilience, deployment-resources, deployment-storage, deployment-storage-pc, deployment-storage-service, generic-parent-operator, helm, http, inspector, integration-authn-v1, integration-config-v1, integration-envoy-auth-v3, integration-envoy-auth-v3-impl-auth-bearer, integration-envoy-auth-v3-impl-auth-cookie, integration-envoy-auth-v3-impl-custom-openid, integration-envoy-auth-v3-impl-pass-mode, integration-meta-v1, integration-scheduler-v2, integration-shutdown-v1, integration-storage-v1-s3, integration-storage-v2, integrations, k8s-client, kubernetes, kubernetes-access, kubernetes-client, kubernetes-informer, monitor, networking-route-operator, operator, operator-arangojob-handler, operator-v2, operator-v2-event, operator-v2-worker, panics, platform-chart-operator, platform-pod-shutdown, platform-service-operator, platform-storage-operator, pod_compare, root, root-event-recorder, scheduler-batchjob-operator, scheduler-cronjob-operator, scheduler-deployment-operator, scheduler-pod-operator, scheduler-profile-operator, server, server-authentication, webhook (default [info])
+      --log.level stringArray                                  Set log levels in format <level> or <logger>=<level>. Possible loggers: action, agency, api-server, assertion, backup-operator, chaos-monkey, crd, deployment, deployment-ci, deployment-reconcile, deployment-replication, deployment-resilience, deployment-resources, deployment-storage, deployment-storage-pc, deployment-storage-service, generic-parent-operator, helm, http, inspector, integration-authn-v1, integration-config-v1, integration-envoy-auth-v3, integration-envoy-auth-v3-impl-auth-bearer, integration-envoy-auth-v3-impl-auth-cookie, integration-envoy-auth-v3-impl-custom-openid, integration-envoy-auth-v3-impl-pass-mode, integration-events-v1, integration-meta-v1, integration-pong-v1, integration-scheduler-v2, integration-shutdown-v1, integration-storage-v1-s3, integration-storage-v2, integrations, k8s-client, kubernetes, kubernetes-access, kubernetes-client, kubernetes-informer, monitor, networking-route-operator, operator, operator-arangojob-handler, operator-v2, operator-v2-event, operator-v2-worker, panics, platform-chart-operator, platform-pod-shutdown, platform-service-operator, platform-storage-operator, pod_compare, root, root-event-recorder, scheduler-batchjob-operator, scheduler-cronjob-operator, scheduler-deployment-operator, scheduler-pod-operator, scheduler-profile-operator, server, server-authentication, webhook (default [info])
       --log.sampling                                           If true, operator will try to minimize duplication of logging events (default true)
       --log.stdout                                             If true, operator will log to the stdout (default true)
       --memory-limit uint                                      Define memory limit for hard shutdown and the dump of goroutines. Used for testing

docs/cli/arangodb_operator.md

@@ -86,7 +86,7 @@ Flags:
       --kubernetes.qps float32                                 Number of queries per second for k8s API. If set to 0 or less, API calls won't be throttled (default 32)
       --leader.label.skip                                      Skips Leader Label for the Pod
       --log.format string                                      Set log format. Allowed values: 'pretty', 'JSON'. If empty, default format is used (default "pretty")
-      --log.level stringArray                                  Set log levels in format <level> or <logger>=<level>. Possible loggers: action, agency, api-server, assertion, backup-operator, chaos-monkey, crd, deployment, deployment-ci, deployment-reconcile, deployment-replication, deployment-resilience, deployment-resources, deployment-storage, deployment-storage-pc, deployment-storage-service, generic-parent-operator, helm, http, inspector, integration-authn-v1, integration-config-v1, integration-envoy-auth-v3, integration-envoy-auth-v3-impl-auth-bearer, integration-envoy-auth-v3-impl-auth-cookie, integration-envoy-auth-v3-impl-custom-openid, integration-envoy-auth-v3-impl-pass-mode, integration-meta-v1, integration-scheduler-v2, integration-shutdown-v1, integration-storage-v1-s3, integration-storage-v2, integrations, k8s-client, kubernetes, kubernetes-access, kubernetes-client, kubernetes-informer, monitor, networking-route-operator, operator, operator-arangojob-handler, operator-v2, operator-v2-event, operator-v2-worker, panics, platform-chart-operator, platform-pod-shutdown, platform-service-operator, platform-storage-operator, pod_compare, root, root-event-recorder, scheduler-batchjob-operator, scheduler-cronjob-operator, scheduler-deployment-operator, scheduler-pod-operator, scheduler-profile-operator, server, server-authentication, webhook (default [info])
+      --log.level stringArray                                  Set log levels in format <level> or <logger>=<level>. Possible loggers: action, agency, api-server, assertion, backup-operator, chaos-monkey, crd, deployment, deployment-ci, deployment-reconcile, deployment-replication, deployment-resilience, deployment-resources, deployment-storage, deployment-storage-pc, deployment-storage-service, generic-parent-operator, helm, http, inspector, integration-authn-v1, integration-config-v1, integration-envoy-auth-v3, integration-envoy-auth-v3-impl-auth-bearer, integration-envoy-auth-v3-impl-auth-cookie, integration-envoy-auth-v3-impl-custom-openid, integration-envoy-auth-v3-impl-pass-mode, integration-events-v1, integration-meta-v1, integration-pong-v1, integration-scheduler-v2, integration-shutdown-v1, integration-storage-v1-s3, integration-storage-v2, integrations, k8s-client, kubernetes, kubernetes-access, kubernetes-client, kubernetes-informer, monitor, networking-route-operator, operator, operator-arangojob-handler, operator-v2, operator-v2-event, operator-v2-worker, panics, platform-chart-operator, platform-pod-shutdown, platform-service-operator, platform-storage-operator, pod_compare, root, root-event-recorder, scheduler-batchjob-operator, scheduler-cronjob-operator, scheduler-deployment-operator, scheduler-pod-operator, scheduler-profile-operator, server, server-authentication, webhook (default [info])
       --log.sampling                                           If true, operator will try to minimize duplication of logging events (default true)
       --log.stdout                                             If true, operator will log to the stdout (default true)
       --memory-limit uint                                      Define memory limit for hard shutdown and the dump of goroutines. Used for testing

docs/cli/arangodb_operator_integration.md

@@ -58,6 +58,13 @@ Flags:
       --integration.envoy.auth.v3.extensions.users.create           Defines if UserCreation extension is enabled (Env: INTEGRATION_ENVOY_AUTH_V3_EXTENSIONS_USERS_CREATE)
       --integration.envoy.auth.v3.external                          Defines if External access to service envoy.auth.v3 is enabled (Env: INTEGRATION_ENVOY_AUTH_V3_EXTERNAL)
       --integration.envoy.auth.v3.internal                          Defines if Internal access to service envoy.auth.v3 is enabled (Env: INTEGRATION_ENVOY_AUTH_V3_INTERNAL) (default true)
+      --integration.events.v1                                       Enable EventsV1 Integration Service (Env: INTEGRATION_EVENTS_V1)
+      --integration.events.v1.async                                 Enables async injection of the events (Env: INTEGRATION_EVENTS_V1_ASYNC) (default true)
+      --integration.events.v1.async.retry.delay duration            Delay of the retries (Env: INTEGRATION_EVENTS_V1_ASYNC_RETRY_DELAY) (default 1s)
+      --integration.events.v1.async.retry.timeout duration          Timeout for the event injection (Env: INTEGRATION_EVENTS_V1_ASYNC_RETRY_TIMEOUT) (default 1m0s)
+      --integration.events.v1.async.size int                        Size of the async queue (Env: INTEGRATION_EVENTS_V1_ASYNC_SIZE) (default 16)
+      --integration.events.v1.external                              Defines if External access to service events.v1 is enabled (Env: INTEGRATION_EVENTS_V1_EXTERNAL)
+      --integration.events.v1.internal                              Defines if Internal access to service events.v1 is enabled (Env: INTEGRATION_EVENTS_V1_INTERNAL) (default true)
       --integration.meta.v1                                         Enable MetaV1 Integration Service (Env: INTEGRATION_META_V1)
       --integration.meta.v1.external                                Defines if External access to service meta.v1 is enabled (Env: INTEGRATION_META_V1_EXTERNAL)
       --integration.meta.v1.internal                                Defines if Internal access to service meta.v1 is enabled (Env: INTEGRATION_META_V1_INTERNAL) (default true)

docs/integration-sidecar.md

@@ -12,14 +12,9 @@ nav_order: 2
 
 ### Resource Types
 
-Integration Sidecar is supported in a few resources managed by Operator:
+Integration Sidecar is supported in a basic resources managed by Kubernetes:
 
-- ArangoSchedulerDeployment (scheduler.arangodb.com/v1beta1)
-- ArangoSchedulerBatchJob (scheduler.arangodb.com/v1beta1)
-- ArangoSchedulerCronJob (scheduler.arangodb.com/v1beta1)
-- ArangoSchedulerPod (scheduler.arangodb.com/v1beta1)
-
-Standard Kubernetes Resources (like Pod) are also supported with Webhook extension is enabled.
+- Pod
 
 To enable integration sidecar for specific deployment label needs to be defined:
 
@@ -140,6 +135,18 @@ metadata:
     integration.profiles.arangodb.com/meta: v1
 ```
 
+#### [Events V1](./integration/events.v1.md)
+
+Events Integration Sidecar
+
+To enable:
+
+```yaml
+metadata:
+  labels:
+    integration.profiles.arangodb.com/events: v1
+```
+
 ### Envs
 
 #### INTEGRATION_API_ADDRESS

docs/integration/authentication.v1.md

@@ -9,4 +9,4 @@ parent: Integration Sidecars
 
 Definitions:
 
-- [Service](https://github.com/arangodb/kube-arangodb/blob/1.3.0/integrations/authentication/v1/definition/definition.proto)
+- [Service](https://github.com/arangodb/kube-arangodb/blob/1.3.1/integrations/authentication/v1/definition/definition.proto)

docs/integration/authorization.v0.md

@@ -9,5 +9,5 @@ parent: Integration Sidecars
 
 Definitions:
 
-- [Service](https://github.com/arangodb/kube-arangodb/blob/1.3.0/integrations/authorization/v0/definition/definition.proto)
+- [Service](https://github.com/arangodb/kube-arangodb/blob/1.3.1/integrations/authorization/v0/definition/definition.proto)
 

docs/integration/events.v1.md

@@ -0,0 +1,12 @@
+---
+layout: page
+title: Integration Sidecar Meta V1
+grand_parent: ArangoDBPlatform
+parent: Integration Sidecars
+---
+
+# Events V1
+
+Definitions:
+
+- [Service](https://github.com/arangodb/kube-arangodb/blob/1.3.1/integrations/events/v1/definition/definition.proto)

docs/integration/meta.v1.md

@@ -9,4 +9,4 @@ parent: Integration Sidecars
 
 Definitions:
 
-- [Service](https://github.com/arangodb/kube-arangodb/blob/1.3.0/integrations/meta/v1/definition/definition.proto)
+- [Service](https://github.com/arangodb/kube-arangodb/blob/1.3.1/integrations/meta/v1/definition/definition.proto)