Skip to content

Latest commit

 

History

History
81 lines (57 loc) · 3.96 KB

UPGRADE.md

File metadata and controls

81 lines (57 loc) · 3.96 KB

Guia de atualização

Este guia tem o intuido de auxiliar no processo de atualização do i-Educar para a versão 2.9 a partir da versão 2.8.

Importante: faça o backup do seu banco de dados antes de iniciar qualquer procedimento.

Requisitos mínimos

Os requisitos que foram testados para utilizar a versão 2.9 são:

Software Versão Comando Descrição
Laravel 11 php artisan --version Framework
PHP 8.3 php --version Linguagem de programação
Composer 2.7 composer --version Gerenciador de dependências
Nginx 1.26 nginx -v Servidor web
Postgres 16 psql --version Banco de dados
Redis 7 redis-cli --version Banco de dados
Git 2.45 git --version Controle de versão
Ubuntu 22.04 lsb_release -a Sistema operacional
Docker dev 26 docker --version Containerização
Docker Compose dev 2.27 docker-compose --version Orquestração de containers

dev: requisito para ambiente de desenvolvimento.

Upgrade via linha de comando

Para fazer o upgrade para a versão 2.9 a partir da versão 2.8 do i-Educar você precisará executar os seguintes passos:

Para usuários Docker, executar os comandos # (Docker) ao invés da linha seguinte.

git fetch
git checkout 2.8

# (Docker) docker-compose exec php artisan migrate
php artisan migrate

Neste momento é necessário fazer backup do seu banco de dados Postgres versão 15, instalar a versão 16 e fazer a restauração do banco de dados na nova versão.

Atualize o código fonte:

# Importante: faça o backup do seu banco de dados
 
# (Docker) docker-compose down

git checkout 2.9.0

# (Docker) docker-compose build
# (Docker) docker-compose up -d

# Importante: faça a restauração do seu banco de dados 

# (Docker) docker-compose exec php composer update-install
# (Docker) docker-compose exec php composer plug-and-play:update 
composer update-install
composer plug-and-play:update

Sua instalação estará atualizada e você poderá realizar seu primeiro acesso na nova versão do i-Educar.

Personalizar o ambiente com Docker

Na versão 2.9 o arquivo docker-compose.yml utiliza variáveis de ambiente para expor as portas dos containers. Você pode adicionar no seu arquivo .env:

Variável Descrição
DOCKER_NGINX_PORT Porta HTTP da aplicação
DOCKER_NGINX_SSL_PORT Porta HTTPS da aplicação
DOCKER_POSTGRES_PORT Porta do banco de Dados
DOCKER_REDIS_PORT Porta do serviço de cache

Você também pode utilizar o arquivo docker-compose.override.yml para mais configurações.