Instalar o orquestrador RPM do AlloyDB Omni

Selecione uma versão da documentação:

O AlloyDB Omni usando o orquestrador RPM oferece uma plataforma de automação para instalar, configurar e gerenciar clusters de banco de dados do AlloyDB Omni em um conjunto de máquinas virtuais (VMs) ou servidores bare metal. O AlloyDB Omni usando o orquestrador RPM oferece uma CLI e uma interface do Ansible que são executadas em um nó de controle dedicado, em que você gerencia um ou mais clusters remotamente.

Dependendo das suas necessidades de automação, você pode escolher entre duas interfaces de orquestrador:

  • CLI do orquestrador do AlloyDB Omni alloydbctl: recomendada para ambientes que usam scripts de shell para automação.
  • Coleção do Ansible do orquestrador do AlloyDB Omni: recomendada para ambientes que usam Ansible-based automation.

Limitações

As limitações a seguir se aplicam a esta versão:

  • Esta versão oferece suporte apenas ao AlloyDB Omni PostgreSQL 18.
  • Esta versão oferece suporte apenas a pacotes de software compatíveis com a versão 9 do RHEL.
  • Esta versão oferece suporte apenas à plataforma baseada em Intel x86 de 64 bits.
  • Os upgrades de versão principal não são compatíveis nesta versão.
  • Esta versão não inclui instruções para configurar a recuperação de desastres.
  • Esta versão não inclui instruções para configurar instâncias de pool de leitura.
  • O monitor do AlloyDB Omni não oferece suporte a conexões SSL. Implante os servidores do painel de monitoramento na mesma rede privada que os nós do AlloyDB Omni.

Antes de começar

Antes de iniciar a implantação, verifique se você atende aos seguintes requisitos:

Receber pacotes do AlloyDB Omni

Os pacotes de software do AlloyDB Omni usando o orquestrador RPM estão na versão prévia. Faça a inscrição usando o formulário de inscrição da versão prévia do AlloyDB Omni usando o orquestrador RPM para receber os arquivos RPM.

Se você gerenciar pacotes de software por um repositório Yum particular, siga as instruções do gerenciamento do repositório para incluir arquivos RPM dependentes no repositório. Para mais informações, consulte Dependências de pacotes de software.

Configurar um repositório de software

Os RPMs do AlloyDB Omni são mantidos em um repositório Yum global. Como alternativa, se sua organização gerenciar software por um repositório Yum particular, inclua os pacotes RPM fornecidos após a inscrição no repositório de acordo com suas ferramentas de gestão. Você precisa do URL do repositório particular durante o processo de implantação.

Provisionar máquinas

Provisione um conjunto de VMs que executam o RHEL 9, incluindo:

  • Controlador: um nó que orquestra a implantação e tem acesso SSH sem senha a todos os outros nós.
  • Banco de dados: um ou três nós que executam o núcleo do AlloyDB Omni e os serviços de monitoramento.
  • Balanceador de carga: dois nós opcionais que executam o HAProxy e poolers de conexão opcionais, como o PgBouncer.

Configurar rede e firewall

Configure o firewall para permitir as seguintes portas TCP com base na sua arquitetura:

Porta Protocolo Nó Serviço Tráfego Observações
5432 TCP Balanceador de carga HAProxy Entrada No nó do balanceador de carga, se aplicável
6432 TCP Balanceador de carga PgBouncer Entrada Pooler de conexão, se aplicável
9187 TCP Banco de dados Monitor do AlloyDB Entrada Monitor, se aplicável; não oferece suporte a TLS
5432 TCP Banco de dados AlloyDB Entrada Arquitetura resiliente de três nós
6432 TCP Banco de dados PgBouncer Entrada Pooler de conexão, se aplicável em arquitetura resiliente de três nós
2380 TCP etcd etcd Entrada Para protocolo peer-to-peer etcd
- VRRP Balanceador de carga Keepalived Entrada Eleição de líder do Keepalived
- VRRP Banco de dados Keepalived Entrada Eleição de líder do Keepalived em arquitetura resiliente de três nós
6703 TCP Gerenciador de clusters Gerenciador de clusters Entrada Porta gRPC do gerenciador de clusters
6702 TCP Todos os nós Gerenciador de nós Entrada Porta gRPC do gerenciador de nós
6700 TCP Todos os nós Gerenciador de nós Entrada Porta gRPC de inicialização do gerenciador de nós
8086 HTTP Todos os nós Gerenciador de nós Entrada Porta HTTP do gerenciador de nós para verificar o principal ou o em espera
2379 TCP etcd etcd Entrada Para o gerenciador de clusters trabalhar com o etcd
443 HTTPS Banco de dados Cloud Storage Saída Para enviar dados de backup

Modo SELinux do host

O AlloyDB Omni oferece suporte ao SELinux nos modos permissivo e de aplicação.

Para ativar ou desativar o SELinux, verifique se o arquivo /etc/selinux/config está atualizado em todos os nós. Antes de inicializar o cluster, verifique se as configurações do SELinux são consistentes em todos os nós do banco de dados e do balanceador de carga. Para verificar as configurações atuais, use o comando getenforce.

Para mais informações, consulte Especificações da política do SELinux.

Instalar o orquestrador

Ansible

Use esse método se você planeja usar playbooks do Ansible para gerenciar seus clusters.

  1. No nó de controle, instale o Ansible e as bibliotecas Python necessárias:

    # Install EPEL for RHEL 9
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm -y
# Install Ansible and dependencies
sudo dnf install ansible
sudo dnf install python3-grpcio python3-protobuf python3-googleapis-common-protos

  2. Faça o download do arquivo tar da coleção do Ansible e da assinatura dele, verifique o pacote e instale-o:

    # Download the collection and its signature
wget ALLOYDBOMNI_SERVER/google-alloydbomni_orchestrator-0.1.0-1.tar.gz
wget ALLOYDBOMNI_SERVER/google-alloydbomni_orchestrator-0.1.0-1.tar.gz.asc

# Import the Google Linux signing key
curl -sS https://dl.google.com/linux/linux_signing_key.pub | gpg --import

# Verify the collection tarball
gpg --verify google-alloydbomni_orchestrator-0.1.0-1.tar.gz.asc \
google-alloydbomni_orchestrator-0.1.0-1.tar.gz

# Install the collection
ansible-galaxy collection install google-alloydbomni_orchestrator-0.1.0-1.tar.gz

# Verify the installation
ansible-galaxy collection list | grep alloydbomni_orchestrator

    Substitua ALLOYDBOMNI_SERVER pelo URL do servidor em que os pacotes de software do AlloyDB Omni, incluindo o arquivo tar da coleção do Ansible, estão hospedados. Essa origem é fornecida depois que você se inscreve na versão prévia do AlloyDB Omni usando o orquestrador RPM Preview.

alloydbctl

Use esse método se preferir um utilitário de linha de comando para gerenciar recursos.

  1. Crie um arquivo de configuração do Yum no nó de controle em /etc/yum.repos.d/alloydbomni_orchestrator.repo:

    [alloydbomni_orchestrator]
name=Google AlloyDB Omni orchestrator packages
baseurl=ALLOYDB_OMNI_ORCHESTRATOR_REPOSITORY_URL
enabled=1
repo_gpgcheck=0
gpgcheck=1
gpgkey=REPO_GPG_KEY

    Substitua:

    • ALLOYDB_OMNI_ORCHESTRATOR_REPOSITORY_URL: o URL do repositório que contém os RPMs do orquestrador do AlloyDB Omni.
    • REPO_GPG_KEY: o local da chave pública do Google para verificação do GNU Privacy Guard (GPG), por exemplo, https://dl.google.com/linux/linux_signing_key.pub. Isso também pode ser definido como um caminho se a chave for baixada para um arquivo, por exemplo, file:///tmp/linux_signing_key.pub.

  2. Instale o pacote e adicione o binário ao PATH do sistema:

    sudo dnf install alloydbomni_orchestrator
export PATH=$PATH:/usr/local/bin

  3. Execute o seguinte comando para confirmar a instalação:

    alloydbctl --help