Você pode instalar o i-Educar utilizando Docker ou diretamente no seu servidor web, caso você deseje atualizar sua instalação siga os passos do guia de atualização.
Para executar o projeto é necessário a utilização de alguns softwares.
Para instalar o projeto execute todos os passos abaixo:
ATENÇÃO: Essa forma de instação tem o objetivo de facilitar demonstrações e desenvolvimento. Não é recomendado para ambientes de produção!
Clone o repositório:
git clone git@github.com:portabilis/i-educar.git && cd i-educarCopie o arquivo docker-compose.example.yml e faça as configurações para o seu ambiente:
cp docker-compose.example.yml docker-compose.override.ymlFaça o build das imagens Docker utilizadas no projeto e inicie os containers da aplicação (pode levar alguns minutos):
docker-compose up -d --buildExecute o comando para fazer uma nova instalação:
docker-compose exec php composer new-install
docker-compose exec php artisan db:seedNo arquivo docker-compose.override.yml você pode personalizar sua instalação do i-Educar, mudando as portas dos
serviços ou o mapeamento dos volumes da aplicação.
A ferramenta Xdebug está incluída no projeto com o intuito de facilitar o processo de debug
durante o desenvolvimento. Para configurá-la, modifique os valores das variáveis XDEBUG_* no arquivo
docker-compose.override.yml conforme orientações da sua IDE de desenvolvimento.
Para executar os testes automatizados, é necessário ter o i-Educar rodando com uma base limpa, apenas a estrutura inicial e suas migrations, crie o arquivo de configuração:
cp .env.example .env.testingExecute o comando:
docker-compose exec php vendor/bin/pestPara instalar o projeto execute todos os passos abaixo conectado em seu servidor web:
Este passo a passo serve para um servidor Ubuntu 22.04 LTS e não tem configurações mínimas de segurança
Gere uma chave SSH no seu servidor, copie e adicione ao seu GitHub https://github.com/settings/keys.
ssh-keygen -t ed25519
cat ~/.ssh/id_ed25519.pub # copie e adicione ao seu GitHubAdicione os repositórios de dependências e sincronize a lista de diretórios:
add-apt-repository ppa:openjdk-r/ppa -y
add-apt-repository ppa:ondrej/php -y
apt updateInstale as dependências:
apt install -y nginx redis postgresql postgresql-contrib openjdk-8-jdk openssl unzip php8.3-common php8.3-cli php8.3-fpm php8.3-bcmath php8.3-curl php8.3-mbstring php8.3-pgsql php8.3-xml php8.3-zip php8.3-gdInicie o serviço de banco de dados:
systemctl start postgresql.service
sudo -i -u postgresCrie o usuário do banco de dados, quando solicitado uma senha, utilize ieducar:
createuser ieducar --superuser --createdb --pwpromptCrie o banco de dados e volte ao usuário root:
createdb ieducar
exitConfigure o Composer:
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/bin --filename=composer
php -r "unlink('composer-setup.php');"
export COMPOSER_ALLOW_SUPERUSER=1Clone o repositório do i-Educar e copie o arquivo .env:
git clone https://github.com/portabilis/i-educar.git /var/www/ieducar
cd /var/www/ieducar/
cp /var/www/ieducar/.env.example /var/www/ieducar/.envCopie os arquivos de configuração do Nginx:
cp /var/www/ieducar/docker/nginx/default.conf /etc/nginx/conf.d/default.conf
cp /var/www/ieducar/docker/nginx/upstream.conf /etc/nginx/conf.d/upstream.conf
sed -i 's/php:9000/unix:\/run\/php\/php-fpm.sock/g' /etc/nginx/conf.d/upstream.conf
rm /etc/nginx/sites-enabled/default
nginx -s reloadFaça a instalação do i-Educar:
composer new-installPopule o banco de dados com os dados iniciais necessários para o funcionamento:
php artisan db:seedEste passo é opcional, mas caso você desejar, você pode popular o banco de dados com alguns dados iniciais utilizando o comando abaixo:
php artisan db:seed --class=DemoSeederAcesse http://localhost ou o IP do seu servidor para fazer o seu primeiro acesso.
O usuário padrão é: admin / A senha padrão é: 123456789.
Assim que realizar seu primeiro acesso não se esqueça de alterar a senha padrão.