Skip to content

Latest commit

 

History

History
80 lines (48 loc) · 3.39 KB

mc_deploy_update.md

File metadata and controls

80 lines (48 loc) · 3.39 KB

Mapas Culturais > Update

Depois que a instalação está completa. Em alguma hora será necessário atualizar o código fonte da aplicação para adquirir novas funcionalidades que tenham sido adicionadas ao mapa.

A seguir serão descritos os passos para efetuar a atualização com sucesso.

Atualizando o código fonte

Antes de começar

Antes de mais nada, faça backup do seu ambiente e do seu banco de dados.

O código deve ser atualizado através de um release, disponível em https://github.com/hacklabr/mapasculturais/releases. Veja qual é a nova versão e qual é a versão que você está utilizando.

Visite a pasta de documentação Release notes e verifique as anotações que existem para as versões entre a sua e a mais nova. Para algumas versões específicas, podem haver procedimentos específicos, ou apenas cuidados a serem tomados. Leia com atenção e veja se precisa preparar alguma coisa antes de começar o procedimento de atualização.

Atuaizando

O primeiro passo é atualizar as referências do novo código (pra saber que existem novas atualização no código e releases), isso pode ser feito utilizando o comando git fetch:

$ git fetch

Para atualizar para uma nova versão estável, rode o comando git checkout [release], onde [release] é o release desejado. A seguir um exemplo fazendo um checkout para a versão "3.2":

$ git checkout 3.2

Script de Atualização

Após obter o código fonte, o próximo passo é rodar o script deploy.sh localizado na pasta scripts. Esse arquivo atualiza libs e dependências da aplicação e atualiza o banco de dados com novos campos e/ou tabelas. O comando pra executar esse script (a partir da raiz da aplicação) é:

$ cd scripts
$ ./deploy.sh

Reiniciando o PHP

Após essa alterações serem efetuadas, é necessário reiniciar o serviço do PHP para que todos os arquivos sejam reescritos corretamente. Isso requer permissão de root.

Se estiver utilizando php-fpm (instalação com nginx):

# sudo service php-fpm restart

Se estiver utilizando o apache, o php está sendo executado através do próprio apache:

# sudo service apache2 restart

Possíveis problemas

Permissão

Todos os comandos (exceto o comando para reiniciar o PHP) devem ser executados com o mesmo usuário da aplicação do mapas. Se algum comando tiver sido executado como root, ou qualquer outro usuário a aplicação pode apresentar problemas diversos. Para alterar os arquivos para o usuário correto, utilize o comando (assumindo que o usuário correto da aplicação se chama mapas e o grupo é www-data):

# chown -R mapas:www-data .

Git Pull

Se algum arquivo da aplicação tiver sido alterado no servidor, essa alteração deve ser descartada para que o git pull funcione corretamente. Para reverter um arquivo utilize o comando git checkout [endereco_do_arquivo]

$ git checkout [endereco_do_arquivo]

Para mais detalhe sobre como utilizar o comando veja a documentação em https://git-scm.com/docs/git-pull.

Dúvidas

Caso o seu problema seja diferente, consulte o Grupo da Comunidade em http://t.me/RedeMapas.

Escolha o tópico que considerar mais apropriado e faça a pergunta para que a comunidade possa ajudar a encontrar uma solução.