Implantar um site Drupal de alta disponibilidade com um banco de dados externo do Amazon RDS no Elastic Beanstalk

Para executar uma instância de banco de dados do RDS em uma VPC padrão

1. Abra o console do RDS.

2. No painel de navegação, escolha Databases (Bancos de dados).

3. Selecione Criar banco de dados.

4. Escolha Standard Create (Criação padrão).

   Importante

   Não escolha Easy Create (Criação fácil). Se o escolher, você não poderá definir as configurações necessárias para iniciar esse banco de dados do RDS.

5. Em Additional configuration (Configuração adicional), para Initial database name (Nome do banco de dados inicial), digite ebdb.

6. Revise as configurações padrão e ajuste essas configurações de acordo com seus requisitos específicos. Preste atenção às seguintes opções:

   • DB instance class (Classe de instância de banco de dados): escolha um tamanho de instância que tem uma quantidade apropriada de memória e energia de CPU para sua workload.

   • Multi-AZ implantação — Para alta disponibilidade, defina isso como Criar um Replica/Reader nó do Aurora em uma AZ diferente.

   • Master username (Nome do usuário principal) e Master password (Senha principal):o nome de usuário do banco de dados e senha. Anote essas configurações porque você vai usá-las mais tarde.

7. Verifique as configurações padrão para as opções restantes e selecione Create database (Criar banco de dados).

Para modificar as regras de entrada no grupo de segurança anexado à instância do RDS

1. Abra o console do Amazon RDS.

2. Escolha Databases (Bancos de dados).

3. Escolha o nome da sua instância de banco de dados para visualizar detalhes.

4. Na seção Conectividade, anote as Sub-redes, os Grupos de segurança e o Endpoint que são exibidos nesta página. Faça isso para poder usar essas informações mais tarde.

5. Em Security (Segurança), você pode ver o grupo de segurança associado à instância de banco de dados. Abra o link para visualizar o grupo de segurança no console do Amazon EC2.

6. Nos detalhes do grupo de segurança, escolha a guia Inbound (Entrada).

7. Escolha Editar.

8. Escolha Add Rule.

9. Para Tipo, escolha o mecanismo de banco de dados usado pelo aplicativo.

10. Em Source (Origem), digite sg- para exibir uma lista dos grupos de segurança disponíveis. Escolha o grupo de segurança associado ao grupo do Auto Scaling usado com seu ambiente do Elastic Beanstalk. Isso é para que as instâncias do Amazon EC2 no ambiente possam ter acesso ao banco de dados.

    

11. Escolha Salvar.

Para iniciar um ambiente (console)

1. Abra o console do Elastic Beanstalk usando este link pré-configurado: console.aws.amazon. com/elasticbeanstalk/home #/Novo aplicativo? Nome do aplicativo = Tutoriais e tipo de ambiente = LoadBalanced

2. Em Platform (Plataforma), selecione a plataforma e a ramificação da plataforma que correspondem à linguagem usada pelo seu aplicativo.

3. Para Application code, escolha Sample application.

4. Selecione Review and launch.

5. Examine as opções disponíveis. Escolha a opção disponível que deseja usar e, quando estiver pronto, escolha Create app (Criar aplicativo).

Para adicionar um security group ao seu ambiente

• Execute um destes procedimentos:

  • Como adicionar um grupo de segurança usando o console do Elastic Beanstalk

    1. Abra o console do Elastic Beanstalk e, na lista Regiões, selecione seu. Região da AWS

    2. No painel de navegação, selecione Ambientes e selecione o nome do ambiente na lista.

    3. No painel de navegação, escolha Configuration (Configuração).

    4. Na categoria de configuração Instances (Instâncias), escolha Edit (Editar).

    5. Em EC2 security groups (Grupos de segurança do EC2), escolha o grupo de segurança a ser anexado às instâncias, além do grupo de segurança da instância que o Elastic Beanstalk criará.

    6. Para salvar as alterações, escolha Apply (Aplicar) na parte inferior da página.

    7. Leia o aviso e escolha Confirm.

  • Para adicionar um grupo de segurança usando um arquivo de configuração, use o exemplo de arquivo securitygroup-addexisting.config.

Como configurar as propriedades do ambiente para uma instância de banco de dados do Amazon RDS

1. Abra o console do Elastic Beanstalk e, na lista Regiões, selecione seu. Região da AWS

2. No painel de navegação, selecione Ambientes e selecione o nome do ambiente na lista.

3. No painel de navegação, escolha Configuration (Configuração).

4. Na categoria de configuração Updates, monitoring, and logging (Atualizações, monitoramento e logs), escolha Edit (Editar).

5. Na seção Environment properties, defina as variáveis que seu aplicativo lê para construir uma string de conexão. Para compatibilidade com ambientes que têm uma instância de banco de dados do RDS integrada, use os seguintes nomes e valores. É possível encontrar todos os valores, exceto sua senha, no console do RDS.

   Nome da propriedade	Descrição	Valor da propriedade
   RDS_HOSTNAME	O nome do host da instância de banco de dados.	Na guia Connectivity & security (Conectividade e segurança) no console do Amazon RDS: Endpoint.
   RDS_PORT	A porta na qual a instância de banco de dados aceita conexões. O valor padrão varia entre os mecanismos de banco de dados.	Na guia Connectivity & security (Conectividade e segurança) do console do Amazon RDS: Port (Porta).
   RDS_DB_NAME	O nome do banco de dado, ebdb.	Na guia Configuration (Configuração) no console do Amazon RDS: DB Name (Nome do banco de dados).
   RDS_USERNAME	O nome de usuário que você configurou para seu banco de dados.	Na guia Configuration (Configuração) do console do Amazon RDS: Nome de usuário primário.
   RDS_PASSWORD	A senha que você configurou para seu banco de dados.	Não disponível para referência no console do Amazon RDS.

   

6. Para salvar as alterações, escolha Apply (Aplicar) na parte inferior da página.

Para configurar SSH

1. Se você ainda não tiver criado um par de chaves, abra a página de pares de chaves do console do Amazon EC2 e siga as instruções para criar um.

2. Abra o console do Elastic Beanstalk e, na lista Regiões, selecione seu. Região da AWS

3. No painel de navegação, selecione Ambientes e selecione o nome do ambiente na lista.

4. No painel de navegação, escolha Configuration (Configuração).

5. Em Security (Segurança), escolha Edit (Editar).

6. Para EC2 key pair (Par de chaves EC2), escolha o par de chaves.

7. Para salvar as alterações, escolha Apply (Aplicar) na parte inferior da página.

Para criar um projeto Drupal

1. Execute o comando a seguir para baixar o Drupal em www.drupal. org/download. Para saber mais sobre downloads, consulte o site do Drupal.

   Se a plataforma do seu ambiente do Elastic Beanstalk usa PHP 7.4 ou anterior, recomendamos que você faça o download da versão 8.9.13 do Drupal para este tutorial. Execute o comando a seguir para fazer o download.

   ~$ curl https://ftp.drupal.org/files/projects/drupal-8.9.13.tar.gz -o drupal.tar.gz

   Se sua plataforma usa PHP 8.0 ou posterior, recomendamos que você faça o download do Drupal 9.1.5. Você pode usar este comando para fazer o download.

   ~$ curl https://ftp.drupal.org/files/projects/drupal-9.1.5.tar.gz -o drupal.tar.gz

   Para obter mais informações sobre versões do Drupal e as versões do PHP compatíveis, consulte Requisitos do PHP na documentação oficial do Drupal. As versões básicas que o Drupal recomenda estão listadas no site do Drupal.

2. Use o seguinte comando para fazer o download dos arquivos de configuração do repositório de exemplo:

   ~$ wget https://github.com/aws-samples/eb-php-drupal/releases/download/v1.1/eb-php-drupal-v1.zip

3. Extraia o Drupal e mude o nome da pasta.

   Se você baixou o Drupal 8.9.13:

    ~$ tar -xvf drupal.tar.gz
    ~$ mv drupal-8.9.13 drupal-beanstalk
    ~$ cd drupal-beanstalk

   Se você baixou o Drupal 9.1.5:

    ~$ tar -xvf drupal.tar.gz
    ~$ mv drupal-9.1.5 drupal-beanstalk
    ~$ cd drupal-beanstalk

4. Extraia os arquivos de configuração durante a instalação do Drupal.

    ~/drupal-beanstalk$ unzip ../eb-php-drupal-v1.zip
     creating: .ebextensions/
     inflating: .ebextensions/dev.config
     inflating: .ebextensions/drupal.config
     inflating: .ebextensions/efs-create.config
     inflating: .ebextensions/efs-filesystem.template
     inflating: .ebextensions/efs-mount.config
     inflating: .ebextensions/loadbalancer-sg.config
     inflating: LICENSE
     inflating: README.md
     inflating: beanstalk-settings.php

Para atualizar os arquivos de configuração e criar um pacote de origem.

1. Modifique os arquivos de configuração da seguinte forma.

   • .ebextensions/dev.config: restringe o acesso ao seu ambiente para o seu endereço IP a fim de protegê-lo durante o processo de instalação do Drupal. Substitua o endereço IP de espaço reservado próximo à parte superior do arquivo pelo seu endereço IP público.

   • .ebextensions/efs-create.config: cria um sistema de arquivos EFS e pontos de montagem em cada zona de disponibilidade/sub-rede na VPC. Identifique os IDs de sua VPC padrão e sub-rede no console da Amazon VPC.

2. Crie um pacote de origem com os arquivos em sua pasta de projeto. O comando a seguir cria um pacote de origem chamado drupal-beanstalk.zip. Ele exclui arquivos na pasta vendor, que tomam muito espaço e não são necessários para implantação da aplicação no Elastic Beanstalk.

   ~/eb-drupal$ zip ../drupal-beanstalk.zip -r * .[^.]* -x "vendor/*"

Para implantar um pacote de origem

1. Abra o console do Elastic Beanstalk e, na lista Regiões, selecione seu. Região da AWS

2. No painel de navegação, selecione Ambientes e selecione o nome do ambiente na lista.

3. Na página de visão geral do ambiente, escolha Upload and deploy (Fazer upload e implantar).

4. Use a caixa de diálogo na tela para carregar o pacote de origem.

5. Escolha Deploy (Implantar).

6. Quando a implantação for concluída, é possível escolher o URL do site para abri-lo em uma nova guia.

Para concluir a instalação do Drupal

1. Abra o console do Elastic Beanstalk e, na lista Regiões, selecione seu. Região da AWS

2. No painel de navegação, selecione Ambientes e selecione o nome do ambiente na lista.

3. Escolha o URL do ambiente para abrir seu site em um navegador. Você será redirecionado para um assistente de instalação do Drupal, pois o site ainda não foi configurado.

4. Realize a instalação padrão usando as seguintes configurações para o banco de dados:

   • Nome do banco de dados: o DB Name (Nome do banco de dados) exibido no console do Amazon RDS.

   • Nome de usuário e senha do banco de dados: os valores de Master username (Nome do usuário principal) e Master Password (Senha principal) inseridos ao criar o banco de dados.

   • Advanced Options (Opções avançadas) > Host: o Endpoint da instância de banco de dados exibida no console do Amazon RDS.

Para conectar sua instância de aplicativo com SSH

1. Abra a página instâncias do console do Amazon EC2.

2. Escolha a instância do aplicativo. É a que recebeu o nome do seu ambiente do Elastic Beanstalk.

3. Selecione Conectar.

4. Siga as instruções para conectar a instância com SSH. O comando será semelhante à seguinte.

   $ ssh -i ~/.ssh/mykey ec2-user@ec2-00-55-33-222.us-west-2.compute.amazonaws.com

Para configurar variáveis de ambiente no console do Elastic Beanstalk

1. Abra o console do Elastic Beanstalk e, na lista Regiões, selecione seu. Região da AWS

2. No painel de navegação, selecione Ambientes e selecione o nome do ambiente na lista.

3. No painel de navegação, escolha Configuration (Configuração).

4. Na categoria de configuração Updates, monitoring, and logging (Atualizações, monitoramento e logs), escolha Edit (Editar).

5. Role para baixo até Variáveis de ambiente de runtime.

6. Selecione Adicionar variável de ambiente.

7. Em Origem, selecione Texto sem formatação.

   nota

   Os valores do Secrets Manager e do SSM Parameter Store no menu suspenso servem para configurar variáveis de ambiente como segredos para armazenar dados sensíveis, como credenciais e chaves de API. Para obter mais informações, consulte Usando o Elastic Beanstalk com AWS Secrets Manager and AWS Systems Manager Parameter Store.

8. Insira os pares de Nome da variável de ambiente e Valores da variável de ambiente.

9. Se for necessário adicionar mais variáveis, repita a Etapa 6 até a Etapa 8.

10. Para salvar as alterações, escolha Apply (Aplicar) na parte inferior da página.

Para atualizar a configuração do Drupal e remover restrições de acesso

1. Exclua o arquivo .ebextensions/loadbalancer-sg.config de seu diretório de projeto.

   ~/drupal-beanstalk$ rm .ebextensions/loadbalancer-sg.config

2. Copie o arquivo settings.php personalizado na pasta dos sites.

   ~/drupal-beanstalk$ cp beanstalk-settings.php sites/default/settings.php

3. Criar um pacote de origem.

   ~/eb-drupal$ zip ../drupal-beanstalk-v2.zip -r * .[^.]* -x "vendor/*"

Para implantar um pacote de origem

1. Abra o console do Elastic Beanstalk e, na lista Regiões, selecione seu. Região da AWS

2. No painel de navegação, selecione Ambientes e selecione o nome do ambiente na lista.

3. Na página de visão geral do ambiente, escolha Upload and deploy (Fazer upload e implantar).

4. Use a caixa de diálogo na tela para carregar o pacote de origem.

5. Escolha Deploy (Implantar).

6. Quando a implantação for concluída, é possível escolher o URL do site para abri-lo em uma nova guia.

Para configurar o grupo de Auto Scaling de seu ambiente para alta disponibilidade

1. Abra o console do Elastic Beanstalk e, na lista Regiões, selecione seu. Região da AWS

2. No painel de navegação, selecione Ambientes e selecione o nome do ambiente na lista.

3. No painel de navegação, escolha Configuration (Configuração).

4. Na categoria de configuração Capacity (Capacidade), escolha Edit (Editar).

5. Na seção Auto Scaling group (Grupo de Auto Scaling) defina Min instances (Mínimo de instâncias) como 2.

6. Para salvar as alterações, escolha Apply (Aplicar) na parte inferior da página.

Para encerrar seu ambiente Elastic Beanstalk do console

1. Abra o console do Elastic Beanstalk e, na lista Regiões, selecione seu. Região da AWS

2. No painel de navegação, selecione Ambientes e selecione o nome do ambiente na lista.

3. Escolha Actions (Ações) e depois Terminate Environment (Encerrar ambiente).

4. Use a caixa de diálogo na tela para confirmar o encerramento do ambiente.

Para encerrar sua instância de banco de dados do RDS

1. Abra o console do Amazon RDS.

2. Escolha Databases (Bancos de dados).

3. Escolha a instância de banco de dados.

4. Escolha Ações e, em seguida, escolha Excluir.

5. Escolha se deseja criar um snapshot. Depois, escolha Excluir.