feat: explorer API, wallet, CCIP scripts, and config refresh
- Backend REST/gateway/track routes, analytics, Blockscout proxy paths. - Frontend wallet and liquidity surfaces; MetaMask token list alignment. - Deployment docs, verification scripts, address inventory updates. Check: go build ./... under backend/ (pass). Made-with: Cursor
This commit is contained in:
defiQUG
@@ -1,183 +1,40 @@
|
||||
# Deployment Summary
|
||||
|
||||
## Complete Deployment Package
|
||||
This directory contains two different kinds of deployment material:
|
||||
|
||||
All deployment files and scripts have been created and are ready for use.
|
||||
- current production references for the live explorer stack
|
||||
- older monolithic deployment scaffolding that is still useful as background, but is no longer the authoritative description of production
|
||||
|
||||
## 📁 File Structure
|
||||
## Current Production Summary
|
||||
|
||||
```
|
||||
deployment/
|
||||
├── DEPLOYMENT_GUIDE.md # Complete step-by-step guide (1,079 lines)
|
||||
├── DEPLOYMENT_TASKS.md # Detailed 71-task checklist (561 lines)
|
||||
├── DEPLOYMENT_CHECKLIST.md # Interactive checklist (204 lines)
|
||||
├── DEPLOYMENT_SUMMARY.md # This file
|
||||
├── QUICK_DEPLOY.md # Quick command reference
|
||||
├── README.md # Documentation overview
|
||||
├── ENVIRONMENT_TEMPLATE.env # Environment variables template
|
||||
│
|
||||
├── nginx/
|
||||
│ └── explorer.conf # Complete Nginx configuration
|
||||
│
|
||||
├── cloudflare/
|
||||
│ └── tunnel-config.yml # Cloudflare Tunnel template
|
||||
│
|
||||
├── systemd/
|
||||
│ ├── explorer-indexer.service
|
||||
│ ├── explorer-api.service
|
||||
│ ├── explorer-frontend.service
|
||||
│ └── cloudflared.service
|
||||
│
|
||||
├── fail2ban/
|
||||
│ ├── nginx.conf # Nginx filter
|
||||
│ └── jail.local # Jail configuration
|
||||
│
|
||||
└── scripts/
|
||||
├── deploy-lxc.sh # Automated LXC setup
|
||||
├── install-services.sh # Install systemd services
|
||||
├── setup-nginx.sh # Setup Nginx
|
||||
├── setup-cloudflare-tunnel.sh # Setup Cloudflare Tunnel
|
||||
├── setup-firewall.sh # Configure firewall
|
||||
├── setup-fail2ban.sh # Configure Fail2ban
|
||||
├── setup-backup.sh # Setup backup system
|
||||
├── setup-health-check.sh # Setup health monitoring
|
||||
├── build-all.sh # Build all applications
|
||||
├── verify-deployment.sh # Verify deployment
|
||||
└── full-deploy.sh # Full automated deployment
|
||||
```
|
||||
Start with [`LIVE_DEPLOYMENT_MAP.md`](./LIVE_DEPLOYMENT_MAP.md).
|
||||
|
||||
## 🚀 Quick Start
|
||||
The live explorer is currently assembled from separate deployment paths:
|
||||
|
||||
### Option 1: Automated Deployment
|
||||
```bash
|
||||
# Run full automated deployment
|
||||
sudo ./deployment/scripts/full-deploy.sh
|
||||
```
|
||||
| Component | Live service | Canonical deploy path |
|
||||
|---|---|---|
|
||||
| Next frontend | `solacescanscout-frontend.service` | [`scripts/deploy-next-frontend-to-vmid5000.sh`](../scripts/deploy-next-frontend-to-vmid5000.sh) |
|
||||
| Explorer config/API | `explorer-config-api.service` | [`scripts/deploy-explorer-ai-to-vmid5000.sh`](../scripts/deploy-explorer-ai-to-vmid5000.sh) |
|
||||
| Static config assets | nginx static files under `/var/www/html` | [`scripts/deploy-explorer-config-to-vmid5000.sh`](../scripts/deploy-explorer-config-to-vmid5000.sh) |
|
||||
| Relay fleet | `ccip-relay*.service` on `r630-01` | host-side `config/systemd/ccip-relay*.service` |
|
||||
|
||||
### Option 2: Step-by-Step Manual
|
||||
```bash
|
||||
# 1. Read the guide
|
||||
cat deployment/DEPLOYMENT_GUIDE.md
|
||||
## Public Verification
|
||||
|
||||
# 2. Follow tasks
|
||||
# Use deployment/DEPLOYMENT_TASKS.md
|
||||
- [`check-explorer-health.sh`](../scripts/check-explorer-health.sh)
|
||||
- [`check-explorer-e2e.sh`](../../scripts/verify/check-explorer-e2e.sh)
|
||||
- `https://explorer.d-bis.org/api/config/capabilities`
|
||||
- `https://explorer.d-bis.org/explorer-api/v1/track1/bridge/status`
|
||||
- `https://explorer.d-bis.org/explorer-api/v1/mission-control/stream`
|
||||
|
||||
# 3. Track progress
|
||||
# Use deployment/DEPLOYMENT_CHECKLIST.md
|
||||
```
|
||||
## Legacy Material In This Directory
|
||||
|
||||
## 📋 Deployment Phases
|
||||
These files remain in the repo, but they describe an older generalized package:
|
||||
|
||||
1. **LXC Container Setup** (8 tasks)
|
||||
- Create container
|
||||
- Configure resources
|
||||
- Install base packages
|
||||
|
||||
2. **Application Installation** (12 tasks)
|
||||
- Install Go, Node.js, Docker
|
||||
- Clone repository
|
||||
- Build applications
|
||||
|
||||
3. **Database Setup** (10 tasks)
|
||||
- Install PostgreSQL + TimescaleDB
|
||||
- Create database
|
||||
- Run migrations
|
||||
|
||||
4. **Infrastructure Services** (6 tasks)
|
||||
- Deploy Elasticsearch
|
||||
- Deploy Redis
|
||||
|
||||
5. **Application Services** (10 tasks)
|
||||
- Configure environment
|
||||
- Create systemd services
|
||||
- Start services
|
||||
|
||||
6. **Nginx Reverse Proxy** (9 tasks)
|
||||
- Install Nginx
|
||||
- Configure reverse proxy
|
||||
- Set up SSL
|
||||
|
||||
7. **Cloudflare Configuration** (18 tasks)
|
||||
- Configure DNS
|
||||
- Set up SSL/TLS
|
||||
- Configure Tunnel
|
||||
- Set up WAF
|
||||
- Configure caching
|
||||
|
||||
8. **Security Hardening** (12 tasks)
|
||||
- Configure firewall
|
||||
- Set up Fail2ban
|
||||
- Configure backups
|
||||
- Harden SSH
|
||||
|
||||
9. **Monitoring** (8 tasks)
|
||||
- Set up health checks
|
||||
- Configure logging
|
||||
- Set up alerts
|
||||
|
||||
## 🔧 Available Scripts
|
||||
|
||||
| Script | Purpose |
|
||||
|--------|---------|
|
||||
| `deploy-lxc.sh` | Automated LXC container setup |
|
||||
| `build-all.sh` | Build all applications |
|
||||
| `install-services.sh` | Install systemd service files |
|
||||
| `setup-nginx.sh` | Configure Nginx |
|
||||
| `setup-cloudflare-tunnel.sh` | Setup Cloudflare Tunnel |
|
||||
| `setup-firewall.sh` | Configure UFW firewall |
|
||||
| `setup-fail2ban.sh` | Configure Fail2ban |
|
||||
| `setup-backup.sh` | Setup backup system |
|
||||
| `setup-health-check.sh` | Setup health monitoring |
|
||||
| `verify-deployment.sh` | Verify deployment |
|
||||
| `full-deploy.sh` | Full automated deployment |
|
||||
|
||||
## 📝 Configuration Files
|
||||
|
||||
- **Nginx**: `nginx/explorer.conf`
|
||||
- **Cloudflare Tunnel**: `cloudflare/tunnel-config.yml`
|
||||
- **Systemd Services**: `systemd/*.service`
|
||||
- **Fail2ban**: `fail2ban/*.conf`
|
||||
- **Environment Template**: `ENVIRONMENT_TEMPLATE.env`
|
||||
|
||||
## ✅ Verification Checklist
|
||||
|
||||
After deployment, verify:
|
||||
|
||||
- [ ] All services running
|
||||
- [ ] API responding: `curl http://localhost:8080/health`
|
||||
- [ ] Frontend loading: `curl http://localhost:3000`
|
||||
- [ ] Nginx proxying: `curl http://localhost/api/health`
|
||||
- [ ] Database accessible
|
||||
- [ ] DNS resolving
|
||||
- [ ] SSL working (if direct connection)
|
||||
- [ ] Cloudflare Tunnel connected (if using)
|
||||
- [ ] Firewall configured
|
||||
- [ ] Backups running
|
||||
|
||||
## 🆘 Troubleshooting
|
||||
|
||||
See `QUICK_DEPLOY.md` for:
|
||||
- Common issues
|
||||
- Quick fixes
|
||||
- Emergency procedures
|
||||
|
||||
## 📊 Statistics
|
||||
|
||||
- **Total Tasks**: 71
|
||||
- **Documentation**: 1,844+ lines
|
||||
- **Scripts**: 11 automation scripts
|
||||
- **Config Files**: 8 configuration templates
|
||||
- **Estimated Time**: 6-8 hours (first deployment)
|
||||
|
||||
## 🎯 Next Steps
|
||||
|
||||
1. Review `DEPLOYMENT_GUIDE.md`
|
||||
2. Prepare environment (Proxmox, Cloudflare)
|
||||
3. Run deployment scripts
|
||||
4. Verify deployment
|
||||
5. Configure monitoring
|
||||
|
||||
---
|
||||
|
||||
**All deployment files are ready!**
|
||||
- `DEPLOYMENT_GUIDE.md`
|
||||
- `DEPLOYMENT_TASKS.md`
|
||||
- `DEPLOYMENT_CHECKLIST.md`
|
||||
- `QUICK_DEPLOY.md`
|
||||
- `systemd/explorer-api.service`
|
||||
- `systemd/explorer-frontend.service`
|
||||
|
||||
Treat those as scaffold or historical reference unless they have been explicitly updated to match the live split architecture.
|
||||
|
||||
Reference in New Issue
Block a user