atualiza README.md com informações sobre a versão e instalação; adiciona ícones para a interface

This commit is contained in:
Alexander Sabino 2026-05-08 22:33:59 +01:00
parent f1b291dde0
commit b763b3ca90
4 changed files with 62 additions and 27 deletions

View File

@ -1,39 +1,75 @@
# Docker Backup App
<p align="center">
<img src="./public/docker_backup_icon_for_appstore.png" width="200" alt="DockerBackup" />
</p>
⚠️ **AVISO CRÍTICO:** Esta é uma aplicação em estágio inicial de desenvolvimento, não use em produção de forma alguma, há risco de perda de dados ⚠️
<h1 align="center">DockerBackup</h1>
Aplicacao web para cadastrar profiles de backup de containers Docker, executar backup full ou incremental e restaurar snapshots de volumes e bind mounts.
<p align="center">
<em>Backup e restauração de containers Docker via interface web, com suporte a snapshots incrementais e restore seletivo.</em>
</p>
## Como funciona
<p align="center">
<img src="https://img.shields.io/badge/VERSION-1.0.0-blue?style=flat-square" />
<img src="https://img.shields.io/badge/NODE.JS-%3E%3D20-339933?style=flat-square&logo=node.js&logoColor=white" />
<img src="https://img.shields.io/badge/DOCKER-ready-2496ED?style=flat-square&logo=docker&logoColor=white" />
<img src="https://img.shields.io/badge/READY-yes-brightgreen?style=flat-square" />
<img src="https://img.shields.io/badge/STATUS-ACTIVE-success?style=flat-square" />
</p>
- O app lista os containers via Docker socket.
- Cada backup processa um container por vez: para, executa o backup dos mounts elegiveis e sobe novamente se ele estava rodando.
- O backup usa um container auxiliar com GNU tar e `--listed-incremental` para gerar arquivos compactados `.tar.gz`.
- Quando o app roda dentro de Docker, backup e restore sao feitos via Docker API (`getArchive`/`putArchive`) sem criar helper e sem mapear o root do host.
- Ha dois escopos por profile: `somente volumes` (comportamento tradicional) e `container inteiro` (tar unico por container a partir de `/`).
- O restore aplica a cadeia full + incrementais sobre os mounts atuais do container, limpando o conteudo antes de reconstituir o snapshot escolhido.
- Ao restaurar um backup, e possivel escolher quais containers do backup serao restaurados.
> ⚠️ **AVISO CRÍTICO:** Aplicação em estágio inicial de desenvolvimento. Não use em produção — há risco de perda de dados.
## Requisitos
Versão atual: **1.0.0**
- Docker Engine com acesso ao socket em `/var/run/docker.sock`.
- O diretorio de backup informado no profile precisa ser visivel para o Docker daemon.
- Em Docker Desktop no Windows, quando o app roda fora de container, paths como `C:\backups` sao convertidos automaticamente para `/run/desktop/mnt/host/c/backups`.
- Quando o app roda dentro de container, use um caminho absoluto interno do container (ex.: `/app/data/backups`).
- O escopo `container inteiro` exige que o app esteja rodando em Docker para usar backup/restore nativos sem helper.
---
## Executando com Docker Compose
## 🗄️ Visão geral
O `dockerbackup` fornece:
- Cadastro de **profiles de backup** por container
- Backup **full e incremental** com GNU tar + `--listed-incremental`
- Restore seletivo de snapshots, escolhendo quais containers restaurar
- Suporte a dois escopos: `somente volumes` e `container inteiro`
- Quando rodando dentro do Docker, usa a API nativa (`getArchive`/`putArchive`) sem helper
---
## ⚙️ Instalação
```bash
npm install
```
### Requisitos
- Docker Engine com acesso ao socket em `/var/run/docker.sock`
- O diretório de backup configurado no profile precisa ser visível para o Docker daemon
- Em Docker Desktop no Windows (fora de container), paths como `C:\backups` são convertidos automaticamente para `/run/desktop/mnt/host/c/backups`
- O escopo `container inteiro` exige que o app esteja rodando em Docker
---
## ▶️ Execução
### Com Docker Compose (recomendado)
```bash
docker compose up --build
```
Abra `http://localhost:3000`.
Acesse `http://localhost:3000`.
O arquivo `docker-compose.example.yml` foi mantido como referencia equivalente ao compose principal.
### Sem Docker
## Observacoes
```bash
npm start
```
- O restore valida se o conjunto de mounts do container continua igual ao do backup selecionado.
- O catalogo de profiles e historico de backups fica salvo em `./data/store.json`.
- Os arquivos `.tar.gz` sao gravados no diretorio de backup configurado em cada profile.
---
## 📋 Observações
- O restore valida se o conjunto de mounts do container continua igual ao do backup selecionado
- O catálogo de profiles e histórico de backups fica em `./data/store.json`
- Os arquivos `.tar.gz` são gravados no diretório configurado em cada profile
- O arquivo `docker-compose.example.yml` foi mantido como referência equivalente ao compose principal

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.3 MiB

BIN
public/icon.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.4 MiB

View File

@ -8,6 +8,7 @@
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=IBM+Plex+Mono:wght@400;500&display=swap" rel="stylesheet" />
<link rel="stylesheet" href="/styles.css" />
<link rel="icon" type="image/png" href="/icon.png" />
</head>
<body>
<div class="app-shell">
@ -15,9 +16,7 @@
<!-- ===== SIDEBAR ===== -->
<nav class="sidebar">
<div class="sidebar-brand">
<svg class="brand-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
<path d="M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z"/>
</svg>
<img src="/icon.png" class="brand-icon" alt="DockerBackup" />
<span>DockerBackup</span>
</div>