Como fazer upgrade da versão do Drupal de uma instalação de nuvem privada

Edge for Private Cloud v. 4.17.09

Em uma instalação do Edge for Private Cloud do portal de serviços para desenvolvedores, 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, faça upgrade da instalação do Drupal assim que 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, Drupal 7.54 para 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 Como fazer upgrade do portal de serviços para desenvolvedores.

  • É necessário executar os comandos do Drush no diretório raiz do site do portal. Por padrão, o Portal do desenvolvedor é 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, é possível determinar a versão atual do Drupal executando o seguinte comando 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.

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 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 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

    Observação:substitua 7.56 pela versão desejada.
    Como alternativa, você pode executar drush pm-update drupal para atualizar para a versão de núcleo mais recente do Drupal. É possível executar drush pm-updatestatus para listar as atualizações menores disponíveis para o núcleo do Drupal e os projetos de contribuição.
  5. Reaplique todas 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 seu representante de suporte da Apigee e informe as mensagens de erro que foram relatadas durante a atualização.