Add support for different kernel types (Classic and NextGen) by introducing a build tag and including the kernel type in version information. (#1812)

close #1811

Author: tenfyzhong

Makefile

@@ -63,6 +63,13 @@ ifeq ("${ENABLE_FIPS}", "1")
 	GOEXPERIMENT = GOEXPERIMENT=boringcrypto
 	CGO = 1
 endif
+ifeq ("${NEXT_GEN}", "1")
+	ifeq ($(BUILD_FLAG),)
+		BUILD_FLAG := -tags nextgen
+	else
+		BUILD_FLAG := $(BUILD_FLAG),nextgen
+	endif
+endif
 
 RELEASE_VERSION =
 ifeq ($(RELEASE_VERSION),)
@@ -134,7 +141,7 @@ build-cdc-with-failpoint: ## Build cdc with failpoint enabled.
 	$(FAILPOINT_ENABLE)
 	$(GOBUILD) -ldflags '$(LDFLAGS)' -o bin/cdc ./cmd/cdc/main.go
 	$(FAILPOINT_DISABLE)
-	
+
 cdc:
 	$(GOBUILD) -ldflags '$(LDFLAGS)' -o bin/cdc ./cmd/cdc
 

pkg/config/kerneltype/classic.go

@@ -0,0 +1,27 @@
+// Copyright 2025 PingCAP, Inc.
+//
+// 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,
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+//go:build !nextgen
+
+package kerneltype
+
+const (
+	// KernelType is the current kernel type, which is Classic in this case.
+	KernelType = "Classic"
+)
+
+// IsNextGen returns true if the current kernel type is NextGen.
+// see doc.go for more info.
+func IsNextGen() bool {
+	return false
+}

pkg/config/kerneltype/doc.go

@@ -0,0 +1,35 @@
+// Copyright 2025 PingCAP, Inc.
+//
+// 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,
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Package kerneltype provides the kernel type of TiDB.
+//
+// We have 2 types of kernel: Classic and NextGen.
+//
+// TiDB Classic Kernel refers to the original architecture used during the early
+// development stages of TiDB. It utilizes a share-nothing architecture, primarily
+// implemented through TiKV, TiDB's distributed transactional key-value storage
+// component. In this setup, each TiKV instance independently manages its own
+// local storage and computing resources, eliminating dependencies on shared resources.
+//
+// This architecture provides advantages in terms of horizontal scalability, fault
+// tolerance, and simplified management. Each node independently handles data,
+// allowing for easy addition or removal of nodes to adapt to workload changes.
+// However, unlike the next-generation (cloud native) kernel, it does not leverage
+// shared storage solutions like S3 and requires managing local storage directly
+// on each node.
+//
+// The TiDB Next-gen (Cloud Native) Kernel is a new architecture specifically
+// designed for cloud-native infrastructure. It adopts a shared-storage architecture
+// for the data plane, typically using object storage solutions like Amazon S3 as
+// the single source of truth for data storage.
+package kerneltype

pkg/config/kerneltype/nextgen.go

@@ -0,0 +1,27 @@
+// Copyright 2025 PingCAP, Inc.
+//
+// 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,
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+//go:build nextgen
+
+package kerneltype
+
+const (
+	// KernelType is the current kernel type, which is Next Generation in this case.
+	KernelType = "Next Generation"
+)
+
+// IsNextGen returns true if the current kernel type is NextGen.
+// see doc.go for more info.
+func IsNextGen() bool {
+	return true
+}

pkg/config/kerneltype/type.go

@@ -0,0 +1,24 @@
+// Copyright 2025 PingCAP, Inc.
+//
+// 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,
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package kerneltype
+
+// IsClassic returns true if the current kernel type is Classic.
+func IsClassic() bool {
+	return !IsNextGen()
+}
+
+// Name returns the kernel type name
+func Name() string {
+	return KernelType
+}

pkg/version/version.go

@@ -18,6 +18,7 @@ import (
 
 	"github.com/coreos/go-semver/semver"
 	"github.com/pingcap/log"
+	"github.com/pingcap/ticdc/pkg/config/kerneltype"
 	"go.uber.org/zap"
 )
 
@@ -50,6 +51,7 @@ func LogVersionInfo(app string) {
 		zap.String("utc-build-time", BuildTS),
 		zap.String("go-version", GoVersion),
 		zap.Bool("failpoint-build", false),
+		zap.String("kernel-type", kerneltype.Name()),
 	)
 }
 
@@ -62,5 +64,6 @@ func GetRawInfo() string {
 	info += fmt.Sprintf("UTC Build Time: %s\n", BuildTS)
 	info += fmt.Sprintf("Go Version: %s\n", GoVersion)
 	info += fmt.Sprintf("Failpoint Build: %t\n", false)
+	info += fmt.Sprintf("Kernel Type: %s\n", kerneltype.Name())
 	return info
 }

pkg/version/version_classic_test.go

@@ -0,0 +1,27 @@
+// Copyright 2025 PingCAP, Inc.
+//
+// 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,
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+//go:build !nextgen
+
+package version
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestGetRawInfoContainsKernelType(t *testing.T) {
+	info := GetRawInfo()
+	require.Contains(t, info, "Kernel Type: Classic\n")
+}

pkg/version/version_nextgen_test.go

@@ -0,0 +1,27 @@
+// Copyright 2025 PingCAP, Inc.
+//
+// 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,
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+//go:build nextgen
+
+package version
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestGetRawInfoContainsKernelType(t *testing.T) {
+	info := GetRawInfo()
+	require.Contains(t, info, "Kernel Type: Next Generation\n")
+}

scripts/check-log-style.sh

@@ -12,10 +12,10 @@
 # limitations under the License.
 
 # zap field name should be camelCase, excepts for idioms and special terms.
-grep -RnE "zap.[A-Z][a-zA-Z0-9]+\(\"[0-9A-Za-z]*[-_ ][^\"]*\"(,|\))" api cmd downstreamadapter coordinator eventpb heartbeatpb logservice maintainer pkg server tools utils version tests |
+grep -RnE "zap.[A-Z][a-zA-Z0-9]+\(\"[0-9A-Za-z]*[-_ ][^\"]*\"(,|\))" api cmd downstreamadapter coordinator eventpb heartbeatpb logservice maintainer pkg server tools utils tests |
 	grep -vE "user-agent" |
 	grep -vE "https_proxy|http_proxy|no_proxy" |
 	grep -vE "max-message-bytes|max-message-size|replication-factor" |
 	grep -vE "release-version|git-hash|git-branch|go-version" |
-	grep -vE "failpoint-build|utc-build-time" |
+	grep -vE "failpoint-build|utc-build-time|kernel-type" |
 	awk '{ print  } END { if (NR > 0) { exit 1  }  }'