v2-exece-docs

This commit is contained in:
IGNY8 VPS (Salman)
2026-03-23 10:30:51 +00:00
parent b94d41b7f6
commit e78a41f11c
15 changed files with 2218 additions and 707 deletions

View File

@@ -3,8 +3,9 @@
**Status:** Pre-Implementation
**Phase:** Phase 0 - Foundation & Infrastructure
**Document ID:** 00E
**Version:** 1.0
**Version:** 1.1
**Created:** 2026-03-23
**Source of Truth:** Codebase at `/data/app/igny8/`
---
@@ -322,8 +323,8 @@ ssh user@new-vps-ip
docker ps -a | grep -v Exit
# Verify application health endpoints
curl -v https://app.igny8.local/health
curl -v https://api.igny8.local/status
curl -v https://app.igny8.com/api/v1/system/status/
curl -v https://api.igny8.com/api/v1/system/status/
# Check recent logs for errors
docker logs --tail 100 [service-name] | grep -i error
@@ -366,22 +367,22 @@ OLD_VPS_IP="x.x.x.x"
NEW_VPS_IP="y.y.y.y"
# Check all production DNS records for organization
nslookup igny8.local
nslookup api.igny8.local
nslookup app.igny8.local
nslookup git.igny8.local # Should NOT resolve to old VPS
nslookup igny8.com
nslookup api.igny8.com
nslookup app.igny8.com
nslookup git.igny8.com # Should NOT resolve to old VPS
# Use dig for more detailed DNS information
dig igny8.local +short
dig @8.8.8.8 igny8.local +short # Check public DNS
dig igny8.com +short
dig @8.8.8.8 igny8.com +short # Check public DNS
# Search DNS for any remaining old VPS references
getent hosts | grep $OLD_VPS_IP
# Verify all subdomains point to new VPS
for domain in api app git cdn mail; do
echo "Checking $domain.igny8.local..."
dig $domain.igny8.local +short
echo "Checking $domain.igny8.com..."
dig $domain.igny8.com +short
done
# IMPORTANT: Identify test DNS records created during 00C validation that must be removed
@@ -562,19 +563,19 @@ grep "Accepted" /var/log/auth.log | tail -20
**Commands:**
```bash
# Repeat DNS verification from Step 1.4
nslookup igny8.local
dig api.igny8.local +short
dig app.igny8.local +short
nslookup igny8.com
dig api.igny8.com +short
dig app.igny8.com +short
# Check for any CNAME chains
dig igny8.local CNAME
dig igny8.com CNAME
# Verify mail records don't point to old VPS
dig igny8.local MX
dig igny8.local NS
dig igny8.com MX
dig igny8.com NS
# Use external DNS checker
curl "https://dns.google/resolve?name=igny8.local&type=A" | jq .
curl "https://dns.google/resolve?name=igny8.com&type=A" | jq .
# Verify test DNS records still exist (to be removed in Step 3.4)
nslookup test-app.igny8.com
@@ -877,8 +878,8 @@ df -h
ssh user@new-vps-ip
# Run smoke tests for all critical services
curl -v https://api.igny8.local/health
curl -v https://app.igny8.local/
curl -v https://api.igny8.com/api/v1/system/status/
curl -v https://app.igny8.com/
# Run database operations
docker exec [app-container] /app/bin/test-db-connection
@@ -1211,8 +1212,8 @@ echo "Checking new VPS health..."
ssh user@$VPS_IP "docker ps -a" | grep -E "Up|Exited"
# Check endpoints
curl -s https://api.igny8.local/health | jq .
curl -s https://app.igny8.local/ > /dev/null && echo "App endpoint OK"
curl -s https://api.igny8.com/api/v1/system/status/ | jq .
curl -s https://app.igny8.com/ > /dev/null && echo "App endpoint OK"
# Check resources
ssh user@$VPS_IP "free -h | awk 'NR==2'"
@@ -1238,7 +1239,7 @@ NEW_IP=$2
echo "Verifying DNS records..."
domains=("igny8.local" "api.igny8.local" "app.igny8.local" "git.igny8.local")
domains=("igny8.com" "api.igny8.com" "app.igny8.com" "git.igny8.com")
for domain in "${domains[@]}"; do
current_ip=$(dig +short $domain @8.8.8.8 | head -1)
@@ -1486,11 +1487,11 @@ echo "Running smoke tests on new VPS..."
# Test APIs
echo "Testing API health..."
curl -s https://api.igny8.local/health | jq . || echo "FAILED"
curl -s https://api.igny8.com/api/v1/system/status/ | jq . || echo "FAILED"
# Test app
echo "Testing web app..."
curl -s -o /dev/null -w "%{http_code}" https://app.igny8.local/ || echo "FAILED"
curl -s -o /dev/null -w "%{http_code}" https://app.igny8.com/ || echo "FAILED"
# Test database
echo "Testing database..."
@@ -1662,7 +1663,7 @@ git push origin main
**Diagnosis:**
```bash
dig igny8.local +short
dig igny8.com +short
# Returns: x.x.x.x (old VPS IP)
```
@@ -1671,7 +1672,7 @@ dig igny8.local +short
2. Verify TTL has expired (may need to wait 24+ hours)
3. Manually update DNS records if needed
4. Flush local DNS cache: `sudo systemctl restart systemd-resolved`
5. Re-verify from external DNS: `dig @8.8.8.8 igny8.local`
5. Re-verify from external DNS: `dig @8.8.8.8 igny8.com`
---
@@ -1718,7 +1719,7 @@ ssh user@$OLD_VPS_IP "docker top gitea"
**Diagnosis:**
```bash
curl https://api.igny8.local/health
curl https://api.igny8.com/api/v1/system/status/
# Returns: 500 Internal Server Error
```