Central de Ajuda

React + Express + MySQL

React para a interface, Express sobre Node.js para a API e MySQL como banco de dados relacional.

É a variante do stack MERN para quando os dados têm relações claras entre si e convém um esquema com integridade referencial e consultas SQL.

Serviços incluídos

Além da sua aplicação, o Stack inicia o MySQL, um nginx que recebe o tráfego na porta 80, um serviço de backups automáticos e o gerenciador de arquivos web.

Estrutura do projeto

text
.
├── .docker
│   └── docker-compose.yaml
├── backend
│   ├── src
│   │   ├── config.js
│   │   ├── database.js
│   │   ├── index.js
│   │   └── server.js
│   ├── test
│   │   └── sample.js
│   ├── Dockerfile
│   ├── LICENSE
│   ├── healthcheck.js
│   ├── package-lock.json
│   └── package.json
├── backup
│   └── backup-runner.sh
├── frontend
│   ├── public
│   │   ├── favicon.ico
│   │   ├── index.html
│   │   ├── logo192.png
│   │   ├── logo512.png
│   │   ├── manifest.json
│   │   └── robots.txt
│   ├── src
│   │   ├── App.css
│   │   ├── App.js
│   │   ├── App.test.js
│   │   ├── index.css
│   │   ├── index.js
│   │   ├── logo.svg
│   │   ├── serviceWorker.js
│   │   ├── setupProxy.js
│   │   └── setupTests.js
│   ├── Dockerfile
│   ├── package-lock.json
│   └── package.json
├── nginx
│   └── default.conf
├── .env.example
└── compose.yaml

Iniciando

Instale o Stack e inicie-o:

bash
docker-deploy-stack --stack javascript/react-express-mysql
cd /root/stack/javascript/react-express-mysql
docker compose up -d

Depois substitua a aplicação de exemplo pela sua, via Git, por SFTP ou pelo gerenciador de arquivos web, seguindo como-implanto-uma-aplicacao-em-um-stack.md. Seu código fica na pasta app/.

Sempre que atualizar o código, aplique as alterações:

bash
docker compose up -d --build

Configuração

Os valores editáveis estão no arquivo .env do Stack:

Variável Padrão Para que serve
APP_ENV development Ambiente da aplicação.
DB_NAME example Nome do banco de dados.
DB_USER root Usuário do banco de dados.
BACKUP_ENABLED 1 Backups automáticos: 1 ativados, 0 desativados.
BACKUP_INTERVAL_SECONDS 86400 Intervalo em segundos entre backups.
BACKUP_RETENTION_DAYS 7 Quantos dias os backups são mantidos.
MARIADB_VERSION 10.6.4-focal Versão da imagem correspondente.

Depois de alterar, aplique as mudanças com docker compose up -d.

Comandos úteis

bash
docker compose ps          # ver os contêineres em execução
docker compose logs -f     # ver os logs em tempo real
docker compose restart     # reiniciar os serviços
docker compose down        # parar e remover os contêineres
Guia g.0296 · Versão de origem 1 · pt-BR