Skip to main content

Data Services Naming Standards

Purpose: For platform engineers and contributors, provides the canonical naming conventions for all data services artifacts.

Product Names

ContextNameNotes
Marketing / docsopenCenter Managed KafkaTitle case, full product name
CLI outputmanaged-kafkaKebab-case
Conversation"managed Kafka" or "the Kafka service"Informal

Apply the same pattern for future services: openCenter Managed PostgreSQL, openCenter Managed Redis, etc.

Blueprint Names

ConventionExample
Blueprint directorymanaged-kafka-v1
FluxCD Kustomizationmanaged-kafka
Git tagmanaged-kafka-v1.0.0

Namespace Conventions

ServiceNamespaceRationale
Kafka operatordata-kafkadata- prefix groups all data services
Kafka clustersdata-kafkaCo-located with operator
PostgreSQL operatordata-postgresSame prefix pattern
PostgreSQL clustersdata-postgresCo-located with operator
Schema Registrydata-kafkaKafka add-on, same namespace
CDC (Debezium)data-kafkaRuns as KafkaConnect, same namespace

CRD Naming

API group: data.opencenter.cloud

CRDKindPlural
DataServiceDataServicedataservices
DataServiceTopicDataServiceTopicdataservicetopics
DataServiceUserDataServiceUserdataserviceusers
DataServiceConnectorDataServiceConnectordataserviceconnectors
OperationRunOperationRunoperationruns
ProviderCapabilityProviderCapabilityprovidercapabilities

Resource Naming Patterns

Resource TypePatternExample
Kafka cluster<customer>-<env>acme-production
Kafka topic<domain>.<entity>.<event>payments.order.created
Kafka usersvc-<service-name>svc-payment-processor
KafkaConnect<cluster>-connectacme-production-connect
PostgreSQL cluster<customer>-<env>-pgacme-production-pg

Repository Structure

openCenter-gitops-base/
└── applications/base/services/
└── strimzi-kafka-operator/ # Operator deployment

cluster-overlay-repo/
└── applications/overlays/<cluster>/
└── managed-services/
└── kafka/ # Customer Kafka instances
├── kustomization.yaml
├── kafka-cluster.yaml
├── topics/
└── users/

FluxCD Naming

ResourceName Pattern
GitRepository (base)opencenter-strimzi-kafka-operator
Kustomization (operator)strimzi-kafka-operator
Kustomization (instance)managed-kafka-<cluster-name>

Helm Release Naming

ReleaseChartNamespace
strimzi-kafka-operatorstrimzi-kafka-operatordata-kafka
kube-prometheus-stackkube-prometheus-stackobservability

Image Tag Patterns

ComponentRegistryTag Pattern
Strimzi Operatorquay.io/strimzi/operator0.44.0
Kafkaquay.io/strimzi/kafka0.44.0-kafka-3.8.1
Kafka Bridgequay.io/strimzi/kafka-bridge0.30.0

Note: Versions above reflect the current gitops-base target. The streaming blueprint documents the latest supported versions. Always check openCenter-gitops-base for the pinned version in production.

Cross-References