Instale o AlloyDB Omni no Kubernetes

Selecione uma versão da documentação:

Esta página oferece uma vista geral do operador do Kubernetes do AlloyDB Omni, com instruções para o usar para implementar o AlloyDB Omni num cluster do Kubernetes. Esta página pressupõe uma familiaridade básica com o funcionamento do Kubernetes.

Para ver instruções sobre como instalar o AlloyDB Omni num ambiente Linux padrão, consulte o artigo Instale o AlloyDB Omni.

Vista geral

Para implementar o AlloyDB Omni num cluster do Kubernetes, instale o AlloyDB Omni Operator, uma extensão da API Kubernetes fornecida pela Google.

Configura e controla um cluster de base de dados AlloyDB Omni baseado em Kubernetes associando ficheiros de manifesto declarativos ao utilitário kubectl, tal como qualquer outra implementação baseada em Kubernetes.

Antes de começar

Precisa de acesso ao seguinte:

Cada nó no cluster do Kubernetes tem de ter o seguinte:

  • Um mínimo de duas CPUs x86 ou AMD64.
  • No mínimo, 8 GB de RAM.
  • Versão 4.18 ou posterior do kernel do Linux.
  • Grupo de controlo v2 (cgroup v2) ativado.

Use gráficos Helm

Pode usar gráficos Helm do repositório alloydb-omni-samples para implementar os componentes apresentados neste guia.

Instale o operador do AlloyDB Omni

Para instalar o AlloyDB Omni Operator, siga estes passos:

  1. Defina várias variáveis de ambiente:

    export GCS_BUCKET=alloydb-omni-operator
export HELM_PATH=$(gcloud storage cat gs://$GCS_BUCKET/latest)
export OPERATOR_VERSION="${HELM_PATH%%/*}"

  2. Transfira o operador do AlloyDB Omni:

    gcloud storage cp gs://$GCS_BUCKET/$HELM_PATH ./ --recursive

  3. Instale o operador do AlloyDB Omni:

    helm install alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
--create-namespace \
--namespace alloydb-omni-system \
--atomic \
--timeout 5m

    A instalação bem-sucedida apresenta o seguinte resultado:

    NAME: alloydbomni-operator
LAST DEPLOYED: CURRENT_TIMESTAMP
NAMESPACE: alloydb-omni-system
STATUS: deployed
REVISION: 1
TEST SUITE: None

  4. Limpe o sistema eliminando o ficheiro de instalação do AlloyDB Omni Operator transferido. O ficheiro chama-se alloydbomni-operator-VERSION_NUMBER.tgz e encontra-se no diretório de trabalho atual.

Crie um cluster de base de dados

Um cluster de base de dados do AlloyDB Omni contém todos os recursos de armazenamento e computação necessários para executar um servidor do AlloyDB Omni, incluindo o servidor principal, todas as réplicas e todos os seus dados.

Depois de instalar o operador AlloyDB Omni no cluster do Kubernetes, pode criar um cluster de base de dados AlloyDB Omni no cluster do Kubernetes aplicando um manifesto semelhante ao seguinte:

apiVersion: v1
kind: Secret
metadata:
  name: db-pw-DB_CLUSTER_NAME
type: Opaque
data:
  DB_CLUSTER_NAME: "ENCODED_PASSWORD"
---
apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
  name: DB_CLUSTER_NAME
spec:
  databaseVersion: "15.5.2"
  primarySpec:
    adminUser:
      passwordRef:
        name: db-pw-DB_CLUSTER_NAME
    resources:
      cpu: CPU_COUNT
      memory: MEMORY_SIZE
      disks:
      - name: DataDisk
        size: DISK_SIZE
        storageClass: standard

Substitua o seguinte:

  • DB_CLUSTER_NAME: o nome deste cluster de base de dados, por exemplo, my-db-cluster.

  • ENCODED_PASSWORD: a palavra-passe de início de sessão na base de dados para a função de utilizador postgres predefinida, codificada como uma string base64, por exemplo, Q2hhbmdlTWUxMjM= para ChangeMe123.

  • CPU_COUNT: o número de CPUs disponíveis para cada instância da base de dados neste cluster de base de dados.

  • MEMORY_SIZE: a quantidade de memória por instância da base de dados deste cluster de base de dados. Recomendamos que defina esta opção para 8 gigabytes por CPU. Por exemplo, se definir cpu como 2 anteriormente neste manifesto, recomendamos que defina memory como 16Gi.

  • DISK_SIZE: o tamanho do disco por instância da base de dados, por exemplo, 10Gi.

Depois de aplicar este manifesto, o cluster do Kubernetes contém um cluster de base de dados do AlloyDB Omni com a configuração de memória, CPU e armazenamento especificada. Para estabelecer uma ligação de teste com o novo cluster de base de dados, consulte o artigo Estabeleça ligação através do psql pré-instalado.

Para mais informações sobre os manifestos do Kubernetes e como aplicá-los, consulte o artigo Gerir recursos.

O que se segue?