- Recurso: Cluster
- Fleet
- ClusterNetworking
- Autorización
- ClusterUser
- MaintenancePolicy
- Período de mantenimiento
- RecurringTimeWindow
- TimeWindow
- MaintenanceExclusionWindow
- ControlPlane
- Remote
- Local
- SharedDeploymentPolicy
- SystemAddonsConfig
- Ingress
- VMServiceConfig
- ControlPlaneEncryption
- Estado
- MaintenanceEvent
- Tipo
- Programa
- Estado
- ReleaseChannel
- SurvivabilityConfig
- ConnectionState
- Estado
- ExternalLoadBalancerPool
- ZoneStorageEncryption
- Métodos
Recurso: Cluster
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. |
create |
Solo salida. Es la fecha y hora en que se creó el clúster. Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
update |
Solo salida. Fecha y hora en la que se actualizó el clúster por última vez. Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
labels |
Son las etiquetas asociadas a 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. |
default |
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. |
cluster |
Solo salida. Es el certificado público de la CA del clúster codificado con PEM. |
maintenance |
Es opcional. Es la configuración de la política de mantenimiento de todo el clúster. |
control |
Solo salida. Versión de lanzamiento del plano de control |
node |
Solo salida. Es la versión de lanzamiento más baja entre todos los nodos trabajadores. Este campo puede estar vacío si el clúster no tiene nodos de trabajador. |
control |
Es opcional. Es la configuración del plano de control del clúster. |
system |
Es opcional. Es la configuración de los complementos del sistema. |
external |
Es opcional. Son grupos de direcciones IPv4 para el balanceo de cargas externo del plano de datos del clúster. |
control |
Es opcional. Son opciones de encriptación de disco 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. |
maintenance |
Solo salida. Todos los eventos de mantenimiento programados para el clúster, incluidos los que están en curso, los que se planificaron para el futuro y los que se realizaron en el pasado (hasta 90 días). |
target |
Es opcional. Es la versión del clúster de destino. Por ejemplo, “1.5.0”. |
release |
Es opcional. Es el canal de versiones al que está suscrito un clúster. |
survivability |
Es opcional. Configuración de la capacidad de supervivencia del clúster, p. ej., para el caso en que se pierde la conectividad de red Nota: Esto solo se aplica a los clústeres del plano de control local. |
external |
Es opcional. Son grupos de direcciones IPv6 para el balanceo de cargas externo del plano de datos del clúster. |
connection |
Solo salida. Es el estado de conexión actual del clúster. |
external |
Es opcional. Son los grupos del balanceador de cargas externo para el clúster. |
zone |
Es opcional. Es la configuración de encriptación del almacenamiento de la zona. |
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 | |
|---|---|
cluster |
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. |
services |
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 | |
|---|---|
admin |
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 un 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. |
maintenance |
Es opcional. Son las exclusiones del mantenimiento automático. El mantenimiento que no sea de emergencia no debe ocurrir 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 | |
|---|---|
recurring |
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 |
Es 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 período comprendido entre la hora de inicio y la hora de finalización. |
TimeWindow
Representa un período arbitrario.
| Representación JSON |
|---|
{ "startTime": string, "endTime": string } |
| Campos | |
|---|---|
start |
Es la hora en la que comienza el período. Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
end |
Es la fecha y hora en que finaliza el período. La hora de finalización debe ser posterior a la de inicio. Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. 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
Es la configuración del plano de control del clúster.
| Representación JSON |
|---|
{ // Union field |
| Campos | |
|---|---|
Campo de unión
|
|
remote |
Es la configuración del plano de control remoto. |
local |
Es la configuración del plano de control local. Advertencia: Los clústeres de plano de control local se deben crear en su propio proyecto. Los clústeres de plano de control local no pueden coexistir en el mismo proyecto con ningún otro tipo de clústeres, incluidos los que no son de GDCE. Mezclar clústeres de GDCE de 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 de los clústeres con un plano de control alojado de forma remota.
Local
Es la configuración específica para los clústeres con un plano de control alojado de forma local.
Advertencia: Los clústeres de plano de control local se deben crear en su propio proyecto. Los clústeres de plano de control local no pueden coexistir en el mismo proyecto con ningún otro tipo de clústeres, incluidos los que no son de GDCE. Mezclar clústeres de GDCE de 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 ( |
| Campos | |
|---|---|
node |
Nombre de las zonas de Google Distributed Cloud Edge en las que se creará este grupo de nodos. Por ejemplo: |
node |
Es la cantidad de nodos que funcionarán como réplicas del plano de control. |
machine |
Solo se permitirá que las máquinas que coincidan con este filtro alojen nodos del plano de control. El lenguaje de filtrado acepta cadenas como "name= |
shared |
Es la configuración de la política sobre cómo se implementan las aplicaciones del usuario. |
control |
Es opcional. Nombre del esquema de almacenamiento de los nodos del plano de control. Advertencia: La función de esquema de almacenamiento local del nodo configurable es experimental y no se recomienda para el uso general en clústeres o grupos de nodos de producción. |
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. Es la configuración de Ingress. |
vm |
Es opcional. Es la configuración del 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. |
ipv4 |
Es opcional. Es la VIP de entrada. |
VMServiceConfig
VMServiceConfig define la configuración del servicio de VM de GDCE.
| Representación JSON |
|---|
{ "vmmEnabled": boolean } |
| Campos | |
|---|---|
vmm |
Es opcional. Indica si el VMM está habilitado. |
ControlPlaneEncryption
Es la configuración de la compatibilidad con la clave de KMS administrada por el cliente para los nodos del plano de control.
| Representación JSON |
|---|
{ "kmsKey": string, "kmsKeyActiveVersion": string, "kmsKeyState": enum ( |
| Campos | |
|---|---|
kms |
Es opcional. Es la clave criptográfica 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. |
kms |
Solo salida. Es la versión de CryptoKey de Cloud KMS que se usa actualmente para proteger los discos del plano de control. Solo se aplica si se configura kmsKey. |
kms |
Solo salida. Disponibilidad de la CryptoKey de Cloud KMS. Si no es |
kms |
Solo salida. Es el estado de error que devuelve Cloud KMS cuando se usa esta clave. Este campo solo se puede completar si |
resource |
Solo salida. Es el estado actual del recurso asociado con 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 durante la conciliación o el borrado del clúster. |
RECONCILING |
El clúster está en proceso de actualización de versión, etc. |
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 iniciadas por Google o por el usuario, los cambios en la configuración del clúster iniciados por el usuario que requieren el reinicio de los nodos, etcétera.
| Representación JSON |
|---|
{ "uuid": string, "targetVersion": string, "operation": string, "type": enum ( |
| Campos | |
|---|---|
uuid |
Solo salida. Es el UUID del evento de mantenimiento. |
target |
Solo salida. Es la versión de destino del clúster. |
operation |
Solo salida. 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 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. |
create |
Solo salida. Es la fecha y hora en que se creó la solicitud del evento de mantenimiento. Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
start |
Solo salida. Es la fecha y hora en que comenzó el evento de mantenimiento. Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
end |
Solo salida. Es la fecha y hora en que finalizó el evento de mantenimiento, ya sea que se haya completado correctamente 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 estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
update |
Solo salida. Es la fecha y hora en que se actualizó el mensaje del evento de mantenimiento. Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. 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. |
Programar
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 |
El evento de mantenimiento falló. |
ReleaseChannel
Es el canal de versiones al que está suscrito un clúster.
| Enums | |
|---|---|
RELEASE_CHANNEL_UNSPECIFIED |
Canal de versiones sin especificar. De forma predeterminada, se seleccionará el canal REGULAR. |
NONE |
No hay canal de versiones. |
REGULAR |
Canal de versiones regular. |
SurvivabilityConfig
Configuración de la capacidad de supervivencia del clúster, p. ej., para el caso en que se pierde la conectividad de red
| Representación JSON |
|---|
{ "offlineRebootTtl": string } |
| Campos | |
|---|---|
offline |
Es opcional. Período que permite que los nodos del clúster se reinicien y funcionen sin conectividad de red a Google. El valor predeterminado 0 significa que no se permite. La cantidad máxima es de 7 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 de conexión actual. |
update |
Solo salida. Es la fecha y 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 estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. 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 |
Actualmente, este clúster está desconectado de Google. |
CONNECTED |
Actualmente, este clúster está conectado a Google. |
CONNECTED_AND_SYNCING |
Actualmente, 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
Es un grupo de balanceador de cargas externo con configuración personalizada, como nombre, asignación manual o automática, IPv4 no superpuesta y rango de direcciones IPv6 opcional.
| Representación JSON |
|---|
{ "addressPool": string, "ipv4Range": [ string ], "ipv6Range": [ string ], "avoidBuggyIps": boolean, "manualAssign": boolean } |
| Campos | |
|---|---|
address |
Es opcional. Nombre del grupo del balanceador de cargas externo. |
ipv4 |
Obligatorio. Es el rango de direcciones IPv4 que no se superponen del grupo de balanceador de cargas externos. |
ipv6 |
Es opcional. Es el rango de direcciones IPv6 que no se superponen del grupo de balanceador de cargas externos. |
avoid |
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. |
manual |
Es opcional. Si es verdadero, las direcciones en 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 para la compatibilidad con CMEK de Zone Storage
| Representación JSON |
|---|
{
"kmsKey": string,
"kmsKeyActiveVersion": string,
"resourceState": enum ( |
| Campos | |
|---|---|
kms |
Es opcional. La clave de Cloud KMS |
kms |
Solo salida. Es la versión de CryptoKey de Cloud KMS que se usa actualmente para la encriptación o desencriptación. |
resource |
Solo salida. Estado actual del recurso de CMEK |
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 clústeres en una ubicación y un proyecto determinados. |
|
Actualiza los parámetros de un solo clúster. |
|
Actualiza un solo clúster. |