Tutorial: Host a WordPress blog on AL2023

1. Baixe e instale esses pacotes usando o comando a seguir.

   dnf install wget php-mysqlnd httpd php-fpm php-mysqli mariadb105-server php-json php php-devel -y

2. Você pode notar um aviso exibido com verbiagem semelhante na saída (as versões podem variar com o tempo):

   WARNING:
     A newer release of "Amazon Linux" is available.
   
     Available Versions:
        
   dnf upgrade --releasever=2023.0.20230202
   
       Release notes:
        https://aws.amazon.com
   
     Version 2023.0.20230204:
       Run the following command to update to 2023.0.20230204:
   
         dnf upgrade --releasever=2023.0.20230204 ... etc

   Como prática recomendada, mantenha o sistema operacional o mais atualizado possível, mas você pode iterar cada versão para garantir que não haja conflitos em seu ambiente. Se a instalação dos pacotes anteriores anotados na etapa 1 falhar, talvez seja necessário atualizar para uma das versões mais recentes listadas e tentar novamente.

3. Faça download do pacote de instalação mais recente do WordPress com o comando wget. O comando a seguir sempre deve baixar a versão mais recente.

   [ec2-user ~]$ wget https://wordpress.org/latest.tar.gz

4. Descompacte e desarquive o pacote de instalação. A pasta de instalação é descompactada para uma pasta chamada wordpress.

   [ec2-user ~]$ tar -xzf latest.tar.gz

Para criar um usuário de banco de dados e um banco de dados para a instalação do WordPress

Sua instalação do WordPress precisa armazenar informações, como publicações de blog e comentários de usuários, em um banco de dados. Esse procedimento ajuda você a criar um banco de dados para seu blog e um usuário autorizado a ler e salvar as informações.

1. Inicie o servidor do banco de dados e da Web.

   [ec2-user ~]$ sudo systemctl start mariadb httpd

2. Faça login no servidor do banco de dados como usuário root. Insira a senha de root do banco de dados quando solicitado; ela poderá ser diferente da sua senha do sistema de root ou poderá até estar vazia, se você não tiver protegido seu servidor do banco de dados.

   Se ainda não tiver protegido seu servidor do banco de dados, é muito importante que você faça isso. Para obter mais informações, consulte Etapa 3: Proteger o servidor do banco de dados (AL2023).

   [ec2-user ~]$ mysql -u root -p

3. Crie um usuário e uma senha para seu banco de dados do MySQL. Sua instalação do WordPress usa esses valores para se comunicar com seu banco de dados do MySQL. Digite o comando a seguir, substituindo um nome de usuário e uma senha exclusivos.

   CREATE USER 'wordpress-user'@'localhost' IDENTIFIED BY 'your_strong_password';

   Crie uma senha forte para seu usuário. Não use o caractere de aspa única ( ' ) na sua senha, pois isso quebrará o comando anterior. Não reutilize uma senha existente e armazene essa senha em um lugar seguro.

4. Crie seu banco de dados. Dê ao seu banco de dados um nome descritivo e significativo, como wordpress-db.

   nota

   As marcas de pontuação que cercam o nome do banco de dados no comando abaixo são chamados backticks. A chave de backtick (`) costuma estar localizada acima da chave Tab de um teclado padrão. Backticks nem sempre são necessários, mas permitem que você use caracteres de outra forma ilegais, como hífens, no nome dos bancos de dados.

   CREATE DATABASE `wordpress-db`;

5. Conceda privilégios completos para seu banco de dados ao usuário do WordPress criado anteriormente.

   GRANT ALL PRIVILEGES ON `wordpress-db`.* TO "wordpress-user"@"localhost";

6. Limpe os privilégios do banco de dados para receber todas as suas alterações.

   FLUSH PRIVILEGES;

7. Saia do cliente mysql.

   exit

Para criar e editar o arquivo wp-config.php

A pasta de instalação do WordPress contém um arquivo de configuração de exemplo chamado wp-config-sample.php. Nesse procedimento, você copia esse arquivo e o edita para caber na sua configuração específica.

1. Copie o arquivo wp-config-sample.php para um arquivo chamado wp-config.php. Isso cria um novo arquivo de configuração e mantém o arquivo de exemplo original intacto como um backup.

   [ec2-user ~]$ cp wordpress/wp-config-sample.php wordpress/wp-config.php

2. Edite o arquivo wp-config.php com seu editor de texto favorito (como o nano ou o vim) e insira os valores da instalação. Se você não tiver um editor de texto favorito, o nano é ideal para iniciantes.

   [ec2-user ~]$ nano wordpress/wp-config.php

   1. Encontre a linha que define DB_NAME e altere database_name_here para o nome do banco de dados criado em Passo 4 de Para criar um usuário de banco de dados e um banco de dados para a instalação do WordPress.

      define('DB_NAME', 'wordpress-db');

   2. Encontre a linha que define DB_USER e altere username_here para o usuário do banco de dados que você criou Passo 3 de Para criar um usuário de banco de dados e um banco de dados para a instalação do WordPress.

      define('DB_USER', 'wordpress-user');

   3. Encontre a linha que define DB_PASSWORD e altere password_here para a senha mais forte que você criou em Passo 3 de Para criar um usuário de banco de dados e um banco de dados para a instalação do WordPress.

      define('DB_PASSWORD', 'your_strong_password');

   4. Encontre a seção chamada Authentication Unique Keys and Salts. Esses valores KEY e SALT fornecem uma camada de criptografia para os cookies do navegador que os usuários do WordPress armazenam em suas máquinas locais. Basicamente, adicionar valores longos e aleatórios aqui deixa seu site mais seguro. Visite https://api.wordpress.org/secret-key/1.1/salt/ para gerar aleatoriamente um conjunto de valores-chave que você pode copiar e colar no seu arquivo wp-config.php. Para colar texto em um terminal do PuTTY, coloque o cursor onde deseja colar texto e clique com o botão direito do mouse dentro do terminal do PuTTY.

      Para obter mais informações sobre as chaves de segurança, acesse https://wordpress.org/support/article/editing-wp-config-php/#security-keys.

      nota

      Os valores abaixo são somente para fins de exemplo; não use esses valores para a instalação.

      define('AUTH_KEY',         ' #U$$+[RXN8:b^-L 0(WU_+ c+WFkI~c]o]-bHw+)/Aj[wTwSiZ<Qb[mghEXcRh-');
      define('SECURE_AUTH_KEY',  'Zsz._P=l/|y.Lq)XjlkwS1y5NJ76E6EJ.AV0pCKZZB,*~*r ?6OP$eJT@;+(ndLg');
      define('LOGGED_IN_KEY',    'ju}qwre3V*+8f_zOWf?{LlGsQ]Ye@2Jh^,8x>)Y |;(^[Iw]Pi+LG#A4R?7N`YB3');
      define('NONCE_KEY',        'P(g62HeZxEes|LnI^i=H,[XwK9I&[2s|:?0N}VJM%?;v2v]v+;+^9eXUahg@::Cj');
      define('AUTH_SALT',        'C$DpB4Hj[JK:?{ql`sRVa:{:7yShy(9A@5wg+`JJVb1fk%_-Bx*M4(qc[Qg%JT!h');
      define('SECURE_AUTH_SALT', 'd!uRu#}+q#{f$Z?Z9uFPG.${+S{n~1M&%@~gL>U>NV<zpD-@2-Es7Q1O-bp28EKv');
      define('LOGGED_IN_SALT',   ';j{00P*owZf)kVD+FVLn-~ >.|Y%Ug4#I^*LVd9QeZ^&XmK|e(76miC+&W&+^0P/');
      define('NONCE_SALT',       '-97r*V/cgxLmp?Zy4zUU4r99QQ_rGs2LTd%P;|_e1tS)8_B/,.6[=UK<J_y9?JWG');

   5. Salve o arquivo e saia do seu editor de texto.

Para instalar seus arquivos do WordPress no documento-raiz do Apache

• Agora que você descompactou a pasta de instalação, criou um banco de dados e um usuário do MySQL e personalizou o arquivo de configuração do WordPress, está pronto para copiar seus arquivos de instalação à raiz do documento do servidor web para que possa executar o script de instalação que encerrar sua instalação. O local desses arquivos depende de se você quer que seu blog do WordPress esteja disponível na raiz real do seu servidor web (por exemplo, my.public.dns.amazonaws.com) ou em um subdiretório ou em uma pasta sob a raiz (por exemplo, my.public.dns.amazonaws.com/blog).

  • Se você quiser que o WordPress seja executado na raiz de documentos, copie o conteúdo do diretório de instalação do WordPress (mas não o diretório em si) da seguinte maneira:

    [ec2-user ~]$ cp -r wordpress/* /var/www/html/

  • Se você quiser que o WordPress seja executado em um diretório alternativo na raiz de documentos, crie primeiro esse diretório e, em seguida, copie os arquivos para ele. Neste exemplo, o WordPress será executado pelo diretório blog:

    [ec2-user ~]$ mkdir /var/www/html/blog
    [ec2-user ~]$ cp -r wordpress/* /var/www/html/blog/

Para permitir que o WordPress use permalinks

Os permalinks do WordPress precisam usar arquivos .htaccess do Apache para funcionarem corretamente, mas isso não fica habilitado por padrão no Amazon Linux. Use o procedimento a seguir para permitir todas as substituições na raiz de documentos do Apache.

1. Abra o arquivo httpd.conf com seu editor de texto de preferência (como nano ou vim). Se você não tiver um editor de texto favorito, o nano é ideal para iniciantes.

   [ec2-user ~]$ sudo vim /etc/httpd/conf/httpd.conf

2. Encontre a seção que começa com <Directory "/var/www/html">.

   <Directory "/var/www/html">
       #
       # Possible values for the Options directive are "None", "All",
       # or any combination of:
       #   Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
       #
       # Note that "MultiViews" must be named *explicitly* --- "Options All"
       # doesn't give it to you.
       #
       # The Options directive is both complicated and important.  Please see
       # http://httpd.apache.org/docs/2.4/mod/core.html#options
       # for more information.
       #
       Options Indexes FollowSymLinks
   
       #
       # AllowOverride controls what directives may be placed in .htaccess files.
       # It can be "All", "None", or any combination of the keywords:
       #   Options FileInfo AuthConfig Limit
       #
       AllowOverride None
   
       #
       # Controls who can get stuff from this server.
       #
       Require all granted
   </Directory>

3. Altere a linha AllowOverride None na seção acima para AllowOverride All.

   nota

   Há múltiplas linhas AllowOverride nesse arquivo; altere a linha na seção <Directory "/var/www/html">.

   AllowOverride All

4. Salve o arquivo e saia do seu editor de texto.

Para corrigir as permissões de arquivos para o Apache Web Server

Algumas das características disponíveis no WordPress exigem acesso de gravação à raiz do documento do Apache (como carregar mídia pelas telas de Administração). Se você não tiver feito isso, aplique as associações e permissões de grupo a seguir (conforme descrito em mais detalhes no tutorial do servidor web LAMP).

1. Conceda a propriedade do arquivo de /var/www e seu conteúdo para o usuário apache.

   [ec2-user ~]$ sudo chown -R apache /var/www

2. Conceda a propriedade do grupo do /var/www e seu conteúdo para o grupo do apache.

   [ec2-user ~]$ sudo chgrp -R apache /var/www

3. Altere as permissões do diretório do /var/www e de seus subdiretórios para adicionar permissões de gravação do grupo e definir o ID do grupo em subdiretórios futuros.

   [ec2-user ~]$ sudo chmod 2775 /var/www
   [ec2-user ~]$ find /var/www -type d -exec sudo chmod 2775 {} \;

4. Altere recursivamente as permissões de arquivo de /var/www e de seus subdiretórios.

   [ec2-user ~]$ find /var/www -type f -exec sudo chmod 0644 {} \;

   nota

   Se também pretender usar o WordPress como um servidor FTP, você precisará de configurações de grupo mais permissivas. Confira as etapas e configurações de segurança no WordPress recomendadas para realizar isso.

5. Reinicie o Apache Web Server para pegar o grupo e as permissões novos.

   [ec2-user ~]$ sudo systemctl restart httpd

Como executar o script de instalação do WordPress com o AL2023

Você está pronto para instalar o WordPress. Os comandos usados por você dependem do sistema operacional. Os comandos deste procedimento são destinados ao AL2023. Use o próximo procedimento com a AMI do AL2023.

1. Use o comando systemctl para garantir que httpd e os serviços do banco de dados sejam iniciados a cada inicialização do sistema.

   [ec2-user ~]$ sudo systemctl enable httpd && sudo systemctl enable mariadb

2. Verifique se o servidor do banco de dados está em execução.

   [ec2-user ~]$ sudo systemctl status mariadb

   Se o serviço do banco de dados não está em execução, inicie-o.

   [ec2-user ~]$ sudo systemctl start mariadb

3. Verifique se o Apache Web Server (httpd) está sendo executado.

   [ec2-user ~]$ sudo systemctl status httpd

   Se o serviço httpd não estiver sendo executado, inicie-o.

   [ec2-user ~]$ sudo systemctl start httpd

4. Em um navegador da web, insira o URL do blog do WordPress (o endereço DNS público para sua instância ou esse endereço seguido pela pasta blog). Você deve visualizar o script de instalação do WordPress. Forneça as informações necessárias segundo a instalação do WordPress. Escolha Install WordPress (Instalar WordPress) para concluir a instalação. Para obter mais informações, consulte Etapa 5: Executar o script de instalação no site do WordPress.

Como executar o script de instalação do WordPress com a AMI do AL2023

1. Use o comando chkconfig para garantir que httpd e os serviços do banco de dados sejam iniciados a cada inicialização do sistema.

   [ec2-user ~]$ sudo chkconfig httpd on && sudo chkconfig mariadb on

2. Verifique se o servidor do banco de dados está em execução.

   [ec2-user ~]$ sudo service mariadb status

   Se o serviço do banco de dados não está em execução, inicie-o.

   [ec2-user ~]$ sudo service mariadb start

3. Verifique se o Apache Web Server (httpd) está sendo executado.

   [ec2-user ~]$ sudo service httpd status

   Se o serviço httpd não estiver sendo executado, inicie-o.

   [ec2-user ~]$ sudo service httpd start

4. Em um navegador da web, insira o URL do blog do WordPress (o endereço DNS público para sua instância ou esse endereço seguido pela pasta blog). Você deve visualizar o script de instalação do WordPress. Forneça as informações necessárias segundo a instalação do WordPress. Escolha Install WordPress (Instalar WordPress) para concluir a instalação. Para obter mais informações, consulte Etapa 5: Executar o script de instalação no site do WordPress.

Para alterar a URL do site do WordPress com wp-cli

1. Conecte-se à sua instância do EC2 com SSH.

2. Anote o URL do site antigo e do site novo para sua instância. O URL do site antigo provavelmente é o nome DNS público da sua instância do EC2 ao instalar o WordPress. O URL do novo site é o nome DNS público atual da sua instância do EC2. Se você não tiver certeza da URL do site antigo, pode usar o curl para encontrá-la com o seguinte comando.

   [ec2-user ~]$ curl localhost | grep wp-content

   Você deve visualizar referências ao nome DNS público antigo na saída, que terá a seguinte aparência (URL do site antigo em vermelho):

   <script type='text/javascript' src='http://ec2-52-8-139-223.us-west-1.compute.amazonaws.com/wp-content/themes/twentyfifteen/js/functions.js?ver=20150330'></script>

3. Faça download do wp-cli com o seguinte comando.

   [ec2-user ~]$ curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

4. Pesquise e substitua o URL do site antigo na instalação do WordPress pelo comando a seguir. Substitua os URLs dos sites novo e antigo para sua instância do EC2 e o caminho para sua instalação do WordPress (geralmente /var/www/html ou /var/www/html/blog).

   [ec2-user ~]$ php wp-cli.phar search-replace 'old_site_url' 'new_site_url' --path=/path/to/wordpress/installation --skip-columns=guid

5. Em um navegador, insira o URL de novo site do blog do WordPress para verificar se o site está funcionando corretamente. Se não estiver, consulte Changing the site URL e Common installation problems para obter mais informações.