Ability to configure Collector's Service, Headless Service, Monitoring Service and Extension Service

Author: sky333999

.chloggen/configure-collector-services.yaml

@@ -0,0 +1,19 @@
+# One of 'breaking', 'deprecation', 'new_component', 'enhancement', 'bug_fix'
+change_type: enhancement
+
+# The name of the component, or a single word describing the area of concern, (e.g. collector, target allocator, auto-instrumentation, opamp, github action)
+component: collector
+
+# A brief description of the change. Surround your text with quotes ("") if it needs to start with a backtick (`).
+note: "Add the ability to configure the Collector's Service, Headless Service, Monitoring Service and Extension Service"
+
+# One or more tracking issues related to the change
+issues: [4205]
+
+# (Optional) One or more lines of additional information to render under the primary note.
+# These lines will be padded with 2 spaces and then inserted directly into the document.
+# Use pipe (|) for multiline entries.
+subtext: |
+  Introduces additional CRD options to configure and manage all the services deployed alongside the Collector.
+  Each of the Service, Headless Service, Monitoring Service & Extension Service can now be individually Enabled/Disabled
+  and the Name can be overridden.

Makefile

@@ -657,6 +657,7 @@ TMP_DIR=$$(mktemp -d) ;\
 cd $$TMP_DIR ;\
 go mod init tmp ;\
 echo "Downloading $(2)" ;\
+echo "replace fybrik.io/crdoc => github.com/fybrik/crdoc v0.5.2" >> go.mod ;\
 go get $(2)@$(3) ;\
 GOBIN=$(PROJECT_DIR)/bin go install $(2) ;\
 rm -rf $$TMP_DIR ;\

apis/v1alpha1/convert.go

@@ -103,11 +103,15 @@ func tov1beta1(in OpenTelemetryCollector) (v1beta1.OpenTelemetryCollector, error
 			StatefulSetCommonFields: v1beta1.StatefulSetCommonFields{
 				VolumeClaimTemplates: copy.Spec.VolumeClaimTemplates,
 			},
-			Autoscaler:      tov1beta1Autoscaler(copy.Spec.Autoscaler, copy.Spec.MinReplicas, copy.Spec.MaxReplicas),
-			TargetAllocator: tov1beta1TA(copy.Spec.TargetAllocator),
-			Mode:            v1beta1.Mode(copy.Spec.Mode),
-			UpgradeStrategy: v1beta1.UpgradeStrategy(copy.Spec.UpgradeStrategy),
-			Config:          *cfg,
+			Autoscaler:        tov1beta1Autoscaler(copy.Spec.Autoscaler, copy.Spec.MinReplicas, copy.Spec.MaxReplicas),
+			TargetAllocator:   tov1beta1TA(copy.Spec.TargetAllocator),
+			Mode:              v1beta1.Mode(copy.Spec.Mode),
+			UpgradeStrategy:   v1beta1.UpgradeStrategy(copy.Spec.UpgradeStrategy),
+			Config:            *cfg,
+			Service:           tov1beta1ServiceSpec(copy.Spec.Service),
+			HeadlessService:   tov1beta1ServiceSpec(copy.Spec.HeadlessService),
+			MonitoringService: tov1beta1ServiceSpec(copy.Spec.MonitoringService),
+			ExtensionService:  tov1beta1ServiceSpec(copy.Spec.ExtensionService),
 			Ingress: v1beta1.Ingress{
 				Type:             v1beta1.IngressType(copy.Spec.Ingress.Type),
 				RuleType:         v1beta1.IngressRuleType(copy.Spec.Ingress.RuleType),
@@ -250,6 +254,13 @@ func tov1beta1Probe(in *Probe) *v1beta1.Probe {
 	}
 }
 
+func tov1beta1ServiceSpec(in ServiceSpec) v1beta1.ServiceSpec {
+	return v1beta1.ServiceSpec{
+		Enabled: in.Enabled,
+		Name:    in.Name,
+	}
+}
+
 func tov1beta1ConfigMaps(in []ConfigMapsSpec) []v1beta1.ConfigMapsSpec {
 	var mapsSpecs []v1beta1.ConfigMapsSpec
 	for _, m := range in {
@@ -336,6 +347,10 @@ func tov1alpha1(in v1beta1.OpenTelemetryCollector) (*OpenTelemetryCollector, err
 					Termination: TLSRouteTerminationType(copy.Spec.Ingress.Route.Termination),
 				},
 			},
+			Service:                       tov1alpha1ServiceSpec(copy.Spec.Service),
+			HeadlessService:               tov1alpha1ServiceSpec(copy.Spec.HeadlessService),
+			MonitoringService:             tov1alpha1ServiceSpec(copy.Spec.MonitoringService),
+			ExtensionService:              tov1alpha1ServiceSpec(copy.Spec.ExtensionService),
 			HostNetwork:                   copy.Spec.HostNetwork,
 			ShareProcessNamespace:         copy.Spec.ShareProcessNamespace,
 			PriorityClassName:             copy.Spec.PriorityClassName,
@@ -383,6 +398,13 @@ func tov1alpha1Probe(in *v1beta1.Probe) *Probe {
 	}
 }
 
+func tov1alpha1ServiceSpec(in v1beta1.ServiceSpec) ServiceSpec {
+	return ServiceSpec{
+		Enabled: in.Enabled,
+		Name:    in.Name,
+	}
+}
+
 func tov1alpha1Autoscaler(in *v1beta1.AutoscalerSpec) *AutoscalerSpec {
 	if in == nil {
 		return nil

apis/v1alpha1/opentelemetrycollector_types.go

@@ -239,6 +239,22 @@ type OpenTelemetryCollectorSpec struct {
 	// +optional
 	ServiceName string `json:"serviceName,omitempty"`
 
+	// Service to override configuration of the generated Collector Service.
+	// +optional
+	Service ServiceSpec `json:"service,omitempty"`
+
+	// HeadlessService to override configuration of the generated Collector HeadlessService.
+	// +optional
+	HeadlessService ServiceSpec `json:"headlessService,omitempty"`
+
+	// MonitoringService to override configuration of the generated Collector MonitoringService.
+	// +optional
+	MonitoringService ServiceSpec `json:"monitoringService,omitempty"`
+
+	// ExtensionService to override configuration of the generated Collector ExtensionService.
+	// +optional
+	ExtensionService ServiceSpec `json:"extensionService,omitempty"`
+
 	// AdditionalContainers allows injecting additional containers into the Collector's pod definition.
 	// These sidecar containers can be used for authentication proxies, log shipping sidecars, agents for shipping
 	// metrics to their cloud, or in general sidecars that do not support automatic injection. This option only
@@ -600,3 +616,20 @@ type ConfigMapsSpec struct {
 func init() {
 	SchemeBuilder.Register(&OpenTelemetryCollector{}, &OpenTelemetryCollectorList{})
 }
+
+type ServiceSpec struct {
+	// Enabled indicates whether the Service should be created.
+	// nil means not set (defaults to enabled for backward compatibility)
+	// +optional
+	Enabled *bool `json:"enabled,omitempty"`
+
+	// Name to override the default Service name
+	// +optional
+	Name string `json:"name,omitempty"`
+}
+
+// IsEnabled returns true if the service should be created.
+// nil (not set) defaults to true for backward compatibility.
+func (s *ServiceSpec) IsEnabled() bool {
+	return s.Enabled == nil || *s.Enabled
+}

apis/v1alpha1/zz_generated.deepcopy.go

@@ -140,6 +140,22 @@ type OpenTelemetryCollectorSpec struct {
 	// If not specified, it will default to "<name>-headless".
 	// +optional
 	ServiceName string `json:"serviceName,omitempty"`
+
+	// Service to override configuration of the generated Collector Service.
+	// +optional
+	Service ServiceSpec `json:"service,omitempty"`
+
+	// HeadlessService to override configuration of the generated Collector HeadlessService.
+	// +optional
+	HeadlessService ServiceSpec `json:"headlessService,omitempty"`
+
+	// MonitoringService to override configuration of the generated Collector MonitoringService.
+	// +optional
+	MonitoringService ServiceSpec `json:"monitoringService,omitempty"`
+
+	// ExtensionService to override configuration of the generated Collector ExtensionService.
+	// +optional
+	ExtensionService ServiceSpec `json:"extensionService,omitempty"`
 }
 
 // TargetAllocatorEmbedded defines the configuration for the Prometheus target allocator, embedded in the
@@ -324,3 +340,20 @@ type ConfigMapsSpec struct {
 	Name      string `json:"name"`
 	MountPath string `json:"mountpath"`
 }
+
+type ServiceSpec struct {
+	// Enabled indicates whether the Service should be created.
+	// nil means not set (defaults to enabled for backward compatibility)
+	// +optional
+	Enabled *bool `json:"enabled,omitempty"`
+
+	// Name to override the default Service name
+	// +optional
+	Name string `json:"name,omitempty"`
+}
+
+// IsEnabled returns true if the service should be created.
+// nil (not set) defaults to true for backward compatibility.
+func (s *ServiceSpec) IsEnabled() bool {
+	return s.Enabled == nil || *s.Enabled
+}

apis/v1beta1/opentelemetrycollector_types.go

@@ -99,7 +99,7 @@ metadata:
     categories: Logging & Tracing,Monitoring
     certified: "false"
     containerImage: ghcr.io/open-telemetry/opentelemetry-operator/opentelemetry-operator
-    createdAt: "2025-07-30T19:32:31Z"
+    createdAt: "2025-08-06T20:58:08Z"
     description: Provides the OpenTelemetry components, including the Collector
     operators.operatorframework.io/builder: operator-sdk-v1.29.0
     operators.operatorframework.io/project_layout: go.kubebuilder.io/v3

apis/v1beta1/zz_generated.deepcopy.go

@@ -1454,6 +1454,20 @@ spec:
                       x-kubernetes-map-type: atomic
                   type: object
                 type: array
+              extensionService:
+                properties:
+                  enabled:
+                    type: boolean
+                  name:
+                    type: string
+                type: object
+              headlessService:
+                properties:
+                  enabled:
+                    type: boolean
+                  name:
+                    type: string
+                type: object
               hostNetwork:
                 type: boolean
               image:
@@ -2346,6 +2360,13 @@ spec:
                 - sidecar
                 - statefulset
                 type: string
+              monitoringService:
+                properties:
+                  enabled:
+                    type: boolean
+                  name:
+                    type: string
+                type: object
               nodeSelector:
                 additionalProperties:
                   type: string
@@ -2596,6 +2617,13 @@ spec:
                         type: string
                     type: object
                 type: object
+              service:
+                properties:
+                  enabled:
+                    type: boolean
+                  name:
+                    type: string
+                type: object
               serviceAccount:
                 type: string
               serviceName:
@@ -6063,6 +6091,20 @@ spec:
                       x-kubernetes-map-type: atomic
                   type: object
                 type: array
+              extensionService:
+                properties:
+                  enabled:
+                    type: boolean
+                  name:
+                    type: string
+                type: object
+              headlessService:
+                properties:
+                  enabled:
+                    type: boolean
+                  name:
+                    type: string
+                type: object
               hostNetwork:
                 type: boolean
               image:
@@ -6956,6 +6998,13 @@ spec:
                 - sidecar
                 - statefulset
                 type: string
+              monitoringService:
+                properties:
+                  enabled:
+                    type: boolean
+                  name:
+                    type: string
+                type: object
               nodeSelector:
                 additionalProperties:
                   type: string
@@ -7261,6 +7310,13 @@ spec:
                         type: string
                     type: object
                 type: object
+              service:
+                properties:
+                  enabled:
+                    type: boolean
+                  name:
+                    type: string
+                type: object
               serviceAccount:
                 type: string
               serviceName:

bundle/community/manifests/opentelemetry-operator.clusterserviceversion.yaml

@@ -99,7 +99,7 @@ metadata:
     categories: Logging & Tracing,Monitoring
     certified: "false"
     containerImage: ghcr.io/open-telemetry/opentelemetry-operator/opentelemetry-operator
-    createdAt: "2025-07-30T19:32:32Z"
+    createdAt: "2025-08-06T20:58:09Z"
     description: Provides the OpenTelemetry components, including the Collector
     operators.operatorframework.io/builder: operator-sdk-v1.29.0
     operators.operatorframework.io/project_layout: go.kubebuilder.io/v3