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

Edge para nuvem privada v. 4.17.09

Em uma instalação do Edge para nuvem privada 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, um patch, uma atualização de segurança ou outro tipo de atualização do Drupal. No caso de uma atualização de segurança, faça 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 7.56).

Observações:

  • Esse procedimento só atualiza a instalação do Drupal. Ele não atualiza o software da Apigee que é fornecido 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.

  • Você precisa executar os comandos do Drush no diretório raiz do site do portal. Por padrão, o Portal do desenvolvedor está 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 a versão atual do Drupal

Antes de iniciar a atualização do Drupal, determine a versão atual dele 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.

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 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 alterações novamente após a atualização. Também será necessário reaplicar todas as personalizações feitas no diretório sites/all.

  3. Colocar o site no modo de manutenção:
    > drush vset --exact maintenance_mode 1 
    > drush cache-clear all
    
  4. Instale a versão pretendida do Drupal usando o seguinte comando:

    > drush pm-update drupal-7.56

    Observação:substitua a versão 7.56 pela versão desejada.
    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 pequenas atualizações disponíveis para os projetos de contribuição e o núcleo do Drupal.
  5. Reaplique todas as mudanças feitas em .htaccess, robots.txt ou defaults.settings.php (no diretório sites).
  6. Aplique novamente 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 para o estado anterior usando os arquivos de backup que você criou. Entre em contato com seu representante de suporte da Apigee e forneça as mensagens de erro informadas durante a atualização.