Fazer upgrade do Drupal

Em uma instalação do Edge for Private Cloud do portal Apigee Developer Services (ou simplesmente no portal), você pode receber um notificação de que uma nova versão do Drupal está disponível. Uma nova versão pode significar um recurso Drupal patch, atualização de segurança ou outro tipo de atualização Drupal. No caso de uma segurança atualize a instalação do Drupal o mais rápido possível para garantir que site permaneça seguro.

Fazer upgrade do núcleo Drupal

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 a 7.59).

Observações:

  • Este procedimento apenas atualiza a instalação do Drupal. Isso não atualiza a Apigee ou software distribuído como parte do portal. Para informações sobre como fazer upgrade do portal da Apigee do software, consulte Fazer upgrade do portal.

    Se durante um upgrade de nuvem privada (por exemplo, de 4.18.05 para 4.19.01), a Apigee utilitário faz o downgrade da sua versão do Drupal, talvez seja necessário executar novamente o Utilitário de atualização do Drupal. Para mais informações, consulte Execute o upgrade do Drupal novamente.

  • Execute o Drush (Drupal Shell) do diretório raiz do site do portal. Por padrão, o portal está instalado em:
    • /opt/apigee/apigee-drupal/wwwroot (Nginx)
    • /var/www/html (Apache)
    O procedimento abaixo pressupõe a instalação de um servidor Nginx no local padrão acima.

Determinar a versão atual do Drupal

Antes de iniciar a atualização do Drupal, é possível determinar a versão atual do Drupal executando o comando a seguir da pasta de instalação do Drupal. Por padrão, o Drupal é instalado /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 os comandos do Drush em uma linha de comando para atualizar seu Drupal para a versão anterior. Consulte também Atualizar Drupal Usar o Drush (Drupal.org).

Para atualizar a instalação do Drupal:

  1. Mude para /opt/apigee/apigee-drupal/wwwroot ou no diretório em que o portal foi instalado.
  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 Drupal. Para instruções completas, consulte Faça backup do portal.

    Se você fez modificações em arquivos como .htaccess, robots.txt ou defaults.settings.php (no sites ), será necessário reaplicar as alterações após a atualização. Você também vai precisar reaplique 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-version

    Em que version é a versão desejada.

    Como alternativa, execute drush pm-update drupal para atualizar para a versão mais recente Versão Drupal Core. Execute drush pm-updatestatus para listar as opções atualizações pequenas aos projetos principais e de contribuição da Drupal.

  5. Reaplicar alterações feitas em .htaccess, robots.txt, ou defaults.settings.php (em diretório sites).
  6. Reaplique todas as mudanças feitas no diretório sites/all .
  7. Tire seu site do modo de manutenção:
    drush vset --exact maintenance_mode 0
    drush cache-clear all

Fazer upgrade dos módulos de contribuição PHP e Drupal

Quando você faz upgrade do Drupal usando as instruções acima nesta seção, os módulos usados pelo Drupal como contrib e PHP, também são atualizadas. No entanto, você deve acompanhar as atualizações mais recentes do Drupal entre as versões da nuvem privada.

Se o módulo estiver em /profiles/apigee/modules/contrib, você poderá substituir com uma versão mais recente desse módulo, armazenando a versão mais recente no /sites/all/modules/contrib. O Edge para nuvem privada usa a versão mais recente em /sites/all/modules/contrib em vez da versão mais antiga em /profiles/apigee/modules/contrib. Para mais informações, consulte Como atualizar módulos (Drupal.org).

Se você instalar uma nova versão da nuvem privada que inclui uma versão mais recente do módulo anteriormente armazenada em /sites/all/modules/contrib, remova o módulo /sites/all/modules/contrib: Para mais informações, consulte Mudança módulos e temas (Drupal.org).

E se eu encontrar um problema durante o atualizar?

Restaure o site ao estado anterior usando os arquivos de backup criados. Contato Suporte do Apigee Edge e forneça as mensagens de erro que foram informadas durante a atualização.