Observação:

• Este tutorial requer acesso ao Oracle Cloud. Para se inscrever em uma conta gratuita, consulte Conceitos Básicos do Oracle Cloud Infrastructure Free Tier.
• Ele usa valores de exemplo para credenciais, tenancy e compartimentos do Oracle Cloud Infrastructure. Ao concluir seu laboratório, substitua esses valores por valores específicos do seu ambiente de nuvem.

Implantar um Cluster PostgreSQL em Instâncias do Oracle Cloud Infrastructure Compute

Introdução

PostgreSQL é um sistema de gerenciamento de banco de dados relacional de objeto de código-fonte aberto. É altamente extensível, altamente escalável e tem muitos recursos. O PostgreSQL suporta replicação de dados em vários data centers.

Este tutorial mostra uma implantação típica de três nós de um cluster PostgreSQL nas instâncias do Oracle Cloud Infrastructure (OCI) Compute. Neste tutorial, os servidores são configurados na configuração principal e stand-by e usam replicação de streaming.

Você pode encontrar as instruções de automação aqui: terraform-oci-arch-postgresql.

Observação: Ele instalará automaticamente postgis34 e pgvector.

Diagrama de Arquitetura

Objetivos

• Implante um cluster PostgreSQL de três nós.

• Modifique o código para melhor atender às suas necessidades.

Pré-requisitos

• Permissão para gerenciar os seguintes recursos em sua tenancy do OCI: Redes Virtuais na Nuvem (VCNs), Gateways de Internet, Tabelas de Roteamento, listas de Segurança, Sub-redes e Instâncias.

• Crie os seguintes recursos:

  • 1 VCN,
  • 1 Subnet,
  • 1 Gateway de Internet,
  • 1 Regras de Roteamento e
  • 3 Instâncias do Serviço Compute (1 instância principal PostgreSQL e 2 instâncias stand-by de PostgreSQL).

Tarefa 1: Implantar o Código do Terraform usando o OCI Resource Manager

A implantação pode ser feita de duas maneiras, usando a CLI (Command Line Interface) terraform ou o OCI Resource Manager. Neste tutorial, usaremos o OCI Resource Manager.

Para a CLI terraform, consulte a documentação do repositório aqui: terraform-oci-arch-postgresql.

1. Clique na imagem a seguir para iniciar o processo do OCI Resource Manager que implantará os recursos.

   

2. Se você ainda não estiver conectado, informe as credenciais da tenancy e do usuário, revise e aceite os termos e condições, selecione a região, o compartimento no qual deseja que a pilha resida e clique em Próximo que o levará à próxima etapa para Configurar variáveis.

3. Em Configurar variáveis, especifique as informações a seguir para configurar as variáveis.

   • Compartimento: Selecione o compartimento no qual você deseja implantar os recursos.
   • Domínio de Disponibilidade para o mestre PostgreSQL: Selecione o domínio de disponibilidade para a instância de computação mestre.
   • PostgreSQL Versão: Você pode selecionar as versões 9.6, 10, 11, 12 ou 13.
   • PostgreSQL Password: Defina uma Senha para acessar PostgreSQL.
   • Implantar primeiro PostgreSQL HotStandby: Selecione se deseja implantar o primeiro stand-by.
   • Implantar o segundo PostgreSQL HotStandby: Selecione se quiser implantar o segundo stand-by.
   • Criar em Sub-rede Privada: Selecione se quiser que as instâncias sejam criadas em uma sub-rede privada.

   Observação:

   • A implantação do primeiro e do segundo PostgreSQL HotStandby permite implantar um, dois ou três nós.
   • Se você optar por criar em uma sub-rede privada, um serviço do OCI Bastion será criado para permitir o acesso.

4. Clique em Mostrar opções avançadas para especificar informações adicionais sobre variáveis configuráveis.

   • Configuração Opcional de Rede: Permite que você especifique os CIDRs da VCN e da sub-rede e se deve ou não criar um Gateway de Roteamento Dinâmico (DRG).
   • Configuração Opcional de Computação, Armazenamento e Backup: Isso permite adicionar uma chave SSH pública para acessar as instâncias PostgreSQL e configurar backups.
   • PostgreSQL Configuração Opcional Principal: Especifique o domínio de falha, a forma, a CPU e a memória da instância principal PostgreSQL para formas flexíveis.
   • PostgreSQL HotStandby1 Configuração Opcional: Especifique o primeiro domínio de disponibilidade da instância stand-by PostgreSQL, domínio de falha, forma, CPU e memória para formas flexíveis.
   • PostgreSQL HotStandby2 Configuração Opcional: Especifique o domínio de disponibilidade da segunda instância stand-by PostgreSQL, o domínio de falha, a forma, a CPU e a memória para formas flexíveis.

5. Clique em Próximo para revisar as informações.

   Observação:

   • Desmarque Executar aplicação se quiser executar um plano primeiro.
   • Se você selecionar Executar aplicação, ele acionará o comando terraform aplicar e começará automaticamente a provisionar os recursos.

6. Clique em Criar.

Tarefa 2: Destruir a Implantação

Para destruir seus recursos, vá para a página Detalhes da Pilha e clique em Destruir.

Entender como o PostgreSQL está Instalado e Configurado

Essas informações serão úteis se você precisar modificar a forma como PostgreSQL funciona.

Isso ajudará você a entender:

• Onde está exatamente a instalação e a configuração.

• A ordem em que os scripts estão sendo executados.

• Uma visão geral de alto nível do que cada script faz.

Observação: Isso não abordará como personalizar a automação. Dependendo das alterações, pode exigir modificações em vários arquivos terraform.

• Os arquivos importantes que estamos usando neste tutorial são:

  • remote.tf: Arquivo Terraform no qual os scripts são implantados em cada instância PostgreSQL.
  • scripts/postgresql_install_binaries.sh: Instala o servidor PostgreSQL, algumas extensões e configura o firewall.
  • scripts/postgresql_master_initdb.sh: Inicializa o banco de dados.
  • scripts/postgresql_master_setup.sh: Configura a réplica de PostgreSQL standby1.
  • scripts/postgresql_master_setup2.sh: Configura a réplica de PostgreSQL standby2.
  • scripts/postgresql_standby_setup.sh: Configuração adicional para réplicas como firewall, máximo de conexões, edição de replica.conf.

• Os scripts são executados na seguinte ordem:

  • scripts/postgresql_install_binaries.sh: É executado na instância principal PostgreSQL.
  • scripts/postgresql_master_initdb.sh É executado na instância principal PostgreSQL.
  • scripts/postgresql_install_binaries.sh É executado na instância PostgreSQL standby1.
  • scripts/postgresql_install_binaries.sh É executado na instância PostgreSQL standby2.
  • scripts/postgresql_master_setup.sh É executado na instância principal PostgreSQL.
  • scripts/postgresql_master_setup2.sh É executado na instância principal PostgreSQL.
  • scripts/postgresql_standby_setup.sh É executado na instância PostgreSQL standby1.
  • scripts/postgresql_standby_setup.sh É executado na instância PostgreSQL standby2.

Confirmações

• Autor - Gabriel Feodorov (Engenheiro Sênior de Nuvem)

Mais Recursos de Aprendizagem

Explore outros laboratórios em docs.oracle.com/learn ou acesse mais conteúdo de aprendizado gratuito no canal Oracle Learning YouTube. Além disso, visite education.oracle.com/learning-explorer para se tornar um Oracle Learning Explorer.

Para obter a documentação do produto, visite o Oracle Help Center.

---

Título e Informações de Copyright

Deploy a PostgreSQL Cluster on Oracle Cloud Infrastructure Compute Instances

G25663-01

January 2025

Copyright ©2025, Oracle and/or its affiliates.