Usar un contenedor sidecar en Kubernetes

Selecciona una versión de la documentación:

Si tu base de datos se ejecuta en un clúster de Kubernetes, puedes añadir contenedores sidecar a tu clúster de base de datos. Los contenedores sidecar se ejecutan de forma independiente junto al contenedor principal y atienden solicitudes de monitorización, registro y trazado de aplicaciones. Puedes exportar registros, métricas y trazas al backend que elijas mediante agentes personalizados a AlloyDB Omni.

Si tu base de datos se ejecuta en un clúster de Kubernetes, puedes añadir contenedores sidecar a tu clúster de base de datos mediante el operador AlloyDB Omni Kubernetes. Los contenedores sidecar del operador de AlloyDB Omni son contenedores de Kubernetes normales que se ejecutan de forma independiente junto al contenedor de la aplicación principal en el mismo pod. Puedes usar estos contenedores sidecar para atender solicitudes de monitorización, registro y seguimiento de aplicaciones.

Los contenedores sidecar del operador de AlloyDB Omni son distintos de los contenedores sidecar integrados de Kubernetes.

Para añadir manualmente un contenedor sidecar a una instalación de AlloyDB Omni, crea un recurso personalizado (CR) sidecar y añádelo a tu clúster de base de datos.

Crear un CR de sidecar

  1. Aplica el siguiente archivo de manifiesto:

    apiVersion: alloydbomni.dbadmin.goog/v1
kind: Sidecar
metadata:
 name: SIDECAR_CR_NAME
spec:
 sidecars:
 — image: CONTAINER_IMAGE
   command: ["CONTAINER_COMMAND"]
   args: ["CONTAINER_ARGS"]
   name: CONTAINER_NAME

    Haz los cambios siguientes:

    • SIDECAR_CR_NAME: el nombre que se aplicará al contenedor secundario.
    • CONTAINER_IMAGE: el nombre del archivo que contiene la imagen que se va a ejecutar en el contenedor sidecar. Por ejemplo, busybox.
    • CONTAINER_COMMAND: el comando del contenedor que se ejecuta en el pod. El comando puede ser una lista de cadenas entre comillas. Para obtener más información, consulta Definir un comando y argumentos al crear un pod.
    • CONTAINER_ARGS: los argumentos del comando del contenedor que se ejecuta en el pod.
    • CONTAINER_NAME: el nombre del contenedor. Puedes tener varios contenedores en el mismo CR sidecar y cada contenedor tiene un nombre, una imagen, un comando y unos argumentos diferentes.

  2. Para verificar que se ha creado el CR sidecar, ejecuta el siguiente comando:

    kubectl describe SIDECAR_CR_NAME

    El resultado debería ser similar al siguiente:

    Name:  SIDECAR_CR_NAME
Labels:       <none>
Annotations:  <none>
API Version:  alloydbomni.dbadmin.goog/v1
Kind:         Sidecar
Metadata:
  Creation Timestamp:  2024-04-15T21:49:00Z
  Finalizers:
    sidecars.dbadmin.goog/finalizer
  Generation:        2
  Resource Version:  2561336
  UID:               e57f2e13-20c5-4905-b13b-39203bab36b4
Spec:
  Sidecars:
    Args:
      CONTAINER_ARGS
    Command:
      CONTAINER_COMMAND
    Image:  CONTAINER_IMAGE
    Name:   CONTAINER_NAME
    Resources:
Status:
  Observed Generation:  2
  Reconciled:           true
Events:                 <none>

Registrar un contenedor secundario

Para registrar el nombre del contenedor sidecar en tu clúster de base de datos, sigue estos pasos:

  1. Añade el atributo sidecarRef a la especificación del objeto spec de tu clúster de base de datos en su archivo de manifiesto:

    sidecarRef:
  name: SIDECAR_CR_NAME

  2. Usa el siguiente comando para aplicar la especificación actualizada:

      kubectl patch dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -p '{"spec":{"primarySpec":{"sidecarRef":{"name":SIDECAR_CR_NAME}}}}' --type=merge

    Haz los cambios siguientes:

    • DB_CLUSTER_NAME: el nombre de tu clúster de bases de datos.
    • SIDECAR_CR_NAME: el nombre que se aplicará al contenedor secundario.

Siguientes pasos