Content Delivery Network configuration for astronomical static assets
This directory contains the CDN configuration for distributing Nyx static assets including star textures, planet images, nebula photographs, and catalog data.
Overview#
The Nyx CDN is designed to efficiently serve large astronomical assets with appropriate caching policies based on content update frequency.
Asset Categories#
Textures (Immutable, 1 Year Cache)#
| Path | Content | Size Range | Format |
|---|---|---|---|
/textures/stars/ |
Star sprite sheets, sky background tiles | 1-50 MB | PNG, WebP |
/textures/planets/ |
Planet surface textures, normal maps | 10-200 MB | JPG, PNG |
/textures/nebulae/ |
Nebula photographs, emission maps | 5-100 MB | JPG, PNG |
/textures/galaxies/ |
Galaxy images, morphology maps | 5-100 MB | JPG, PNG |
/textures/constellations/ |
Constellation artwork | 1-10 MB | SVG, PNG |
/textures/milkyway/ |
Milky Way panoramas | 50-500 MB | JPG |
Catalog Data (7 Day Cache)#
| Path | Content | Size Range | Format |
|---|---|---|---|
/catalogs/hipparcos/ |
Hipparcos star catalog | 50 MB | JSON, Binary |
/catalogs/gaia/ |
Gaia DR3 subsets by region | 100-500 MB | Binary |
/catalogs/tycho/ |
Tycho-2 catalog | 200 MB | Binary |
/catalogs/messier/ |
Messier object data | 1 MB | JSON |
/catalogs/ngc/ |
NGC/IC catalog | 10 MB | JSON |
/data/constellations/ |
Constellation boundaries, lines | 5 MB | JSON |
Dynamic Data (1 Hour Cache)#
| Path | Content | Size Range | Format |
|---|---|---|---|
/data/tle/ |
Two-Line Element sets for satellites | 5 MB | TLE, JSON |
/data/events/ |
Upcoming astronomical events | 100 KB | JSON |
/data/ephemeris/ |
Pre-computed ephemeris data | 10 MB | Binary |
Directory Structure#
text
cdn.nyx.oshun.io/
├── textures/
│ ├── stars/
│ │ ├── sprites/ # Star sprite atlases
│ │ ├── backgrounds/ # Sky background tiles
│ │ └── milkyway/ # Milky Way textures
│ ├── planets/
│ │ ├── mercury/ # 2K-8K surface textures
│ │ ├── venus/
│ │ ├── earth/
│ │ ├── mars/
│ │ ├── jupiter/
│ │ ├── saturn/
│ │ ├── uranus/
│ │ ├── neptune/
│ │ └── moons/ # Major moon textures
│ ├── nebulae/
│ │ ├── emission/ # H-alpha, OIII images
│ │ ├── planetary/ # Planetary nebulae
│ │ └── reflection/ # Reflection nebulae
│ └── galaxies/
│ ├── spiral/
│ ├── elliptical/
│ └── irregular/
├── catalogs/
│ ├── hipparcos/
│ ├── gaia/
│ │ └── healpix/ # HEALPix partitioned data
│ ├── tycho/
│ ├── messier/
│ └── ngc/
├── data/
│ ├── constellations/
│ │ ├── boundaries.json
│ │ ├── lines.json
│ │ └── mythology/
│ ├── tle/
│ │ ├── stations.tle # Space stations
│ │ ├── visual.tle # Visible satellites
│ │ └── starlink.tle # Starlink constellation
│ ├── events/
│ │ ├── 2026.json
│ │ └── current.json
│ └── ephemeris/
│ └── planets/
└── audio/
├── tours/ # Narrated tour audio
└── ambient/ # Ambient space sounds
Cache Policies#
Immutable Assets (1 Year)#
- Star textures
- Planet textures
- Nebula images
- Galaxy images
- Constellation artwork
These assets are versioned via filename hash and never change once published. Browser and CDN caching is maximized.
text
Cache-Control: public, max-age=31536000, immutable
Catalog Data (7 Days)#
- Star catalogs
- DSO catalogs
- Constellation data
Updated infrequently, typically with new data releases (Gaia DR4, etc.).
text
Cache-Control: public, max-age=604800
Dynamic Data (1 Hour)#
- TLE data (updated hourly)
- Event data (updated daily)
- Pre-computed ephemeris
text
Cache-Control: public, max-age=3600, stale-while-revalidate=86400
Deployment#
Prerequisites#
- AWS account with CloudFront access
- ACM certificate for
cdn.nyx.oshun.io - Route53 hosted zone (or external DNS)
Apply Configuration#
bash
cd infra/nyx/cdn
# Initialize Terraform
terraform init
# Plan changes
terraform plan -var="environment=prod" -var="certificate_arn=arn:aws:acm:..."
# Apply
terraform apply -var="environment=prod" -var="certificate_arn=arn:aws:acm:..."
Upload Assets#
bash
# Sync textures (with immutable caching)
aws s3 sync ./textures s3://nyx-static-assets-prod/textures \
--cache-control "public, max-age=31536000, immutable"
# Sync catalogs (with medium caching)
aws s3 sync ./catalogs s3://nyx-static-assets-prod/catalogs \
--cache-control "public, max-age=604800"
# Sync dynamic data (with short caching)
aws s3 sync ./data s3://nyx-static-assets-prod/data \
--cache-control "public, max-age=3600"
Invalidate Cache#
bash
# Invalidate specific path
aws cloudfront create-invalidation \
--distribution-id DISTRIBUTION_ID \
--paths "/data/tle/*"
# Invalidate all (use sparingly)
aws cloudfront create-invalidation \
--distribution-id DISTRIBUTION_ID \
--paths "/*"
Performance Optimization#
Image Formats#
| Use Case | Format | Why |
|---|---|---|
| Star sprites | WebP | Excellent compression, alpha support |
| Planet textures | JPG (surface), PNG (clouds) | JPG for photos, PNG for transparency |
| Nebulae | JPG | Photo content compresses well |
| UI elements | SVG/WebP | Scalable or compressed |
Compression#
- Brotli compression enabled for text-based formats
- Gzip fallback for older browsers
- Pre-compressed assets where possible
Tile Sizes#
| Content Type | Tile Size | Reason |
|---|---|---|
| Star background | 512×512 | Balance load time and coverage |
| Planet textures | 1024×1024 | Detail without excessive memory |
| Nebula images | 2048×2048 | High detail for zoom |
Monitoring#
CloudWatch Metrics#
- Request count
- Cache hit ratio
- 4xx/5xx error rate
- Bandwidth consumption
- Origin latency
Alerts#
Configure alerts for:
- Cache hit ratio < 90%
- Error rate > 1%
- Origin latency > 500ms
Cost Estimation#
| Asset Type | Storage | Requests/Month | Estimated Cost |
|---|---|---|---|
| Textures | 50 GB | 10M | ~$15/month |
| Catalogs | 10 GB | 5M | ~$8/month |
| Dynamic data | 1 GB | 50M | ~$25/month |
| Total | 61 GB | 65M | ~$48/month |
Costs vary by region and actual usage.
Security#
- TLS 1.2+ required
- CORS configured for application origins
- No direct S3 access (CloudFront only)
- Security headers via CloudFront Function
- Rate limiting at edge