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 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.
Fazer upgrade do núcleo do 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, do Drupal 7.54 para 7.59).
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 Fazer upgrade do portal.
Se durante um upgrade de nuvem privada (por exemplo, de 4.18.05 para 4.19.01), o utilitário de atualização da Apigee faz downgrade da versão do Drupal, talvez seja necessário executar novamente o utilitário de upgrade do Drupal. Para saber mais, consulte Executar novamente o upgrade do Drupal.
- Execute os comandos Drush
(Drupal Shell) 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)
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
.
Atualizar a versão do Drupal
Esta seção descreve como usar comandos do Drush em uma linha de comando para atualizar a versão do Drupal. Consulte também Como atualizar o Drupal usando o Drush (Drupal.org).
Para atualizar a instalação do Drupal:
- Mude para o diretório
/opt/apigee/apigee-drupal/wwwroot
ou o diretório em que você instalou o portal. - 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
oudefaults.settings.php
(no diretóriosites
), 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óriosites/all
. - Coloque seu site no modo de manutenção:
drush vset --exact maintenance_mode 1
drush cache-clear all
- 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, você pode executar
drush pm-update drupal
a fim de atualizar para a versão mais recente do núcleo do Drupal. Executedrush pm-updatestatus
para listar as pequenas atualizações disponíveis para os projetos de núcleo e de contribuição do Drupal. - Reaplique todas as mudanças feitas em
.htaccess
,robots.txt
oudefaults.settings.php
(no diretóriosites
). - Aplique novamente as alterações feitas no diretório
sites/all
. - Remova o site do modo de manutenção:
drush vset --exact maintenance_mode 0
drush cache-clear all
Fazer upgrade dos módulos de contribuição do PHP e do Drupal
Quando você faz o 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 atualizados. No entanto, você precisa acompanhar os módulos mais recentes do Drupal entre as versões da nuvem privada.
Se o módulo estiver em /profiles/apigee/modules/contrib
, você poderá substituí-lo
por uma versão mais recente desse módulo, armazenando a versão mais recente em
/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 de nuvem privada que inclua uma versão mais recente do módulo
armazenado anteriormente em /sites/all/modules/contrib
, remova o módulo de
/sites/all/modules/contrib
. Para ver mais informações, consulte
Como mover
módulos e temas (Drupal.org).
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 o suporte do Apigee Edge e informe as mensagens de erro que foram informadas durante a atualização.