Conatinered Website

This guide walks you through deploying and managing containerized applications on PandaStack Platform.

Supported Runtimes

• Node.js

• Python

• Go

• Docker

Deployment Steps

1. Project Setup

1. Navigate to Projects dashboard

2. Click "Create New Project"

3. Select "Run as Container" as project type

4. Configure basic settings:

   • Project name (4-12 characters, lowercase, hyphens allowed)

   • Select repository branch

   • Choose runtime (Node.js, Python, Go, Docker)

   • Select deployment region (EU, US, ASIA)

2. Build Configuration

Node.js

# Build Command Example
npm run build

# Start Command Example
npm start

Python

# Build Command Example
pip install -r requirements.txt

# Start Command Example
gunicorn your_application.wsgi

Go

# Build Command Example
go build -o main ./cmd/app

# Start Command Example
./main

# Default Health Check Path
/health

Docker

• Docker build context directory (default: ./)

• Dockerfile path (default: ./Dockerfile)

• Registry credentials for private registries

• Health check path configuration

Resource Management

Resource Tiers

• Free Tier (Limited resources)

• Standard Tier (Production ready)

• Compute-Optimized (C1/C2)

• Memory-Optimized (M1/M2)

Auto-Scaling Configuration

{
    "enabled": true,
    "minReplicas": 1,
    "maxReplicas": 5,
    "targetCPU": 80,
    "targetMemory": 70
}

Storage Options

NVMe Disk sizes:

• No disk (default)

• 0.5 GB

• 1 GB

• 2 GB

• 3 GB

• 4 GB

• 5 GB

Note: NVMe disk not available in free tier

Environment Management

Environment Variables

1. Direct Input:

   • Key-value pairs

   • Secure storage

   • Runtime access

2. Bulk Import:

   • Import from .env file

   • Multiple variables

   • Automatic parsing

Secret Files

• Store sensitive configuration

• Environment files

• Private keys

• Access credentials

Project Management

Status Control

• Start/Pause project

• Monitor status

• View deployment history

• Resource usage tracking

Deployment Options

1. Manual Deployment:

   • Latest commit

   • Specific commit

   • Branch selection

2. Auto Deployment:

   • Deploy on push

   • Branch-based rules

   • PR preview (Coming soon)

Health Monitoring

• Custom health check paths

• Status monitoring

• Automatic recovery

• Performance metrics

Docker Integration

Registry Configuration

• Private registry support

• Credential management

• Secure image pulling

• Version control

Build Settings

1. Context Configuration:

   • Build context directory

   • Dockerfile location

   • Build arguments

2. Runtime Settings:

   • Container commands

   • Environment variables

   • Volume mounts

Best Practices

1. Resource Configuration

• Choose appropriate tier

• Configure auto-scaling

• Set proper memory limits

• Monitor resource usage

2. Security

• Use secret files

• Secure environment variables

• Configure health checks

• Implement proper authentication

3. Performance

• Enable auto-scaling

• Configure proper health checks

• Monitor metrics

• Optimize container builds

4. Deployment

• Use auto-deployment

• Test in staging

• Monitor build logs

• Version control

Troubleshooting

1. Build Issues

• Check build logs

• Verify dependencies

• Review Dockerfile

• Check resource limits

2. Runtime Issues

• Monitor health checks

• Review container logs

• Check resource usage

• Verify environment variables

3. Performance Issues

• Review auto-scaling

• Check resource allocation

• Monitor metrics

• Analyze logs

4. Deployment Issues

• Check build process

• Verify registry access

• Review configurations

• Check network settings