RedisCluster

Property	Value
Google Cloud Service Name	Cloud Memorystore for Redis
Google Cloud Service Documentation	/memorystore/docs/redis/
Google Cloud REST Resource Name	v1.projects.locations.instances
Google Cloud REST Resource Documentation	/memorystore/docs/redis/reference/rest/v1/projects.locations.instances
Config Connector Resource Short Names	rediscluster
Config Connector Service Name	redis.googleapis.com
Config Connector Resource Fully Qualified Name	redisclusters.redis.cnrm.cloud.google.com
Can Be Referenced by IAMPolicy/IAMPolicyMember	No
Config Connector Default Average Reconcile Interval In Seconds	600

Custom Resource Definition Properties

Spec

Schema

authorizationMode: string
deletionProtectionEnabled: boolean
location: string
nodeType: string
persistenceConfig:
  aofConfig:
    appendFsync: string
  mode: string
  rdbConfig:
    rdbSnapshotPeriod: string
    rdbSnapshotStartTime: string
projectRef:
  external: string
  kind: string
  name: string
  namespace: string
pscConfigs:
- networkRef:
    external: string
    name: string
    namespace: string
redisConfigs:
  string: string
replicaCount: integer
resourceID: string
shardCount: integer
transitEncryptionMode: string
zoneDistributionConfig:
  mode: string
  zone: string

Fields

Fields
`authorizationMode` Optional	`string` Optional. The authorization mode of the Redis cluster. If not provided, auth feature is disabled for the cluster.
`deletionProtectionEnabled` Optional	`boolean` Optional. The delete operation will fail when the value is set to true.
`location` Required*	`string` Immutable. Location of the resource.
`nodeType` Optional	`string` Optional. The type of a redis node in the cluster. NodeType determines the underlying machine-type of a redis node.
`persistenceConfig` Optional	`object` Optional. Persistence config (RDB, AOF) for the cluster.
`persistenceConfig.aofConfig` Optional	`object` Optional. AOF configuration. This field will be ignored if mode is not AOF.
`persistenceConfig.aofConfig.appendFsync` Optional	`string` Optional. fsync configuration.
`persistenceConfig.mode` Optional	`string` Optional. The mode of persistence.
`persistenceConfig.rdbConfig` Optional	`object` Optional. RDB configuration. This field will be ignored if mode is not RDB.
`persistenceConfig.rdbConfig.rdbSnapshotPeriod` Optional	`string` Optional. Period between RDB snapshots.
`persistenceConfig.rdbConfig.rdbSnapshotStartTime` Optional	`string` Optional. The time that the first snapshot was/will be attempted, and to which future snapshots will be aligned. If not provided, the current time will be used.
`projectRef` Required*	`object` Immutable. The Project that this resource belongs to.
`projectRef.external` Optional	`string` The `projectID` field of a project, when not managed by Config Connector.
`projectRef.kind` Optional	`string` The kind of the Project resource; optional but must be `Project` if provided.
`projectRef.name` Optional	`string` The `name` field of a `Project` resource.
`projectRef.namespace` Optional	`string` The `namespace` field of a `Project` resource.
`pscConfigs` Optional	`list (object)` Required. Each PscConfig configures the consumer network where IPs will be designated to the cluster for client access through Private Service Connect Automation. Currently, only one PscConfig is supported.
`pscConfigs[]` Optional	`object`
`pscConfigs[].networkRef` Required*	`object` Required. The network where the IP address of the discovery endpoint will be reserved, in the form of projects/{network_project}/global/networks/{network_id}.
`pscConfigs[].networkRef.external` Optional	`string` A reference to an externally managed Compute Network resource. Should be in the format `projects//global/networks/`.
`pscConfigs[].networkRef.name` Optional	`string` The `name` field of a `ComputeNetwork` resource.
`pscConfigs[].networkRef.namespace` Optional	`string` The `namespace` field of a `ComputeNetwork` resource.
`redisConfigs` Optional	`map (key: string, value: string)` Optional. Key/Value pairs of customer overrides for mutable Redis Configs
`replicaCount` Optional	`integer` Optional. The number of replica nodes per shard.
`resourceID` Optional	`string` The RedisCluster name. If not given, the metadata.name will be used.
`shardCount` Optional	`integer` Required. Number of shards for the Redis cluster.
`transitEncryptionMode` Optional	`string` Optional. The in-transit encryption for the Redis cluster. If not provided, encryption is disabled for the cluster.
`zoneDistributionConfig` Optional	`object` Optional. This config will be used to determine how the customer wants us to distribute cluster resources within the region.
`zoneDistributionConfig.mode` Optional	`string` Optional. The mode of zone distribution. Defaults to MULTI_ZONE, when not specified.
`zoneDistributionConfig.zone` Optional	`string` Optional. When SINGLE ZONE distribution is selected, zone field would be used to allocate all resources in that zone. This is not applicable to MULTI_ZONE, and would be ignored for MULTI_ZONE clusters.

authorizationMode

Optional

string

Optional. The authorization mode of the Redis cluster. If not provided, auth feature is disabled for the cluster.

deletionProtectionEnabled

Optional

boolean

Optional. The delete operation will fail when the value is set to true.

location

Required*

string

Immutable. Location of the resource.

nodeType

Optional

string

Optional. The type of a redis node in the cluster. NodeType determines the underlying machine-type of a redis node.

persistenceConfig

Optional

object

Optional. Persistence config (RDB, AOF) for the cluster.

persistenceConfig.aofConfig

Optional

object

Optional. AOF configuration. This field will be ignored if mode is not AOF.

persistenceConfig.aofConfig.appendFsync

Optional

string

Optional. fsync configuration.

persistenceConfig.mode

Optional

string

Optional. The mode of persistence.

persistenceConfig.rdbConfig

Optional

object

Optional. RDB configuration. This field will be ignored if mode is not RDB.

persistenceConfig.rdbConfig.rdbSnapshotPeriod

Optional

string

Optional. Period between RDB snapshots.

persistenceConfig.rdbConfig.rdbSnapshotStartTime

Optional

string

Optional. The time that the first snapshot was/will be attempted, and to which future snapshots will be aligned. If not provided, the current time will be used.

projectRef

Required*

object

Immutable. The Project that this resource belongs to.

projectRef.external

Optional

string

The `projectID` field of a project, when not managed by Config Connector.

projectRef.kind

Optional

string

The kind of the Project resource; optional but must be `Project` if provided.

projectRef.name

Optional

string

The `name` field of a `Project` resource.

projectRef.namespace

Optional

string

The `namespace` field of a `Project` resource.

pscConfigs

Optional

list (object)

Required. Each PscConfig configures the consumer network where IPs will be designated to the cluster for client access through Private Service Connect Automation. Currently, only one PscConfig is supported.

pscConfigs[]

Optional

object

pscConfigs[].networkRef

Required*

object

Required. The network where the IP address of the discovery endpoint will be reserved, in the form of projects/{network_project}/global/networks/{network_id}.

pscConfigs[].networkRef.external

Optional

string

A reference to an externally managed Compute Network resource. Should be in the format `projects//global/networks/`.

pscConfigs[].networkRef.name

Optional

string

The `name` field of a `ComputeNetwork` resource.

pscConfigs[].networkRef.namespace

Optional

string

The `namespace` field of a `ComputeNetwork` resource.

redisConfigs

Optional

map (key: string, value: string)

Optional. Key/Value pairs of customer overrides for mutable Redis Configs

replicaCount

Optional

integer

Optional. The number of replica nodes per shard.

resourceID

Optional

string

The RedisCluster name. If not given, the metadata.name will be used.

shardCount

Optional

integer

Required. Number of shards for the Redis cluster.

transitEncryptionMode

Optional

string

Optional. The in-transit encryption for the Redis cluster. If not provided, encryption is disabled for the cluster.

zoneDistributionConfig

Optional

object

Optional. This config will be used to determine how the customer wants us to distribute cluster resources within the region.

zoneDistributionConfig.mode

Optional

string

Optional. The mode of zone distribution. Defaults to MULTI_ZONE, when not specified.

zoneDistributionConfig.zone

Optional

string

Optional. When SINGLE ZONE distribution is selected, zone field would be used to allocate all resources in that zone. This is not applicable to MULTI_ZONE, and would be ignored for MULTI_ZONE clusters.

* Field is required when parent field is specified

Status

Schema

conditions:
- lastTransitionTime: string
  message: string
  reason: string
  status: string
  type: string
externalRef: string
observedGeneration: integer
observedState:
  createTime: string
  discoveryEndpoints:
  - address: string
    port: integer
    pscConfig:
      network: string
  preciseSizeGb: float
  pscConnections:
  - address: string
    forwardingRule: string
    network: string
    projectID: string
    pscConnectionID: string
  sizeGb: integer
  state: string
  stateInfo:
    updateInfo:
      targetReplicaCount: integer
      targetShardCount: integer
  uid: string

Fields
`conditions`	`list (object)` Conditions represent the latest available observations of the object's current state.
`conditions[]`	`object`
`conditions[].lastTransitionTime`	`string` Last time the condition transitioned from one status to another.
`conditions[].message`	`string` Human-readable message indicating details about last transition.
`conditions[].reason`	`string` Unique, one-word, CamelCase reason for the condition's last transition.
`conditions[].status`	`string` Status is the status of the condition. Can be True, False, Unknown.
`conditions[].type`	`string` Type is the type of the condition.
`externalRef`	`string` A unique specifier for the RedisCluster resource in GCP.
`observedGeneration`	`integer` ObservedGeneration is the generation of the resource that was most recently observed by the Config Connector controller. If this is equal to metadata.generation, then that means that the current reported status reflects the most recent desired state of the resource.
`observedState`	`object` ObservedState is the state of the resource as most recently observed in GCP.
`observedState.createTime`	`string` Output only. The timestamp associated with the cluster creation request.
`observedState.discoveryEndpoints`	`list (object)` Output only. Endpoints created on each given network, for Redis clients to connect to the cluster. Currently only one discovery endpoint is supported.
`observedState.discoveryEndpoints[]`	`object`
`observedState.discoveryEndpoints[].address`	`string` Output only. Address of the exposed Redis endpoint used by clients to connect to the service. The address could be either IP or hostname.
`observedState.discoveryEndpoints[].port`	`integer` Output only. The port number of the exposed Redis endpoint.
`observedState.discoveryEndpoints[].pscConfig`	`object` Output only. Customer configuration for where the endpoint is created and accessed from.
`observedState.discoveryEndpoints[].pscConfig.network`	`string` Required. The network where the IP address of the discovery endpoint will be reserved, in the form of projects/{network_project}/global/networks/{network_id}.
`observedState.preciseSizeGb`	`float` Output only. Precise value of redis memory size in GB for the entire cluster.
`observedState.pscConnections`	`list (object)` Output only. PSC connections for discovery of the cluster topology and accessing the cluster.
`observedState.pscConnections[]`	`object`
`observedState.pscConnections[].address`	`string` Output only. The IP allocated on the consumer network for the PSC forwarding rule.
`observedState.pscConnections[].forwardingRule`	`string` Output only. The URI of the consumer side forwarding rule. Example: projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}.
`observedState.pscConnections[].network`	`string` The consumer network where the IP address resides, in the form of projects/{project_id}/global/networks/{network_id}.
`observedState.pscConnections[].projectID`	`string` Output only. The consumer project_id where the forwarding rule is created from.
`observedState.pscConnections[].pscConnectionID`	`string` Output only. The PSC connection id of the forwarding rule connected to the service attachment.
`observedState.sizeGb`	`integer` Output only. Redis memory size in GB for the entire cluster rounded up to the next integer.
`observedState.state`	`string` Output only. The current state of this cluster. Can be CREATING, READY, UPDATING, DELETING and SUSPENDED
`observedState.stateInfo`	`object` Output only. Additional information about the current state of the cluster.
`observedState.stateInfo.updateInfo`	`object` Describes ongoing update on the cluster when cluster state is UPDATING.
`observedState.stateInfo.updateInfo.targetReplicaCount`	`integer` Target number of replica nodes per shard.
`observedState.stateInfo.updateInfo.targetShardCount`	`integer` Target number of shards for redis cluster
`observedState.uid`	`string` Output only. System assigned, unique identifier for the cluster.

Sample YAML(s)

Typical Use Case

# Copyright 2024 Google LLC
#
# 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,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

apiVersion: redis.cnrm.cloud.google.com/v1beta1
kind: RedisCluster
metadata:
  labels:
    label-one: "value-one"
  name: rediscluster-sample
spec:
  shardCount: 6
  pscConfigs:
  - networkRef:
      name: rediscluster-dep
  location: us-central1
  projectRef:
    external: ${PROJECT_ID?}
  replicaCount: 2
  nodeType: REDIS_STANDARD_SMALL
  transitEncryptionMode: TRANSIT_ENCRYPTION_MODE_SERVER_AUTHENTICATION
  authorizationMode: AUTH_MODE_IAM_AUTH
  redisConfigs:
    maxmemory-policy: volatile-ttl
  zoneDistributionConfig:
    mode: SINGLE_ZONE
    zone: us-central1-b
  persistenceConfig:
    mode: AOF
    aofConfig:
      appendFsync: EVERYSEC
  deletionProtectionEnabled: false
---
apiVersion: compute.cnrm.cloud.google.com/v1beta1
kind: ComputeNetwork
metadata:
  name: rediscluster-dep
spec:
  description: Test network for the project
  autoCreateSubnetworks: false
---
apiVersion: compute.cnrm.cloud.google.com/v1beta1
kind: ComputeSubnetwork
metadata:
  name: rediscluster-dep
spec:
  ipCidrRange: 10.128.0.0/20
  region: us-central1
  networkRef:
    name: rediscluster-dep
---
apiVersion: networkconnectivity.cnrm.cloud.google.com/v1alpha1
kind: NetworkConnectivityServiceConnectionPolicy
metadata:
  name: rediscluster-dep
  labels:
    label-one: "value-one"
spec:
  projectRef:
    external: ${PROJECT_ID?}
  location: us-central1
  serviceClass: "gcp-memorystore-redis"
  description: "Service Connection Policy for redis"
  networkRef:
    name: rediscluster-dep
  pscConfig:
    subnetworkRefs:
    - name: rediscluster-dep