From 527daaf4693c2361d776a3be6dc028757aafe514 Mon Sep 17 00:00:00 2001 From: Eder Soares Date: Wed, 19 Jun 2024 16:52:53 -0300 Subject: [PATCH] Upgrade --- UPGRADE.md | 48 +++++++++++++++++++++++------------------------- 1 file changed, 23 insertions(+), 25 deletions(-) diff --git a/UPGRADE.md b/UPGRADE.md index 97aae42..582750f 100644 --- a/UPGRADE.md +++ b/UPGRADE.md @@ -1,46 +1,46 @@ # 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](https://github.com/portabilis/i-educar/tree/2.8) a partir da versão -[2.7](https://github.com/portabilis/i-educar/tree/2.7). +[2.9](https://github.com/portabilis/i-educar/tree/2.9) a partir da versão +[2.8](https://github.com/portabilis/i-educar/tree/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.8](https://github.com/portabilis/i-educar/tree/2.8) são: - -| Software | Versão | Comando | Descrição | -|----------------------------------------------------------|-----------|----------------------------|-----------------------------| -| [Laravel](https://laravel.com/) | `10` | `php artisan --version` | Framework | -| [PHP](http://php.net/) | `8.2` | `php --version` | Linguagem de programação | -| [Composer](https://getcomposer.org/) | `2.5` | `composer --version` | Gerenciador de dependências | -| [Nginx](https://www.nginx.com/) | `1.25` | `nginx -v` | Servidor web | -| [Postgres](https://www.postgresql.org/) | `15` | `psql --version` | Banco de dados | -| [Redis](https://redis.io/) | `7` | `redis-cli --version` | Banco de dados | -| [Git](https://git-scm.com/) | `2.40` | `git --version` | Controle de versão | -| [Ubuntu](https://ubuntu.com/) | `22.04` | `lsb_release -a` | Sistema operacional | -| [Docker](https://www.docker.com/) `dev` | `24` | `docker --version` | Containerização | -| [Docker Compose](https://docs.docker.com/compose/) `dev` | `2.19` | `docker-compose --version` | Orquestração de containers | +Os requisitos que foram testados para utilizar a versão [2.9](https://github.com/portabilis/i-educar/tree/2.9) são: + +| Software | Versão | Comando | Descrição | +|----------------------------------------------------------|---------|----------------------------|-----------------------------| +| [Laravel](https://laravel.com/) | `11` | `php artisan --version` | Framework | +| [PHP](http://php.net/) | `8.3` | `php --version` | Linguagem de programação | +| [Composer](https://getcomposer.org/) | `2.7` | `composer --version` | Gerenciador de dependências | +| [Nginx](https://www.nginx.com/) | `1.26` | `nginx -v` | Servidor web | +| [Postgres](https://www.postgresql.org/) | `16` | `psql --version` | Banco de dados | +| [Redis](https://redis.io/) | `7` | `redis-cli --version` | Banco de dados | +| [Git](https://git-scm.com/) | `2.45` | `git --version` | Controle de versão | +| [Ubuntu](https://ubuntu.com/) | `22.04` | `lsb_release -a` | Sistema operacional | +| [Docker](https://www.docker.com/) `dev` | `26` | `docker --version` | Containerização | +| [Docker Compose](https://docs.docker.com/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.8](https://github.com/portabilis/i-educar/tree/2.8) a partir da versão -[2.7](https://github.com/portabilis/i-educar/tree/2.7) do i-Educar você precisará executar os seguintes passos: +Para fazer o upgrade para a versão [2.9](https://github.com/portabilis/i-educar/tree/2.9) a partir da versão +[2.8](https://github.com/portabilis/i-educar/tree/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. ```bash git fetch -git checkout 2.7 +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 14, instalar a versão 15 e **fazer a +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: @@ -50,7 +50,7 @@ Atualize o código fonte: # (Docker) docker-compose down -git checkout 2.8.0 +git checkout 2.9.0 # (Docker) docker-compose build # (Docker) docker-compose up -d @@ -68,12 +68,12 @@ Sua instalação estará atualizada e você poderá realizar seu ### Configurar ambiente com Docker -Na versão [2.8](https://github.com/portabilis/i-educar/tree/2.8) o arquivo `docker-compose.yml` não expõem nenhuma porta +Na versão [2.9](https://github.com/portabilis/i-educar/tree/2.9) 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. ```bash -cp docker-compose.yml docker-compose.override.yml +cp docker-compose.example.yml docker-compose.override.yml ``` #### Arquivo de exemplo de configuração do `docker-compose.override.yml` @@ -82,8 +82,6 @@ O exemplo abaixo possui configurações básicas que podem ser customizadas e qu original do projeto permitindo assim um maior controle do seu ambiente. ```yml -version: '3.8' - services: php: -- libgit2 0.21.2