doc: add graphql cache configuration documentation

Signed-off-by: Rob Myers <[email protected]>

Author: robmyersrobmyers

docs/content/configuration.md

@@ -875,6 +875,9 @@ that requires GraphQL schemas.
 | `caching.inter_query_builtin_cache.stale_entry_eviction_period_seconds`  | `int64` | No       | Stale entry eviction period in seconds. OPA will drop expired items from the cache every `stale_entry_eviction_period_seconds`. By default, set to `0` indicating stale entry eviction is disabled.                                                  |
 | `caching.inter_query_builtin_value_cache.max_num_entries`                | `int`   | No       | Maximum number of entries in the Inter-query value cache. OPA will drop random items from the cache if this limit is exceeded. By default, set to `0` indicating unlimited size.                                                                     |
 | `caching.inter_query_builtin_value_cache.named.io_jwt.max_num_entries`   | `int`   | No       | Maximum number of entries in the `io_jwt` cache, used by the [`io.jwt` token verification](../policy-reference/#tokens) built-in functions. OPA will drop random items from the cache if this limit is exceeded. By default, this cache is disabled. |
+| `caching.inter_query_builtin_value_cache.named.graphql_schema.max_num_entries`   | `int`   | No       | Maximum number of entries in the `graphql_schema` cache, used by the [`graphql` builtins](../policy-reference/#graphql) built-in functions to cache parsed schemas. OPA will drop random items from the cache if this limit is exceeded. By default, this cache is set to a maximum of 10 entries. |
+| `caching.inter_query_builtin_value_cache.named.graphql_schema_ast.max_num_entries`   | `int`   | No       | Maximum number of entries in the `graphql_schema_ast` cache, used by the [`graphql` builtins](../policy-reference/#graphql) built-in functions to cache parsed schemas ast.Value. OPA will drop random items from the cache if this limit is exceeded. By default, this cache is set to a maximum of 10 entries. |
+| `caching.inter_query_builtin_value_cache.named.graphql_schema_doc.max_num_entries`   | `int`   | No       | Maximum number of entries in the `graphql_schema_doc` cache, used by the [`graphql` builtins](../policy-reference/#graphql) built-in functions to cache parsed schemas as a SchemaDocument. OPA will drop random items from the cache if this limit is exceeded. By default, this cache is set to a maximum of 10 entries. |
 
 ## Distributed tracing
 

v1/plugins/discovery/discovery_test.go

@@ -1721,8 +1721,11 @@ func TestReconfigureWithLocalOverride(t *testing.T) {
 			"inter_query_builtin_cache": {"max_size_bytes": 10000000, "forced_eviction_threshold_percentage": 90},
 			"inter_query_builtin_value_cache": {
 				"named": {
-					"io_jwt": {"max_num_entries": 55}
-				} 
+					"io_jwt": {"max_num_entries": 55},
+					"graphql_schema": {"max_num_entries": 10},
+					"graphql_schema_ast": {"max_num_entries": 10},
+					"graphql_schema_doc": {"max_num_entries": 10}
+				}
 			}
 		}
 	}`)
@@ -1888,8 +1891,11 @@ func TestReconfigureWithLocalOverride(t *testing.T) {
 					"inter_query_builtin_cache": {"max_size_bytes": 200, "stale_entry_eviction_period_seconds": 10, "forced_eviction_threshold_percentage": 200},
 					"inter_query_builtin_value_cache": {
 						"named": {
-							"io_jwt": {"max_num_entries": 10}
-						} 
+							"io_jwt": {"max_num_entries": 10},
+							"graphql_schema": {"max_num_entries": 11},
+							"graphql_schema_ast": {"max_num_entries": 12},
+							"graphql_schema_doc": {"max_num_entries": 13}
+						}
 					}
 				}
 			}
@@ -1906,6 +1912,9 @@ func TestReconfigureWithLocalOverride(t *testing.T) {
 		"caching.inter_query_builtin_cache.max_size_bytes",
 		"caching.inter_query_builtin_cache.forced_eviction_threshold_percentage",
 		"caching.inter_query_builtin_value_cache.named.io_jwt.max_num_entries",
+		"caching.inter_query_builtin_value_cache.named.graphql_schema.max_num_entries",
+		"caching.inter_query_builtin_value_cache.named.graphql_schema_ast.max_num_entries",
+		"caching.inter_query_builtin_value_cache.named.graphql_schema_doc.max_num_entries",
 	}
 	for _, k := range expectedOverriddenKeys {
 		if !strings.Contains(disco.status.Message, k) {
@@ -1928,6 +1937,12 @@ func TestReconfigureWithLocalOverride(t *testing.T) {
 	*maxNumEntriesInterQueryValueCache = 0
 	maxNumEntriesJWTValueCache := new(int)
 	*maxNumEntriesJWTValueCache = 55
+	maxNumEntriesGraphQLSchemaValueCache := new(int)
+	*maxNumEntriesGraphQLSchemaValueCache = 10
+	maxNumEntriesGraphQLSchemaAstValueCache := new(int)
+	*maxNumEntriesGraphQLSchemaAstValueCache = 10
+	maxNumEntriesGraphQLSchemaDocValueCache := new(int)
+	*maxNumEntriesGraphQLSchemaDocValueCache = 10
 
 	expectedCacheConf := &cache.Config{
 		InterQueryBuiltinCache: cache.InterQueryBuiltinCacheConfig{
@@ -1941,6 +1956,15 @@ func TestReconfigureWithLocalOverride(t *testing.T) {
 				"io_jwt": {
 					MaxNumEntries: maxNumEntriesJWTValueCache,
 				},
+				"graphql_schema": {
+					MaxNumEntries: maxNumEntriesGraphQLSchemaValueCache,
+				},
+				"graphql_schema_ast": {
+					MaxNumEntries: maxNumEntriesGraphQLSchemaAstValueCache,
+				},
+				"graphql_schema_doc": {
+					MaxNumEntries: maxNumEntriesGraphQLSchemaDocValueCache,
+				},
 			},
 		},
 	}