Fazer upgrade do Drupal

Edge para nuvem privada v4.18.05

Em uma instalação do Edge para nuvem privada 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 uma versão 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, faça upgrade da instalação do Drupal o mais rápido possível para garantir que o site permaneça seguro.

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

Observações:

• Esse procedimento atualiza apenas 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.

• É preciso 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 dele executando o comando a seguir 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

Nesta seção, descrevemos como usar o Drush (Drupal Shell) em uma linha de comando para atualizar sua 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ê tiver feito modificações em arquivos como .htaccess, robots.txt ou defaults.settings.php (no diretório sites), será necessário reaplicar as mudanças após a atualização. Você também precisará reaplicar as personalizações feitas no diretório sites/all.

3. Coloque o 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, execute drush pm-update drupal para atualizar para a versão mais recente do núcleo do Drupal. Execute drush pm-updatestatus para listar as atualizações secundárias disponíveis para o núcleo do Drupal e os projetos de contribuição.

5. Aplique novamente 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. Tire o site do modo de manutenção:
   

   drush vset --exact maintenance_mode 0

   drush cache-clear all

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

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