- Recurso: Cluster
- Flota
- ClusterNetworking
- Autorización
- ClusterUser
- MaintenancePolicy
- Período de mantenimiento
- RecurringTimeWindow
- TimeWindow
- MaintenanceExclusionWindow
- ControlPlane
- Control remoto
- Local
- SharedDeploymentPolicy
- SystemAddonsConfig
- Ingress
- VMServiceConfig
- ControlPlaneEncryption
- Estado
- MaintenanceEvent
- Tipo
- Programa
- Estado
- ReleaseChannel
- SurvivabilityConfig
- ConnectionState
- Estado
- ExternalLoadBalancerPool
- ZoneStorageEncryption
- ContainerRuntimeConfig
- DefaultContainerRuntime
- GoogleGroupAuthenticationConfig
- Métodos
Recurso: Clúster
Un clúster de Kubernetes de Google Distributed Cloud Edge.
| Representación JSON |
|---|
{ "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "fleet": { object ( |
| Campos | |
|---|---|
name |
Obligatorio. Es el nombre del recurso del clúster. |
createTime |
Solo salida. Es la hora en la que se creó el clúster. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
updateTime |
Solo salida. La hora en la que se actualizó el clúster por última vez. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
labels |
Son las etiquetas asociadas con este recurso. Un objeto que contiene una lista de pares |
fleet |
Obligatorio. Configuración de la flota. |
networking |
Obligatorio. Configuración de herramientas de redes de todo el clúster. |
authorization |
Obligatorio. Inmutable. Es la política de RBAC que aplicará y administrará GEC. |
defaultMaxPodsPerNode |
Es opcional. Cantidad máxima predeterminada de Pods por nodo que se usa si no se especifica de forma explícita un valor máximo para un grupo de nodos en este clúster. En tal caso, se usará el valor predeterminado de Kubernetes. |
endpoint |
Solo salida. Es la dirección IP del servidor de la API de Kubernetes. |
port |
Solo salida. Es el número de puerto del servidor de la API de Kubernetes. |
clusterCaCertificate |
Solo salida. Es el certificado público codificado con PEM de la AC del clúster. |
maintenancePolicy |
Es opcional. Configuración de la política de mantenimiento de todo el clúster. |
controlPlaneVersion |
Solo salida. La versión de actualización del plano de control |
nodeVersion |
Solo salida. Es la versión de actualización más baja entre todos los nodos trabajadores. Este campo puede estar vacío si el clúster no tiene ningún nodo trabajador. |
controlPlane |
Es opcional. Es la configuración del plano de control del clúster. |
systemAddonsConfig |
Es opcional. Es la configuración de los complementos del sistema. |
externalLoadBalancerIpv4AddressPools[] |
Es opcional. Son los grupos de direcciones IPv4 para el balanceo de cargas externo del plano de datos del clúster. |
controlPlaneEncryption |
Es opcional. Opciones de encriptación de discos del plano de control remoto. Este campo solo se usa cuando se habilita la compatibilidad con CMEK. |
status |
Solo salida. Es el estado actual del clúster. |
maintenanceEvents[] |
Solo salida. Todos los eventos de mantenimiento programados para el clúster, incluidos los que están en curso, los planificados para el futuro y los que se realizaron en el pasado (hasta 90 días). |
targetVersion |
Es opcional. Es la versión de destino del clúster. Por ejemplo: "1.5.0". |
releaseChannel |
Es opcional. Es el canal de versiones al que está suscrito un clúster. |
survivabilityConfig |
Es opcional. Configuración de la supervivencia del clúster, p.ej., para el caso en que se pierde la conexión de red. Nota: Esto solo se aplica a los clústeres del plano de control local. |
externalLoadBalancerIpv6AddressPools[] |
Es opcional. Grupos de direcciones IPv6 para el balanceo de cargas externo del plano de datos del clúster. |
connectionState |
Solo salida. Es el estado de conexión actual del clúster. |
externalLoadBalancerAddressPools[] |
Es opcional. Grupos de balanceador de cargas externos para el clúster. |
zoneStorageEncryption |
Es opcional. La configuración de encriptación del almacenamiento de la zona |
containerRuntimeConfig |
Es opcional. Es la configuración del entorno de ejecución del contenedor del clúster. |
enableRemoteBackup |
Es opcional. Si es verdadero, se habilitará la función de copia de seguridad y restablecimiento remotos para este clúster. |
enableClusterIsolation |
Es opcional. Esto indica si es necesario aislar el clúster. go/cluster-isolation-in-gdcc-cluster |
googleGroupAuthentication |
Es opcional. Es la configuración de autenticación de Grupos de Google del clúster. |
Flota
Configuración relacionada con la flota.
Las flotas son un concepto de Google Cloud que organiza los clústeres de manera lógica, lo que te permite usar y administrar capacidades de varios clústeres y aplicar políticas coherentes en tus sistemas.
| Representación JSON |
|---|
{ "project": string, "membership": string } |
| Campos | |
|---|---|
project |
Obligatorio. El número del proyecto host de la flota en el que se registrará este clúster. Los nombres de los proyectos tienen el formato |
membership |
Solo salida. El nombre del recurso de membresía del concentrador administrado asociado a este clúster. Los nombres de las membresías tienen el formato |
ClusterNetworking
Configuración de herramientas de redes de todo el clúster.
| Representación JSON |
|---|
{ "clusterIpv4CidrBlocks": [ string ], "servicesIpv4CidrBlocks": [ string ] } |
| Campos | |
|---|---|
clusterIpv4CidrBlocks[] |
Obligatorio. A todos los Pods del clúster se les asigna una dirección IPv4 RFC1918 de estos bloques. Solo se admite un bloque. No se puede cambiar este campo después de crearlo. |
servicesIpv4CidrBlocks[] |
Obligatorio. A todos los servicios del clúster se les asigna una dirección IPv4 RFC1918 de estos bloques. Solo se admite un bloque. No se puede cambiar este campo después de crearlo. |
Autorización
Es la política de RBAC que aplicará y administrará GEC.
| Representación JSON |
|---|
{
"adminUsers": {
object ( |
| Campos | |
|---|---|
adminUsers |
Obligatorio. Usuario al que se le otorgará el rol de administrador de clústeres, lo que le proporcionará acceso completo al clúster. Actualmente, este es un campo único, pero se expandirá para permitir varios administradores en el futuro. |
ClusterUser
Es una principal de usuario para una política de RBAC.
| Representación JSON |
|---|
{ "username": string } |
| Campos | |
|---|---|
username |
Obligatorio. Un nombre de usuario de Google activo |
MaintenancePolicy
Es la configuración de la política de mantenimiento.
| Representación JSON |
|---|
{ "window": { object ( |
| Campos | |
|---|---|
window |
Especifica el período de mantenimiento en el que se puede realizar el mantenimiento. |
maintenanceExclusions[] |
Es opcional. Exclusiones del mantenimiento automático El mantenimiento que no sea de emergencia no debería realizarse en estos períodos. Cada exclusión tiene un nombre único y puede estar activa o vencida. La cantidad máxima de exclusiones de mantenimiento permitidas en un momento determinado es 3. |
MaintenanceWindow
Configuración del período de mantenimiento
| Representación JSON |
|---|
{
"recurringWindow": {
object ( |
| Campos | |
|---|---|
recurringWindow |
Es la configuración de un período de mantenimiento recurrente. |
RecurringTimeWindow
Representa un período arbitrario que se repite.
| Representación JSON |
|---|
{
"window": {
object ( |
| Campos | |
|---|---|
window |
Es el período de la primera recurrencia. |
recurrence |
Una RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) que indica cómo se repite este período. Se extienden durante el intervalo de tiempo entre la hora de inicio y la de finalización. |
TimeWindow
Representa un período arbitrario.
| Representación JSON |
|---|
{ "startTime": string, "endTime": string } |
| Campos | |
|---|---|
startTime |
Es la hora en la que se inicia la ventana por primera vez. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
endTime |
Es la hora en que finaliza el período. La hora de finalización debe ser posterior a la hora de inicio. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
MaintenanceExclusionWindow
Representa un período de exclusión de mantenimiento.
| Representación JSON |
|---|
{
"window": {
object ( |
| Campos | |
|---|---|
window |
Es opcional. Es el período. |
id |
Es opcional. Es un ID único (por clúster) para la ventana. |
ControlPlane
Configuración del plano de control del clúster.
| Representación JSON |
|---|
{ // Union field |
| Campos | |
|---|---|
Campo de unión
|
|
remote |
Configuración del plano de control remoto. |
local |
Configuración del plano de control local. Advertencia: Los clústeres del plano de control local deben crearse en su propio proyecto. Los clústeres del plano de control local no pueden coexistir en el mismo proyecto con ningún otro tipo de clúster, incluidos los que no son de GDCE. Mezclar clústeres de GDCE del plano de control local con cualquier otro tipo de clústeres en el mismo proyecto puede provocar la pérdida de datos. |
Remoto
Este tipo no tiene campos.
Es la configuración específica para los clústeres con un plano de control alojado de forma remota.
Local
Es la configuración específica de los clústeres con un plano de control alojado de forma local.
Advertencia: Los clústeres del plano de control local deben crearse en su propio proyecto. Los clústeres del plano de control local no pueden coexistir en el mismo proyecto con ningún otro tipo de clúster, incluidos los que no son de GDCE. Mezclar clústeres de GDCE del plano de control local con cualquier otro tipo de clústeres en el mismo proyecto puede provocar la pérdida de datos.
| Representación JSON |
|---|
{ "nodeLocation": string, "nodeCount": integer, "machineFilter": string, "sharedDeploymentPolicy": enum (/1.13.0/docs/="/distributed-cloud/connected/latest/docs/reference/container/rest/v1/projects.locations.clusters#SharedDeploymentPolicy">SharedDeploymentPolicy), "controlPlaneNodeStorageSchema": string, "controlPlaneNodeSystemPartitionSize": SystemPartitionGiBSize) } |
| Campos | |
|---|---|
nodeLocation |
Es el nombre de las zonas de Google Distributed Cloud Edge en las que se creará este grupo de nodos. Por ejemplo: |
nodeCount |
Es la cantidad de nodos que se usarán como réplicas del plano de control. |
machineFilter |
Solo las máquinas que coincidan con este filtro podrán alojar nodos del plano de control. El lenguaje de filtrado acepta cadenas como "name= |
sharedDeploymentPolicy |
Es la configuración de la política sobre cómo se implementan las aplicaciones de los usuarios. |
controlPlaneNodeStorageSchema |
Es opcional. Es el nombre del esquema de almacenamiento de los nodos del plano de control. |
controlPlaneNodeSystemPartitionSize |
Es opcional. Es el tamaño de la partición del sistema para los nodos del plano de control en GiB. |
SystemAddonsConfig
Es la configuración que los clientes pueden definir para los complementos del sistema de GDCE.
| Representación JSON |
|---|
{ "ingress": { object ( |
| Campos | |
|---|---|
ingress |
Es opcional. Configuración para Ingress. |
vmServiceConfig |
Es opcional. Configuración para el servicio de VM. |
Entrada
Es la configuración del complemento de Ingress que permite a los clientes crear un objeto Ingress para administrar el acceso externo a los servidores de un clúster. El complemento consta de istiod y istio-ingress.
| Representación JSON |
|---|
{ "disabled": boolean, "ipv4Vip": string } |
| Campos | |
|---|---|
disabled |
Es opcional. Indica si Ingress está inhabilitado. |
ipv4Vip |
Es opcional. VIP de Ingress. |
VMServiceConfig
VMServiceConfig define la configuración del servicio de VM de GDCE.
| Representación JSON |
|---|
{ "vmmEnabled": boolean } |
| Campos | |
|---|---|
vmmEnabled |
Es opcional. Indica si VMM está habilitado. |
ControlPlaneEncryption
Configuración de la compatibilidad con claves de KMS administradas por el cliente para los nodos del plano de control.
| Representación JSON |
|---|
{ "kmsKey": string, "kmsKeyActiveVersion": string, "kmsKeyState": enum ( |
| Campos | |
|---|---|
kmsKey |
Es opcional. La CryptoKey de Cloud KMS, p.ej., projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}, que se usará para proteger los discos del plano de control. Si no se especifica, se usará una clave administrada por Google. |
kmsKeyActiveVersion |
Solo salida. Es la CryptoKeyVersion de Cloud KMS que se usa actualmente para proteger los discos del plano de control. Solo se aplica si se establece kmsKey. |
kmsKeyState |
Solo salida. Disponibilidad de la CryptoKey de Cloud KMS. Si no es |
kmsStatus |
Solo salida. Es el estado de error que devuelve Cloud KMS cuando se usa esta clave. Este campo solo se puede propagar si |
resourceState |
Solo salida. Es el estado actual del recurso asociado a la CMEK. |
Estado
Indica el estado del clúster.
| Enums | |
|---|---|
STATUS_UNSPECIFIED |
Estado desconocido. |
PROVISIONING |
El clúster se está creando. |
RUNNING |
El clúster se creó y se puede usar por completo. |
DELETING |
El clúster se está borrando. |
ERROR |
El estado indica que se produjeron algunos errores mientras se conciliaba o borraba el clúster. |
RECONCILING |
El clúster está en proceso de actualización de versión, entre otras tareas. |
MaintenanceEvent
Un evento de mantenimiento es una operación que podría causar interrupciones temporales en las cargas de trabajo del clúster, incluidas las actualizaciones del clúster impulsadas por Google o iniciadas por el usuario, los cambios en la configuración del clúster iniciados por el usuario que requieren reiniciar los nodos, etcétera.
| Representación JSON |
|---|
{ "uuid": string, "targetVersion": string, "operation": string, "type": enum ( |
| Campos | |
|---|---|
uuid |
Solo salida. UUID del evento de mantenimiento. |
targetVersion |
Solo salida. Es la versión de destino del clúster. |
operation |
Solo salida. Es la operación para ejecutar el evento de mantenimiento. Se especifica en el formato projects/*/locations/*/operations/*. Si el evento de mantenimiento se divide en varias operaciones (p.ej., debido a los períodos de mantenimiento), se registra la más reciente. |
type |
Solo salida. Es el tipo de evento de mantenimiento. |
schedule |
Solo salida. Es el programa del evento de mantenimiento. |
state |
Solo salida. Es el estado del evento de mantenimiento. |
createTime |
Solo salida. Es la hora en la que se creó la solicitud de evento de mantenimiento. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
startTime |
Solo salida. Es la hora en la que comenzó el evento de mantenimiento. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
endTime |
Solo salida. Es la hora en la que finalizó el evento de mantenimiento, ya sea de forma correcta o no. Si el evento de mantenimiento se divide en varios períodos de mantenimiento, endTime solo se actualiza cuando finaliza todo el flujo. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
updateTime |
Solo salida. Es la hora en la que se actualizó el mensaje del evento de mantenimiento. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
Tipo
Indica el tipo de evento de mantenimiento.
| Enums | |
|---|---|
TYPE_UNSPECIFIED |
Sin especificar. |
USER_INITIATED_UPGRADE |
Actualización iniciada por los usuarios. |
GOOGLE_DRIVEN_UPGRADE |
Actualización impulsada por Google. |
Programa
Indica cuándo se debe realizar el evento de mantenimiento.
| Enums | |
|---|---|
SCHEDULE_UNSPECIFIED |
Sin especificar. |
IMMEDIATELY |
Inmediatamente después de recibir la solicitud |
Estado
Indica el estado del evento de mantenimiento.
| Enums | |
|---|---|
STATE_UNSPECIFIED |
Sin especificar. |
RECONCILING |
El evento de mantenimiento está en curso. Es posible que el clúster no se pueda usar. |
SUCCEEDED |
El evento de mantenimiento se completó correctamente. |
FAILED |
Se produjo un error en el evento de mantenimiento. |
ReleaseChannel
Es el canal de versiones al que está suscrito un clúster.
| Enums | |
|---|---|
RELEASE_CHANNEL_UNSPECIFIED |
Es un canal de versiones sin especificar. Se establecerá de forma predeterminada en el canal REGULAR. |
NONE |
Sin canal de versiones |
REGULAR |
Canal de versiones regular. |
SurvivabilityConfig
Configuración de la supervivencia del clúster, p.ej., para el caso en que se pierde la conexión de red.
| Representación JSON |
|---|
{ "offlineRebootTtl": string } |
| Campos | |
|---|---|
offlineRebootTtl |
Es opcional. Es el período que permite que los nodos del clúster se reinicien y se vuelvan funcionales sin conectividad de red a Google. El valor predeterminado 0 significa que no se permite. La cantidad máxima es de 30 días. Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
ConnectionState
ConnectionState contiene el estado de conexión actual del clúster a Google.
| Representación JSON |
|---|
{
"state": enum ( |
| Campos | |
|---|---|
state |
Solo salida. Es el estado actual de la conexión. |
updateTime |
Solo salida. Es la hora en que se cambió el estado de la conexión por última vez. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
Estado
Es el estado de la conexión.
| Enums | |
|---|---|
STATE_UNSPECIFIED |
Estado de conexión desconocido. |
DISCONNECTED |
Este clúster está desconectado de Google. |
CONNECTED |
Este clúster está conectado a Google. |
CONNECTED_AND_SYNCING |
Este clúster está conectado a Google, pero es posible que se haya vuelto a conectar recientemente después de una desconexión. Aún se está sincronizando. |
ExternalLoadBalancerPool
Grupo de balanceador de cargas externos con configuración personalizada, como nombre, asignación manual o automática, IPv4 que no se superpone y rango de direcciones IPv6 opcional.
| Representación JSON |
|---|
{ "addressPool": string, "ipv4Range": [ string ], "ipv6Range": [ string ], "avoidBuggyIps": boolean, "manualAssign": boolean } |
| Campos | |
|---|---|
addressPool |
Es opcional. Es el nombre del grupo de balanceador de cargas externos. |
ipv4Range[] |
Obligatorio. Es el rango de direcciones IPv4 que no se superpone del grupo de balanceador de cargas externos. |
ipv6Range[] |
Es opcional. Rango de direcciones IPv6 que no se superpone del grupo de balanceador de cargas externos. |
avoidBuggyIps |
Es opcional. Si es verdadero, el grupo omite las direcciones IP que terminan en .0 y .255. Algunos hardware de red descartan el tráfico hacia estas direcciones especiales. Su valor predeterminado es falso. |
manualAssign |
Es opcional. Si es verdadero, las direcciones de este grupo no se asignan automáticamente a los servicios de Kubernetes. Si es verdadero, una dirección IP en este grupo se usa solo cuando un servicio lo especifica de manera explícita. Su valor predeterminado es falso. |
ZoneStorageEncryption
Configuración de la compatibilidad con CMEK para el almacenamiento zonal
| Representación JSON |
|---|
{
"kmsKey": string,
"kmsKeyActiveVersion": string,
"resourceState": enum ( |
| Campos | |
|---|---|
kmsKey |
Es opcional. La clave de Cloud KMS |
kmsKeyActiveVersion |
Solo salida. La CryptoKeyVersion de Cloud KMS que se usa actualmente para la encriptación y desencriptación |
resourceState |
Solo salida. El estado actual del recurso de la CMEK |
ContainerRuntimeConfig
Es la configuración del entorno de ejecución del contenedor del clúster.
| Representación JSON |
|---|
{ "defaultContainerRuntime": enum /1.13.0/docs/f="/distributed-cloud/connected/latest/docs/reference/container/rest/v1/projects.locations.clusters#DefaultContainerRuntime">DefaultContainerRuntime) } |
| Campos | |
|---|---|
defaultContainerRuntime |
Es opcional. Es el entorno de ejecución de contenedores predeterminado que se configurará en el clúster. |
DefaultContainerRuntime
Es la lista de entornos de ejecución de contenedores compatibles.
| Enums | |
|---|---|
DEFAULT_CONTAINER_RUNTIME_UNSPECIFIED |
No se especificó el entorno de ejecución del contenedor. |
RUNC |
Usa runc como el entorno de ejecución de contenedores predeterminado en el clúster. |
GVISOR |
Usa gVisor como el entorno de ejecución de contenedores predeterminado en el clúster. |
GoogleGroupAuthenticationConfig
Es la configuración de autenticación de Grupos de Google del clúster. go/gdc-google-group-authentication
| Representación JSON |
|---|
{ "enable": boolean } |
| Campos | |
|---|---|
enable |
Es opcional. Si es verdadero, el clúster se configurará para usar la autenticación de Grupos de Google. |
Métodos |
|
|---|---|
|
Crea un clúster nuevo en un proyecto y una ubicación determinados. |
|
Borra un solo clúster. |
|
Genera un token de acceso para un clúster. |
|
Genera una credencial sin conexión para un clúster. |
|
Obtiene detalles de un solo clúster. |
|
Enumera los clústeres en una ubicación y un proyecto determinados. |
|
Actualiza los parámetros de un solo clúster. |
|
Actualiza un solo clúster. |