Usar um contêiner sidecar no Kubernetes

Selecione uma versão da documentação:

Se o banco de dados for executado em um cluster do Kubernetes, você poderá adicionar contêineres de arquivo secundário ao cluster de banco de dados usando o operador do AlloyDB Omni Kubernetes. Os contêineres de arquivo secundário do operador do AlloyDB Omni são contêineres normais do Kubernetes que são executados de forma independente ao lado do contêiner principal do aplicativo no mesmo pod. É possível usar esses contêineres de arquivo secundário para atender solicitações de monitoramento, registro e rastreamento de aplicativos.

Os contêineres de arquivo secundário do operador do AlloyDB Omni são diferentes dos contêineres de arquivo secundário integrados do Kubernetes.

Para adicionar manualmente um contêiner de arquivo secundário a uma instalação do AlloyDB Omni, crie um recurso personalizado (CR, na sigla em inglês) de arquivo secundário e adicione-o ao cluster de banco de dados.

Criar um CR de arquivo secundário

  1. Aplique o seguinte manifesto:

    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

    Substitua as seguintes variáveis:

    • SIDECAR_CR_NAME: o nome do contêiner de arquivo secundário.
    • CONTAINER_IMAGE: o nome do arquivo de imagem a ser executado no contêiner de arquivo secundário. Por exemplo, busybox.
    • CONTAINER_COMMAND: o comando do contêiner executado no pod. O comando pode ser uma lista de strings entre aspas. Para mais informações, consulte Definir um comando e argumentos ao criar um pod.
    • CONTAINER_ARGS: argumentos para CONTAINER_COMMAND.
    • CONTAINER_NAME: o nome do contêiner. É possível ter vários contêineres no mesmo CR de arquivo secundário, e cada contêiner tem um nome, imagem, comando e argumentos diferentes.

  2. Para verificar se o CR de arquivo secundário foi criado, execute o seguinte comando:

    kubectl describe Sidecar/SIDECAR_CR_NAME

    O resultado será assim:

    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 um contêiner de arquivo secundário

Para registrar o nome do contêiner de arquivo secundário no cluster de banco de dados, use o seguinte comando para aplicar a especificação atualizada:

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

Substitua as seguintes variáveis:

  • DB_CLUSTER_NAME: o nome do cluster de banco de dados.
  • SIDECAR_CR_NAME: o nome do contêiner de arquivo secundário.

Acessar registros de um contêiner de arquivo secundário

  1. Crie ou modifique um contêiner de arquivo secundário para que spec.sidecars.volumeMounts.name seja definido como obsdisk e spec.sidecars.volumeMounts.mountPath como um caminho visível no contêiner de arquivo secundário.

      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

    Substitua:

    • SIDECAR_CR_NAME: o nome do contêiner de arquivo secundário.
    • CONTAINER_IMAGE: o nome do arquivo de imagem a ser executado no contêiner de arquivo secundário. Por exemplo, busybox.
    • CONTAINER_COMMAND: o comando do contêiner executado no pod. O comando pode ser uma lista de strings entre aspas. Para mais informações, consulte Definir um comando e argumentos ao criar um pod.
    • CONTAINER_ARGS: os argumentos para CONTAINER_COMMAND.
    • CONTAINER_NAME: o nome do contêiner. É possível ter vários contêineres no mesmo CR de arquivo secundário, e cada contêiner tem um nome, imagem, comando e argumentos diferentes.
    • LOGS_PATH: o caminho no contêiner de arquivo secundário em que o AlloyDB Omni precisa gerar registros.

  2. Registre o contêiner de arquivo secundário novo ou modificado.

A seguir