MemcacheInstance
| Property | Value |
|---|---|
| Google Cloud Service Name | Cloud Memorystore for Memcached |
| Google Cloud Service Documentation | /memorystore/docs/memcached/ |
| Google Cloud REST Resource Name | v1beta2.projects.locations.instances |
| Google Cloud REST Resource Documentation | /memorystore/docs/memcached/reference/rest/v1beta2/projects.locations.instances |
| Config Connector Resource Short Names | gcpmemcacheinstance gcpmemcacheinstances memcacheinstance |
| Config Connector Service Name | memcache.googleapis.com |
| Config Connector Resource Fully Qualified Name | memcacheinstances.memcache.cnrm.cloud.google.com |
| Can Be Referenced by IAMPolicy/IAMPolicyMember | No |
| Config Connector Default Average Reconcile Interval In Seconds | 600 |
Custom Resource Definition Properties
Annotations
| Fields | |
|---|---|
cnrm.cloud.google.com/project-id |
|
Spec
Schema
displayName: string
maintenancePolicy:
createTime: string
description: string
updateTime: string
weeklyMaintenanceWindow:
- day: string
duration: string
startTime:
hours: integer
minutes: integer
nanos: integer
seconds: integer
memcacheParameters:
id: string
params:
string: string
memcacheVersion: string
networkRef:
external: string
name: string
namespace: string
nodeConfig:
cpuCount: integer
memorySizeMb: integer
nodeCount: integer
region: string
resourceID: string
zones:
- string
| Fields | |
|---|---|
|
Optional |
A user-visible name for the instance. |
|
Optional |
Maintenance policy for an instance. |
|
Optional |
Output only. The time when the policy was created. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. |
|
Optional |
Optional. Description of what this policy is for. Create/Update methods return INVALID_ARGUMENT if the length is greater than 512. |
|
Optional |
Output only. The time when the policy was updated. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. |
|
Required* |
Required. Maintenance window that is applied to resources covered by this policy. Minimum 1. For the current version, the maximum number of weekly_maintenance_windows is expected to be one. |
|
Required* |
|
|
Required* |
Required. The day of week that maintenance updates occur. - DAY_OF_WEEK_UNSPECIFIED: The day of the week is unspecified. - MONDAY: Monday - TUESDAY: Tuesday - WEDNESDAY: Wednesday - THURSDAY: Thursday - FRIDAY: Friday - SATURDAY: Saturday - SUNDAY: Sunday Possible values: ["DAY_OF_WEEK_UNSPECIFIED", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY"]. |
|
Required* |
Required. The length of the maintenance window, ranging from 3 hours to 8 hours. A duration in seconds with up to nine fractional digits, terminated by 's'. Example: "3.5s". |
|
Required* |
Required. Start time of the window in UTC time. |
|
Optional |
Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. |
|
Optional |
Minutes of hour of day. Must be from 0 to 59. |
|
Optional |
Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. |
|
Optional |
Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds. |
|
Optional |
Immutable. User-specified parameters for this memcache instance. |
|
Optional |
This is a unique ID associated with this set of parameters. |
|
Optional |
User-defined set of parameters to use in the memcache process. |
|
Optional |
The major version of Memcached software. If not provided, latest supported version will be used. Currently the latest supported major version is MEMCACHE_1_5. The minor version will be automatically determined by our system based on the latest supported minor version. Default value: "MEMCACHE_1_5" Possible values: ["MEMCACHE_1_5"]. |
|
Optional |
The full name of the network to connect the instance to. |
|
Optional |
Allowed value: string of the format `projects/{{project}}/global/networks/{{value}}`, where {{value}} is the `name` field of a `ComputeNetwork` resource. |
|
Optional |
Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
Optional |
Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
Required |
Immutable. Configuration for memcache nodes. |
|
Required |
Number of CPUs per node. |
|
Required |
Memory size in Mebibytes for each memcache node. |
|
Required |
Number of nodes in the memcache instance. |
|
Required |
Immutable. The region of the Memcache instance. If it is not provided, the provider region is used. |
|
Optional |
Immutable. Optional. The name of the resource. Used for creation and acquisition. When unset, the value of `metadata.name` is used as the default. |
|
Optional |
Immutable. Zones where memcache nodes should be provisioned. If not provided, all zones will be used. |
|
Optional |
|
* Field is required when parent field is specified
Status
Schema
conditions:
- lastTransitionTime: string
message: string
reason: string
status: string
type: string
createTime: string
discoveryEndpoint: string
maintenanceSchedule:
- endTime: string
scheduleDeadlineTime: string
startTime: string
memcacheFullVersion: string
memcacheNodes:
- host: string
nodeId: string
port: integer
state: string
zone: string
observedGeneration: integer
| Fields | |
|---|---|
conditions |
Conditions represent the latest available observation of the resource's current state. |
conditions[] |
|
conditions[].lastTransitionTime |
Last time the condition transitioned from one status to another. |
conditions[].message |
Human-readable message indicating details about last transition. |
conditions[].reason |
Unique, one-word, CamelCase reason for the condition's last transition. |
conditions[].status |
Status is the status of the condition. Can be True, False, Unknown. |
conditions[].type |
Type is the type of the condition. |
createTime |
Creation timestamp in RFC3339 text format. |
discoveryEndpoint |
Endpoint for Discovery API. |
maintenanceSchedule |
Output only. Published maintenance schedule. |
maintenanceSchedule[] |
|
maintenanceSchedule[].endTime |
Output only. The end time of any upcoming scheduled maintenance for this instance. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. |
maintenanceSchedule[].scheduleDeadlineTime |
Output only. The deadline that the maintenance schedule start time can not go beyond, including reschedule. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. |
maintenanceSchedule[].startTime |
Output only. The start time of any upcoming scheduled maintenance for this instance. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. |
memcacheFullVersion |
The full version of memcached server running on this instance. |
memcacheNodes |
Additional information about the instance state, if available. |
memcacheNodes[] |
|
memcacheNodes[].host |
Hostname or IP address of the Memcached node used by the clients to connect to the Memcached server on this node. |
memcacheNodes[].nodeId |
Identifier of the Memcached node. The node id does not include project or location like the Memcached instance name. |
memcacheNodes[].port |
The port number of the Memcached server on this node. |
memcacheNodes[].state |
Current state of the Memcached node. |
memcacheNodes[].zone |
Location (GCP Zone) for the Memcached node. |
observedGeneration |
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. |
Sample YAML(s)
Typical Use Case
# Copyright 2020 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: memcache.cnrm.cloud.google.com/v1beta1
kind: MemcacheInstance
metadata:
labels:
size: small
process-type: long-queue
name: memcacheinstance-sample
spec:
networkRef:
name: memcacheinstance-dep
nodeConfig:
memorySizeMb: 1024
cpuCount: 1
nodeCount: 2
region: us-central1
zones:
- us-central1-a
- us-central1-c
displayName: Sample Memcache Instance
memcacheParameters:
params:
listen-backlog: "10000"
max-item-size: "524288"
max-reqs-per-event: "1"
---
apiVersion: compute.cnrm.cloud.google.com/v1beta1
kind: ComputeAddress
metadata:
name: memcacheinstance-dep
spec:
addressType: INTERNAL
location: global
purpose: VPC_PEERING
prefixLength: 16
networkRef:
name: memcacheinstance-dep
---
apiVersion: compute.cnrm.cloud.google.com/v1beta1
kind: ComputeNetwork
metadata:
name: memcacheinstance-dep
spec:
autoCreateSubnetworks: false
---
apiVersion: servicenetworking.cnrm.cloud.google.com/v1beta1
kind: ServiceNetworkingConnection
metadata:
name: memcacheinstance-dep
spec:
networkRef:
name: memcacheinstance-dep
reservedPeeringRanges:
- name: memcacheinstance-dep
service: "servicenetworking.googleapis.com"