Instale o AlloyDB Omni no Kubernetes

Selecione uma versão da documentação:

Esta página fornece 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. Não usa a CLI AlloyDB Omni, que se destina a implementações em máquinas Linux individuais e não em clusters do 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 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 ficheiro de instalação do AlloyDB Omni Operator transferido eliminando-o. 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 do AlloyDB Omni no cluster do Kubernetes, pode criar um cluster de base de dados do 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?