audb 0.1.11

AuDB - Compile-time database application framework with gold files
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

# Deployment Configuration Example

This example demonstrates how to configure deployment settings in gold files using the `config deployment { ... }` block.

## Files

- `gold/app.au` - Example gold file with deployment configuration

## Deployment Configuration

The deployment config block supports:

### Basic Settings

```au
config deployment {
  target = "docker"           // docker, systemd, daemon, or local
  persist = true              // persist across reboots
  port = 3000                 // port to expose
  restart = "unless-stopped"  // restart policy
}
```

### Environment Variables

```au
config deployment {
  environment {
    DATABASE_URL = "sqlite://data/app.db"
    LOG_LEVEL = "info"
    RUST_LOG = "debug"
  }
}
```

### Volume Mappings

```au
config deployment {
  volumes {
    "./data" = "/app/data"  // host_path = container_path
    "./logs" = "/app/logs"
  }
}
```

### Health Checks

```au
config deployment {
  healthcheck {
    endpoint = "/api/health"  // health check endpoint
    interval = "10s"          // check interval
    timeout = "30s"           // request timeout
    retries = 5               // retries before unhealthy
  }
}
```

## Testing the Configuration

From this directory:

```bash
# Parse and validate the configuration
au check

# Deploy using the configuration
au deploy start

# Check deployment status
au deploy status

# View logs
au deploy logs

# Stop deployment
au deploy stop
```

## What Gets Deployed

When you run `au deploy start`, the CLI will:

1. Parse `gold/app.au` and extract the deployment config
2. Validate the gold files
3. Generate code from schemas and queries
4. Build release binary (`cargo build --release`)
5. Create Docker image with the specified configuration:
   - Port 3000 exposed
   - Environment variables set
   - Volumes mounted
   - Health check configured on `/api/health`
6. Start the container with `unless-stopped` restart policy
7. Verify deployment with health checks

## Fallback Behavior

If no `config deployment { ... }` block is found:
- Uses Docker as default target
- Port 8080
- Basic health check on `/health`
- No environment variables or volumes
- Restart policy: `unless-stopped`

## Notes

- The deployment config is parsed at deploy time from the gold files
- Changes to the config require redeployment
- Invalid configurations will show warnings and fall back to defaults
- You can override settings with CLI flags (TODO: implementation in progress)