Skip to content

Latest commit

 

History

History
109 lines (78 loc) · 4.58 KB

UPGRADE.md

File metadata and controls

109 lines (78 loc) · 4.58 KB
Raw

Guia de atualização

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

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.8 são:

Software Versão Comando Descrição
Laravel 10 php artisan --version Framework
PHP 8.2 php --version Linguagem de programação
Composer 2.5 composer --version Gerenciador de dependências
Nginx 1.25 nginx -v Servidor web
Postgres 15 psql --version Banco de dados
Redis 7 redis-cli --version Banco de dados
Git 2.40 git --version Controle de versão
Ubuntu 22.04 lsb_release -a Sistema operacional
Docker dev 24 docker --version Containerização
Docker Compose dev 2.19 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.8 a partir da versão 2.7 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.7

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

Neste momento é necessário fazer backup do seu banco de dados Postgres versão 14, instalar a versão 15 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.8.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.

Configurar ambiente com Docker

Na versão 2.8 o arquivo docker-compose.yml não expõem nenhuma porta dos containers para evitar conflitos. Para isso, utilize o arquivo docker-compose.override.yml e configure quais portas deseja que os serviços sejam executados.

cp docker-compose.yml docker-compose.override.yml

Arquivo de exemplo de configuração do docker-compose.override.yml

O exemplo abaixo possui configurações básicas que podem ser customizadas e que não irão interferir no código fonte original do projeto permitindo assim um maior controle do seu ambiente.

version: '3.8'

services:

  php:
    container_name: ieducar-php
    volumes:
      - ~/.ssh:/root/.ssh:ro # permite conexões usando suas chaves SSH

  nginx:
    container_name: ieducar-nginx
    ports:
      - "80:80"   # permite acessar o i-Educar em http://localhost, ou
      - "8000:80" # permite acessar o i-Educar em http://localhost:8080

  postgres:
    container_name: ieducar-postgres
    ports:
      - "5432:5432" # permite conectar software gerenciador de banco de dados

  redis:
    container_name: ieducar-redis
    ports:
      - "6379:6379" # permite conectar software gerenciador de banco de dados