Utilizzare un contenitore sidecar in Kubernetes

Se il database viene eseguito in un cluster Kubernetes, puoi aggiungere contenitori sidecar al cluster del database utilizzando l'operatore Kubernetes di AlloyDB Omni. I container sidecar dell'operatore AlloyDB Omni sono container Kubernetes regolari che vengono eseguiti in modo indipendente insieme al container dell'applicazione principale nello stesso pod. Puoi utilizzare questi container sidecar per gestire le richieste di monitoraggio, registrazione e monitoraggio delle applicazioni.

I container sidecar dell'operatore AlloyDB Omni sono diversi dai container sidecar integrati di Kubernetes.

Per aggiungere manualmente un contenitore sidecar a un'installazione AlloyDB Omni esistente, crea una risorsa personalizzata (CR) sidecar e aggiungila al cluster del database.

Crea un report di assistenza secondario

  1. Applica il seguente manifest:

    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

    Sostituisci le seguenti variabili:

    • SIDECAR_CR_NAME: il nome del contenitore sidecar.
    • CONTAINER_IMAGE: il nome del file immagine da eseguire nel contenitore sidecar. Ad esempio, busybox.
    • CONTAINER_COMMAND: il comando per il contenitore in esecuzione nel pod. Il comando può essere un elenco di stringhe tra virgolette. Per saperne di più, consulta Definire un comando e gli argomenti quando crei un pod.
    • CONTAINER_ARGS: argomenti per CONTAINER_COMMAND.
    • CONTAINER_NAME: il nome del contenitore. Puoi avere più container nello stesso CR sidecar e ogni container ha un nome, un'immagine, un comando e argomenti diversi.

  2. Per verificare che il CR sidecar sia stato creato, esegui il seguente comando:

    kubectl describe Sidecar/SIDECAR_CR_NAME

    L'output è simile al seguente:

    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>

Registra un contenitore sidecar

Per registrare il nome del contenitore sidecar al cluster di database, utilizza il seguente comando per applicare la specifica aggiornata:

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

Sostituisci le seguenti variabili:

  • DB_CLUSTER_NAME: il nome del cluster di database.
  • SIDECAR_CR_NAME: il nome del contenitore sidecar.

Accedere ai log da un contenitore sidecar

  1. Crea o modifica un contenitore sidecar esistente in modo che spec.sidecars.volumeMounts.name sia impostato su obsdisk e spec.sidecars.volumeMounts.mountPath su un percorso visibile all'interno del contenitore sidecar.

      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
      volumeMounts:
        - name: obsdisk
          mountPath: LOGS_PATH

    Sostituisci quanto segue:

    • SIDECAR_CR_NAME: il nome del contenitore sidecar.
    • CONTAINER_IMAGE: il nome del file immagine da eseguire nel contenitore sidecar. Ad esempio, busybox.
    • CONTAINER_COMMAND: il comando per il container che viene eseguito nel pod. Il comando può essere un elenco di stringhe tra virgolette. Per ulteriori informazioni, consulta Definire un comando e gli argomenti quando crei un pod.
    • CONTAINER_ARGS: gli argomenti per CONTAINER_COMMAND.
    • CONTAINER_NAME: il nome del contenitore. Puoi avere più container nella stessa risorsa di controllo sidecar e ogni container ha un nome, un'immagine, un comando e argomenti diversi.
    • LOGS_PATH: il percorso all'interno del contenitore sidecar in cui AlloyDB Omni deve generare i log.

  2. Registra il contenitore sidecar nuovo o modificato.

Passaggi successivi