unified-storage: add ListSinceModified to kv store (#110250)

* implement ListKeysSince in event store

 implement data store version

---------

Co-authored-by: Georges Chaudy <chaudyg@gmail.com>
This commit is contained in:
Will Assis
2025-09-04 12:26:40 -04:00
committed by GitHub
co-authored by Georges Chaudy
parent eed8d189ac
commit ea7c370edd
4 changed files with 566 additions and 31 deletions
@@ -4,9 +4,13 @@ import (
"context"
"fmt"
"io"
"math/rand/v2"
"slices"
"strings"
"testing"
"time"
"github.com/bwmarrin/snowflake"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
"k8s.io/apimachinery/pkg/apis/meta/v1/unstructured"
@@ -15,6 +19,12 @@ import (
"github.com/grafana/grafana/pkg/storage/unified/resourcepb"
)
var appsNamespace = NamespacedResource{
Namespace: "default",
Group: "apps",
Resource: "resource",
}
func setupTestStorageBackend(t *testing.T) *kvStorageBackend {
kv := setupTestKV(t)
return NewKvStorageBackend(kv)
@@ -135,6 +145,7 @@ func TestKvStorageBackend_WriteEvent_Success(t *testing.T) {
Resource: "resources",
Name: "test-resource",
ResourceVersion: rv,
Action: expectedAction,
}
_, err = backend.eventStore.Get(ctx, eventKey)
@@ -341,7 +352,12 @@ func TestKvStorageBackend_ListIterator_Success(t *testing.T) {
}
for _, res := range resources {
testObj, err := createTestObjectWithName(res.name, res.group, res.value)
ns := NamespacedResource{
Group: res.group,
Resource: "resource",
Namespace: "default",
}
testObj, err := createTestObjectWithName(res.name, ns, res.value)
require.NoError(t, err)
metaAccessor, err := utils.MetaAccessor(testObj)
@@ -424,7 +440,7 @@ func TestKvStorageBackend_ListIterator_WithPagination(t *testing.T) {
// Create multiple test resources
for i := 1; i <= 5; i++ {
testObj, err := createTestObjectWithName(fmt.Sprintf("resource-%d", i), "apps", fmt.Sprintf("data-%d", i))
testObj, err := createTestObjectWithName(fmt.Sprintf("resource-%d", i), appsNamespace, fmt.Sprintf("data-%d", i))
require.NoError(t, err)
metaAccessor, err := utils.MetaAccessor(testObj)
@@ -603,7 +619,7 @@ func TestKvStorageBackend_ListIterator_SpecificResourceVersion(t *testing.T) {
ctx := context.Background()
// Create a resource
testObj, err := createTestObjectWithName("test-resource", "apps", "initial-data")
testObj, err := createTestObjectWithName("test-resource", appsNamespace, "initial-data")
require.NoError(t, err)
metaAccessor, err := utils.MetaAccessor(testObj)
@@ -663,17 +679,248 @@ func TestKvStorageBackend_ListIterator_SpecificResourceVersion(t *testing.T) {
require.Len(t, collectedItems, 1)
// Verify we got the original data, not the updated data
originalObj, err := createTestObjectWithName("test-resource", "apps", "initial-data")
originalObj, err := createTestObjectWithName("test-resource", appsNamespace, "initial-data")
require.NoError(t, err)
require.Equal(t, objectToJSONBytes(t, originalObj), collectedItems[0])
}
func TestKvStorageBackend_ListModifiedSince(t *testing.T) {
backend := setupTestStorageBackend(t)
ctx := context.Background()
ns := NamespacedResource{
Namespace: "default",
Group: "apps",
Resource: "resources",
}
expectations := seedBackend(t, backend, ctx, ns)
for _, expectation := range expectations {
_, seq := backend.ListModifiedSince(ctx, ns, expectation.rv)
for mr, err := range seq {
require.NoError(t, err)
require.Equal(t, mr.Key.Group, ns.Group)
require.Equal(t, mr.Key.Namespace, ns.Namespace)
require.Equal(t, mr.Key.Resource, ns.Resource)
expectedMr, ok := expectation.changes[mr.Key.Name]
require.True(t, ok, "ListModifiedSince yielded unexpected resource: ", mr.Key.String())
require.Equal(t, mr.ResourceVersion, expectedMr.ResourceVersion)
require.Equal(t, mr.Action, expectedMr.Action)
require.Equal(t, string(mr.Value), string(expectedMr.Value))
delete(expectation.changes, mr.Key.Name)
}
require.Equal(t, 0, len(expectation.changes), "ListModifiedSince failed to return one or more expected items")
}
}
type expectation struct {
rv int64
changes map[string]*ModifiedResource
}
func randomString() string {
const charset = "abcdefghijklmnopqrstuvwxyz0123456789"
result := make([]byte, 16)
for i := range result {
result[i] = charset[rand.IntN(len(charset))]
}
return string(result)
}
func randomStringGenerator() func() string {
generated := make([]string, 0)
return func() string {
var str string
for str == "" {
randString := randomString()
if !slices.Contains(generated, randString) {
str = randString
}
}
return str
}
}
// creates 2 hour old snowflake for testing
func generateOldSnowflake(t *testing.T) int64 {
// Generate a current snowflake first
node, err := snowflake.NewNode(1)
require.NoError(t, err)
currentSnowflake := node.Generate().Int64()
// Extract its timestamp component by shifting right
currentTimestamp := currentSnowflake >> 22
// Subtract 2 hours (in milliseconds) from the timestamp
twoHoursMs := int64(2 * time.Hour / time.Millisecond)
oldTimestamp := currentTimestamp - twoHoursMs
// Reconstruct snowflake: [timestamp:41][node:10][sequence:12]
// Keep the original node and sequence bits
nodeAndSequence := currentSnowflake & 0x3FFFFF // Bottom 22 bits (10 node + 12 sequence)
snowflakeID := (oldTimestamp << 22) | nodeAndSequence
return snowflakeID
}
// seedBackend seeds the kvstore with data and return the expected result for ListModifiedSince calls
func seedBackend(t *testing.T, backend *kvStorageBackend, ctx context.Context, ns NamespacedResource) []expectation {
uniqueStringGen := randomStringGenerator()
nsDifferentNamespace := NamespacedResource{
Namespace: "uaoeueao",
Group: ns.Group,
Resource: ns.Resource,
}
expectations := make([]expectation, 0)
// initial test will contain the same "changes" as the second one (first one added by the for loop below)
// this is done with a 2 hour old RV so it uses the event store instead of the data store to check for changes
expectations = append(expectations, expectation{
rv: generateOldSnowflake(t),
changes: make(map[string]*ModifiedResource),
})
for range 100 {
updates := rand.IntN(5)
shouldDelete := rand.IntN(100) < 10
mr := createAndSaveTestObject(t, backend, ctx, ns, uniqueStringGen, updates, shouldDelete)
expectations = append(expectations, expectation{
rv: mr.ResourceVersion,
changes: make(map[string]*ModifiedResource),
})
for _, expect := range expectations {
expect.changes[mr.Key.Name] = mr
}
// also seed data to some random namespace to make sure we won't return this data
updates = rand.IntN(5)
shouldDelete = rand.IntN(100) < 10
_ = createAndSaveTestObject(t, backend, ctx, nsDifferentNamespace, uniqueStringGen, updates, shouldDelete)
}
// last test will simulate calling ListModifiedSince with a newer RV than all the updates above
rv, _ := backend.ListModifiedSince(ctx, ns, 1)
expectations = append(expectations, expectation{
rv: rv,
changes: make(map[string]*ModifiedResource), // empty
})
return expectations
}
func createAndSaveTestObject(t *testing.T, backend *kvStorageBackend, ctx context.Context, ns NamespacedResource, uniqueStringGen func() string, updates int, deleted bool) *ModifiedResource {
name := uniqueStringGen()
action := resourcepb.WatchEvent_ADDED
rv, testObj := addTestObject(t, backend, ctx, ns, name, uniqueStringGen())
for i := 0; i < updates; i += 1 {
rv = updateTestObject(t, backend, ctx, testObj, rv, ns, name, uniqueStringGen())
action = resourcepb.WatchEvent_MODIFIED
}
if deleted {
rv = deleteTestObject(t, backend, ctx, testObj, rv, ns, name)
action = resourcepb.WatchEvent_DELETED
}
value, err := testObj.MarshalJSON()
require.NoError(t, err)
return &ModifiedResource{
Key: resourcepb.ResourceKey{
Namespace: ns.Namespace,
Group: ns.Group,
Resource: ns.Resource,
Name: name,
},
ResourceVersion: rv,
Action: action,
Value: value,
}
}
func addTestObject(t *testing.T, backend *kvStorageBackend, ctx context.Context, ns NamespacedResource, name, value string) (int64, *unstructured.Unstructured) {
testObj, err := createTestObjectWithName(name, ns, value)
require.NoError(t, err)
metaAccessor, err := utils.MetaAccessor(testObj)
require.NoError(t, err)
writeEvent := WriteEvent{
Type: resourcepb.WatchEvent_ADDED,
Key: &resourcepb.ResourceKey{
Namespace: ns.Namespace,
Group: ns.Group,
Resource: ns.Resource,
Name: name,
},
Value: objectToJSONBytes(t, testObj),
Object: metaAccessor,
PreviousRV: 0,
}
rv, err := backend.WriteEvent(ctx, writeEvent)
require.NoError(t, err)
return rv, testObj
}
func deleteTestObject(t *testing.T, backend *kvStorageBackend, ctx context.Context, originalObj *unstructured.Unstructured, previousRV int64, ns NamespacedResource, name string) int64 {
metaAccessor, err := utils.MetaAccessor(originalObj)
require.NoError(t, err)
writeEvent := WriteEvent{
Type: resourcepb.WatchEvent_DELETED,
Key: &resourcepb.ResourceKey{
Namespace: ns.Namespace,
Group: ns.Group,
Resource: ns.Resource,
Name: name,
},
Value: objectToJSONBytes(t, originalObj),
Object: metaAccessor,
ObjectOld: metaAccessor,
PreviousRV: previousRV,
}
rv, err := backend.WriteEvent(ctx, writeEvent)
require.NoError(t, err)
return rv
}
func updateTestObject(t *testing.T, backend *kvStorageBackend, ctx context.Context, originalObj *unstructured.Unstructured, previousRV int64, ns NamespacedResource, name, value string) int64 {
originalObj.Object["spec"].(map[string]any)["value"] = value
metaAccessor, err := utils.MetaAccessor(originalObj)
require.NoError(t, err)
writeEvent := WriteEvent{
Type: resourcepb.WatchEvent_MODIFIED,
Key: &resourcepb.ResourceKey{
Namespace: ns.Namespace,
Group: ns.Group,
Resource: ns.Resource,
Name: name,
},
Value: objectToJSONBytes(t, originalObj),
Object: metaAccessor,
PreviousRV: previousRV,
}
rv, err := backend.WriteEvent(ctx, writeEvent)
require.NoError(t, err)
return rv
}
func TestKvStorageBackend_ListHistory_Success(t *testing.T) {
backend := setupTestStorageBackend(t)
ctx := context.Background()
// Create initial resource
testObj, err := createTestObjectWithName("test-resource", "apps", "initial-data")
testObj, err := createTestObjectWithName("test-resource", appsNamespace, "initial-data")
require.NoError(t, err)
metaAccessor, err := utils.MetaAccessor(testObj)
@@ -757,15 +1004,15 @@ func TestKvStorageBackend_ListHistory_Success(t *testing.T) {
require.Equal(t, rv1, historyItems[2].resourceVersion)
// Verify the content matches expectations for all versions
finalObj, err := createTestObjectWithName("test-resource", "apps", "final-data")
finalObj, err := createTestObjectWithName("test-resource", appsNamespace, "final-data")
require.NoError(t, err)
require.Equal(t, objectToJSONBytes(t, finalObj), historyItems[0].value)
updatedObj, err := createTestObjectWithName("test-resource", "apps", "updated-data")
updatedObj, err := createTestObjectWithName("test-resource", appsNamespace, "updated-data")
require.NoError(t, err)
require.Equal(t, objectToJSONBytes(t, updatedObj), historyItems[1].value)
initialObj, err := createTestObjectWithName("test-resource", "apps", "initial-data")
initialObj, err := createTestObjectWithName("test-resource", appsNamespace, "initial-data")
require.NoError(t, err)
require.Equal(t, objectToJSONBytes(t, initialObj), historyItems[2].value)
}
@@ -775,7 +1022,7 @@ func TestKvStorageBackend_ListTrash_Success(t *testing.T) {
ctx := context.Background()
// Create a resource
testObj, err := createTestObjectWithName("test-resource", "apps", "test-data")
testObj, err := createTestObjectWithName("test-resource", appsNamespace, "test-data")
require.NoError(t, err)
metaAccessor, err := utils.MetaAccessor(testObj)
@@ -873,7 +1120,12 @@ func TestKvStorageBackend_GetResourceStats_Success(t *testing.T) {
}
for _, res := range resources {
testObj, err := createTestObjectWithName(res.name, res.group, "test-data")
ns := NamespacedResource{
Group: res.group,
Namespace: "default",
Resource: "resource",
}
testObj, err := createTestObjectWithName(res.name, ns, "test-data")
require.NoError(t, err)
metaAccessor, err := utils.MetaAccessor(testObj)
@@ -930,7 +1182,7 @@ func TestKvStorageBackend_GetResourceStats_Success(t *testing.T) {
// createTestObject creates a test unstructured object with standard values
func createTestObject() (*unstructured.Unstructured, error) {
return createTestObjectWithName("test-resource", "apps", "test data")
return createTestObjectWithName("test-resource", appsNamespace, "test data")
}
// objectToJSONBytes converts an unstructured object to JSON bytes
@@ -941,14 +1193,14 @@ func objectToJSONBytes(t *testing.T, obj *unstructured.Unstructured) []byte {
}
// createTestObjectWithName creates a test unstructured object with specific name, group and value
func createTestObjectWithName(name, group, value string) (*unstructured.Unstructured, error) {
func createTestObjectWithName(name string, ns NamespacedResource, value string) (*unstructured.Unstructured, error) {
u := &unstructured.Unstructured{
Object: map[string]any{
"apiVersion": group + "/v1",
"kind": "resource",
"apiVersion": ns.Group + "/v1",
"kind": ns.Resource,
"metadata": map[string]any{
"name": name,
"namespace": "default",
"namespace": ns.Namespace,
},
"spec": map[string]any{
"value": value,