Instale o AlloyDB Omni no Kubernetes

Selecione uma versão da documentação: 16.3.0

• Atual (16.8.0)
• 16.8.0
• 16.3.0
• 15.12.0
• 15.7.1
• 15.7.0
• 15.5.5
• 15.5.4
• 15.5.2

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 operador do AlloyDB Omni, 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.

Imagem base

A partir da versão 1.5.0, as imagens do Kubernetes do operador do AlloyDB Omni são criadas com base na Universal Base Image (UBI) 9 da Red Hat. Esta transição melhora a segurança, a consistência e a conformidade das suas implementações.

Compatibilidade com o operador 1.1.0 (e posterior) do AlloyDB Omni

A versão 1.1.0 do operador do AlloyDB Omni não é compatível com as versões 15.5.3 e 15.5.4 do AlloyDB Omni. Se usar uma destas versões do AlloyDB Omni, pode receber um erro semelhante ao seguinte:

Error from server (Forbidden): error when creating "[...]/dbcluster.yaml": admission webhook "vdbcluster.alloydbomni.dbadmin.goog" denied the request: unsupported database version 15.5.3

Nota: para implementar o AlloyDB Omni num cluster do Kubernetes com o operador do AlloyDB Omni 1.1.0, use a versão 15.5.5 ou posterior do AlloyDB Omni.

Antes de começar

Antes de instalar o AlloyDB Omni num cluster do Kubernetes com o operador do AlloyDB Omni, certifique-se de que cumpre os seguintes requisitos.

Escolha uma opção de transferência ou instalação

Escolha uma das seguintes opções de transferência e instalação:

Multimédia	Localizações de transferência e guias de instalação	Implementação para
Operador do OpenShift com pacote OLM	Openshift Container Platform Web Console	Ambiente do OpenShift
Operador do Kubernetes com pacote OLM	Artifacthub.io	Traga o seu próprio ambiente de contentores Kubernetes, por exemplo, nas instalações, em nuvens públicas, no Google Kubernetes Engine, no Amazon EKS e no Azure AKS.
Operador do Kubernetes com o gráfico Helm	Instale o AlloyDB Omni no Kubernetes (esta página)	Traga o seu próprio ambiente de contentores Kubernetes, por exemplo, no local, nuvens públicas, GKE, Amazon EKS e Azure AKS.

Valide o acesso

Confirme se tem acesso ao seguinte:

• Um cluster do Kubernetes que executa o seguinte software:
  • Versão 1.21 ou posterior do Kubernetes.
  • O serviço cert-manager.
• O utilitário kubectl.
• O gestor de pacotes helm ou o Operator Lifecycle Manager.
• A CLI do Google Cloud. Depois de instalar a CLI gcloud, tem de autenticar a sua conta Google Cloud executando gcloud auth login.

Cumprir os requisitos de hardware e software

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 (cgroup) v2 ativado.

Instale o operador do AlloyDB Omni

Nota: se quiser implementar o AlloyDB Omni no seu ambiente de produção, consulte o artigo Executar o AlloyDB Omni em produção.

Pode instalar o operador do AlloyDB Omni através de diferentes métodos, incluindo o Helm e o Operator Lifecycle Manager (OLM).

Leme

Para instalar o operador do AlloyDB Omni, siga estes passos:

1. Defina as seguintes 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. Para limpar, elimine o ficheiro de instalação do operador do AlloyDB Omni transferido. O ficheiro chama-se alloydbomni-operator-VERSION_NUMBER.tgz e encontra-se no seu diretório de trabalho atual.

OLM

Para instalar o operador do AlloyDB Omni através do Operator Lifecycle Manager, siga estes passos:

1. Navegue até https://operatorhub.io/operator/alloydb-omni-operator.

2. Clique no botão Instalar para ver as instruções.

3. Conclua todos os passos de instalação.

4. Depois de instalar o operador do AlloyDB Omni, crie manualmente os recursos do cert-manager no cluster. Este campo é obrigatório. Use estes comandos:

   kubectl create ns ${NAMESPACE:?}
   kubectl apply -f - <<EOF
   apiVersion: cert-manager.io/v1
   kind: ClusterIssuer
   metadata:
     name: alloydbomni-selfsigned-cluster-issuer
   spec:
     selfSigned: {}
   ---
   apiVersion: cert-manager.io/v1
   kind: Issuer
   metadata:
     name: fleet-selfsigned-issuer
     namespace: ${NAMESPACE:?}
   spec:
     selfSigned: {}
   ---
   apiVersion: cert-manager.io/v1
   kind: Certificate
   metadata:
     name: fleet-serving-cert
     namespace: ${NAMESPACE:?}
   spec:
     dnsNames:
     - fleet-webhook-service.alloydb-omni-system.svc
     - fleet-webhook-service.alloydb-omni-system.svc.cluster.local
     issuerRef:
       kind: Issuer
       name: fleet-selfsigned-issuer
     secretName: fleet-webhook-server-cert
   ---
   apiVersion: cert-manager.io/v1
   kind: Issuer
   metadata:
     name: local-selfsigned-issuer
     namespace: ${NAMESPACE:?}
   spec:
     selfSigned: {}
   ---
   apiVersion: cert-manager.io/v1
   kind: Certificate
   metadata:
     name: local-serving-cert
     namespace: ${NAMESPACE:?}
   spec:
     dnsNames:
     - local-webhook-service.alloydb-omni-system.svc
     - local-webhook-service.alloydb-omni-system.svc.cluster.local
     issuerRef:
       kind: Issuer
       name: local-selfsigned-issuer
     secretName: local-webhook-server-cert
   EOF

   Substitua NAMESPACE pelo espaço de nomes onde tem o seu operador, por exemplo, alloydb-omni-system.

OLM

Nota: tem de ativar o community-operators CatalogSource porque o operador AlloyDB Omni está disponível apenas como um operador da comunidade. A documentação da Red Hat indica que pode desativar o catálogo da comunidade, se necessário.

Para instalar o operador do AlloyDB Omni no seu ambiente do Red Hat OpenShift através do OLM, inicie sessão na consola Web do Red Hat OpenShift.

1. Selecione Operadores > OperatorHub.

2. Encontre o operador do AlloyDB Omni através do campo de pesquisa.

   
   Figura 1: o operador AlloyDB Omni no OperatorHub

3. No painel do operador do AlloyDB Omni, clique em Instalar.

   
   Figura 2: o painel do operador do AlloyDB Omni

4. Depois de instalar o operador do AlloyDB Omni, crie manualmente os recursos do cert-manager no cluster. Este campo é obrigatório. Use estes comandos:

   kubectl create ns ${NAMESPACE:?}
   kubectl apply -f - <<EOF
   apiVersion: cert-manager.io/v1
   kind: ClusterIssuer
   metadata:
     name: alloydbomni-selfsigned-cluster-issuer
   spec:
     selfSigned: {}
   ---
   apiVersion: cert-manager.io/v1
   kind: Issuer
   metadata:
     name: fleet-selfsigned-issuer
     namespace: ${NAMESPACE:?}
   spec:
     selfSigned: {}
   ---
   apiVersion: cert-manager.io/v1
   kind: Certificate
   metadata:
     name: fleet-serving-cert
     namespace: ${NAMESPACE:?}
   spec:
     dnsNames:
     - fleet-webhook-service.alloydb-omni-system.svc
     - fleet-webhook-service.alloydb-omni-system.svc.cluster.local
     issuerRef:
       kind: Issuer
       name: fleet-selfsigned-issuer
     secretName: fleet-webhook-server-cert
   ---
   apiVersion: cert-manager.io/v1
   kind: Issuer
   metadata:
     name: local-selfsigned-issuer
     namespace: ${NAMESPACE:?}
   spec:
     selfSigned: {}
   ---
   apiVersion: cert-manager.io/v1
   kind: Certificate
   metadata:
     name: local-serving-cert
     namespace: ${NAMESPACE:?}
   spec:
     dnsNames:
     - local-webhook-service.alloydb-omni-system.svc
     - local-webhook-service.alloydb-omni-system.svc.cluster.local
     issuerRef:
       kind: Issuer
       name: local-selfsigned-issuer
     secretName: local-webhook-server-cert
   EOF

   Substitua NAMESPACE pelo espaço de nomes onde tem o seu operador, por exemplo, alloydb-omni-system.

Configure o armazenamento associado do GDC

Para instalar o operador AlloyDB Omni no GDC ligado, tem de seguir passos adicionais para configurar o armazenamento porque os clusters do GDC ligado não definem uma classe de armazenamento predefinida. Tem de definir uma classe de armazenamento predefinida antes de criar um cluster de base de dados do AlloyDB Omni.

Para saber como definir o Symcloud Storage como a classe de armazenamento predefinida, consulte o artigo Defina o Symcloud Storage como a classe de armazenamento predefinida.

Para mais informações sobre como alterar a predefinição de todas as outras classes de armazenamento, consulte o artigo Alterar a classe de armazenamento predefinida.

Crie um cluster de base de dados

Nota: recomendamos que crie clusters de base de dados num espaço de nomes diferente de alloydb-omni-system, o espaço de nomes do operador do AlloyDB Omni. A não utilização deste espaço de nomes melhora o isolamento e a segurança, e evita conflitos entre o operador, os recursos que gere e os componentes do utilizador no mesmo cluster do Kubernetes. Para mais informações, consulte o documento técnico do operador da Cloud Native Computing Foundation.

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 do AlloyDB Omni no cluster do Kubernetes aplicando um manifesto semelhante ao seguinte:

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

Substitua o seguinte:

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

• DB_CLUSTER_NAMESPACE (Opcional): o espaço de nomes onde quer criar o cluster de base de dados, por exemplo, my-db-cluster-namespace.

• 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.

Nota: a partir da versão 1.1.0 do operador AlloyDB Omni, o segredo da palavra-passe de administrador deixa de ser eliminado depois de o definir. Tem de manter o segredo recém-definido durante o tempo de vida do cluster da base de dados do AlloyDB Omni.

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

O que se segue?

• Execute e ligue-se ao AlloyDB Omni
• Faça a gestão do AlloyDB Omni
• Faça a gestão da elevada disponibilidade no Kubernetes