Fazer upgrade do Drupal

Edge para nuvem privada v4.18.05

Em uma instalação do Edge for Private Cloud do portal de serviços para desenvolvedores da Apigee (ou simplesmente o portal), você pode receber uma notificação de que uma nova versão do Drupal está disponível. Uma nova versão pode significar um lançamento de recurso, patch, atualização de segurança ou outro tipo de atualização do Drupal. No caso de uma atualização de segurança, convém fazer o upgrade da instalação do Drupal o mais rápido possível para garantir que o site continue seguro.

O procedimento abaixo descreve como atualizar uma instalação de nuvem privada do Drupal 7.x.y para outra versão secundária (por exemplo, do Drupal 7.54 para o 7.56).

Observações:

• Este procedimento só atualiza a instalação do Drupal. Ele não atualiza o software da Apigee que é enviado como parte do portal. Para informações sobre como fazer upgrade do software do portal da Apigee, consulte Fazer upgrade do portal.

• Você precisa executar os comandos do Drush no diretório raiz do site do portal. Por padrão, o portal é instalado em:
  • /opt/apigee/apigee-drupal/wwwroot (Nginx)
  • /var/www/html (Apache)
  O procedimento abaixo pressupõe uma instalação do servidor Nginx no local padrão acima.

Como determinar sua versão atual do Drupal

Antes de iniciar a atualização do Drupal, determine a versão atual executando o comando abaixo na pasta de instalação do Drupal. Por padrão, o Drupal é instalado em /opt/apigee/apigee-drupal/wwwroot:

cd /opt/apigee/apigee-drupal/wwwroot

drush status | grep 'Drupal version'

Você verá a saída no formulário:

Drupal version          :  7.54

Se você instalou o Drupal em um diretório diferente de /opt/apigee/apigee-drupal/wwwroot, mude para esse diretório antes de executar o comando drush.

Como atualizar a versão do Drupal

Esta seção descreve como usar o Drush (Drupal Shell) em uma linha de comando para atualizar a versão do Drupal. Consulte também Como atualizar o Drupal usando o Drush na documentação do Drupal.

Para atualizar a instalação do Drupal:

1. Mude para o diretório /opt/apigee/apigee-drupal/wwwroot ou para o diretório em que você instalou o portal.
2. Faça um backup completo de todos os arquivos, diretórios e bancos de dados. Salve o backup em um local fora da instalação do Drupal. Para instruções completas, consulte Fazer backup do portal.

   Se você fez modificações em arquivos como .htaccess, robots.txt ou defaults.settings.php (no diretório sites), será necessário aplicar as mudanças novamente após a atualização. Também será necessário aplicar novamente todas as personalizações feitas no diretório sites/all.

3. Coloque seu site no modo de manutenção:

   drush vset --exact maintenance_mode 1

   drush cache-clear all

4. Instale a versão desejada do Drupal usando o seguinte comando:

   drush pm-update drupal-7.56

   Como alternativa, você pode executar drush pm-update drupal para atualizar para a versão principal do Drupal mais recente. É possível executar drush pm-updatestatus para listar as atualizações menores disponíveis para os projetos principais e de contribuição do Drupal.

5. Reaplique as alterações feitas em .htaccess, robots.txt ou defaults.settings.php (no diretório sites).
6. Reaplique as alterações feitas no diretório sites/all .
7. Remova o site do modo de manutenção:
   

   drush vset --exact maintenance_mode 0

   drush cache-clear all

E se eu encontrar um problema durante a atualização?

Restaure o site ao estado anterior usando os arquivos de backup que você criou. Entre em contato com o representante de suporte da Apigee e envie as mensagens de erro informadas durante a atualização.