Google Redis Reference (Beta)

This topic gives you reference information about the Google Redis service (csb-google-redis). It details the plans, configuration parameters, and binding credentials.

Caution The Google Redis service offering is currently in beta and is intended for evaluation and test purposes only. Do not use this product in a production environment.

Note Release v1.2.0 removes brokerpak pre-configured plans for Google Redis. All plans must be configured through the tile. If you have instances of Google Redis that were created in previous versions and that you want to maintain, see Previously Provided Pre-configured Plans. For more information about upgrade steps, see Upgrading Tanzu Cloud Service Broker for GCP.

Plan Configuration Parameters

When configuring Cloud Service Broker for GCP you can add additional plans. For how to configure plans, see Configure Services with Cloud Service Broker for GCP.

The following table lists parameters which can only be configured for additional plans:

Parameter Name	Values	Default
`name`*	The plan name	n/a
`id`*	A unique GUID	n/a
`description`*	Description of the new plan	n/a
`service_tier`*	The service tier of the instance - BASIC or STANDARD_HA	n/a
`free`	When false, Service Instances of this Service Plan have a cost	true
`bindable`	Specifies whether Service Instances of the Service Plan can bind to applications	true
`plan_updateable`	Whether the Plan supports upgrade/downgrade/sidegrade to another version	true

^* Required

You can also add any of the configuration parameters listed in the parameters section to your plan.

Note If you set a parameter at plan level, developers cannot change the value when creating or updating service instances.

Configuration Parameters

You can provision a service by running:

cf create-service csb-google-redis PLAN-NAME SERVICE-INSTANCE-NAME -c '{"PARAMETER-NAME": "PARAMETER-VALUE"}'

You can update the configuration parameters for a service instance by running:

cf update-service SERVICE-INSTANCE-NAME -c '{"PARAMETER-NAME": "PARAMETER-VALUE"}'

The following table lists the parameters that you can configure, by using the -c flag, when provisioning a csb-google-redis service:

Parameter Name	Type	Description	Default	Operation
`display_name`	string	The display name of the Redis instance.	`INSTANCE-ID`	provision and update
`memory_size_gb`	integer	The size of the instance in gigabytes, 1–300.	`4`	provision and update
`instance_id`	string	Permanent identifier for your instance.	`csb-INSTANCE-ID`	provision and update
`region`	string	The region of the Redis instance.	`us-central1`	provision and update
`authorized_network`	string	The name of the Google Compute Engine network to which the instance is connected.	`default`	provision
`authorized_network_id`	string	The ID of the Google Compute Engine network to which the instance is connected.	`""`	provision
`reserved_ip_range`	string	The range of IP addresses reserved for this instance.	`""`	provision
`credentials`	string	The GCP credentials.	The value the operator entered for Credentials in Tanzu Operations Manager.	provision and update
`project`	string	The GCP project to use.	The value the operator entered for Project in Tanzu Operations Manager.	provision and update

Binding Credentials

You can bind a service by running:

cf bind-service APP-NAME SERVICE-INSTANCE --binding-name BINDING-NAME

The format for binding credentials for Google Redis is as follows:

{
    "host" : "INSTANCE-HOST",
    "port" : "INSTANCE-PORT",
    "memory_size_gb" : "INSTANCE-SIZE-GB",
    "service_tier" : "SERVICE-TIER",
    "redis_version" : "REDIS-VERSION"
}

Previously Provided Pre-configured Plans

The table below lists the previously provided plans for Google Redis:

Plan	Description
basic	A basic plan with no failover. Data will be lost on maintenance or cluster changes.
ha	A highly available plan with automatic failover.

To keep these plans in this version of the broker, add them through the tile as custom plans. For how to configure plans through the tile, see Configure Services with Cloud Service Broker for GCP.

Add the following block to keep the basic plan:

{
    "name": "basic",
    "id": "6ed44104-8777-4b57-8c03-826b3af7d0be",
    "description": "Beta - A basic plan with no failover. Data will be lost on maintenance or cluster changes.",
    "service_tier": "BASIC",
    "metadata": {
        "displayName": "basic (Beta)",
        "bullets": [
            "uses defaults", "basic"
        ]
    }
}

Add the following block to keep the ha plan:

{
    "name": "ha",
    "id": "8c85c90c-f8e3-4337-9069-c03036243894",
    "description": "Beta - A highly available plan with automatic failover.",
    "service_tier": "STANDARD_HA",
    "metadata": {
        "displayName": "High Availability (Beta)",
        "bullets": [
            "uses defaults", "high availability"
        ]
    }
}