O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Fazer upgrade do Drupal

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.

Fazer upgrade do núcleo do Drupal

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

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.

Se, durante um upgrade do Private Cloud (por exemplo, de 4.18.05 para 4.19.01), o utilitário de atualização da Apigee fizer o downgrade da sua versão do Drupal, talvez seja necessário executar novamente o utilitário de upgrade do Drupal. Para mais informações, consulte Executar novamente o upgrade do Drupal.
É preciso executar os comandos do 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)
O procedimento abaixo pressupõe uma instalação do servidor Nginx no local padrão acima.

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.

Atualizar a versão do Drupal

Nesta seção, descrevemos como usar os comandos do Drush em uma linha de comando para atualizar sua versão do Drupal. Consulte também Como atualizar o Drupal usando o Drush (Drupal.org).

Para atualizar sua instalação do Drupal:

Mude para o diretório /opt/apigee/apigee-drupal/wwwroot ou para 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ê 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.

Coloque o 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, 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.
Aplique novamente as alterações feitas em .htaccess, robots.txt ou defaults.settings.php (no diretório sites).
Reaplique as alterações feitas no diretório sites/all .

Tire 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 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, será possível substituí-lo por uma versão mais recente armazenando-a 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 da 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 mais informações, consulte Como mover módulos e temas (Drupal.org).

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 suporte do Apigee Edge e forneça as mensagens de erro que foram informadas durante a atualização.