Container Configuration

Configure Docker containers for Generic artifacts in Bluebricks.

Native Configuration Fields

Field	Type	Required	Description
type	string	Yes	Must be "generic"
path	string	Yes	Path to your source files (e.g., "./src")
image	string	No	Docker image to use (default: busybox:stable)
command	array	No	Command to run in container (default: image's CMD)
args	array	No	Arguments to pass to command
env_vars	object	No	Environment variables for container

Image Configuration

Basic Image Usage

{
  "native": {
    "type": "generic",
    "image": "python:3.11-slim"
  }
}

Custom Command and Args

{
  "native": {
    "type": "generic",
    "image": "python:3.11-slim",
    "command": ["python"],
    "args": ["/workspace/scripts/migrate.py"]
  }
}

Environment Variables

{
  "native": {
    "type": "generic",
    "image": "node:18-alpine",
    "command": ["node"],
    "args": ["/workspace/app.js"],
    "env_vars": {
      "NODE_ENV": "production",
      "LOG_LEVEL": "info",
      "TIMEOUT": "30000"
    }
  }
}

Common Configurations

Python Scripts

{
  "native": {
    "type": "generic",
    "path": "./src",
    "image": "python:3.11-slim",
    "command": ["/bin/bash", "-c"],
    "args": [
      "pip install -r /workspace/requirements.txt && python /workspace/scripts/main.py"
    ],
    "env_vars": {
      "PYTHONUNBUFFERED": "1",
      "PYTHONPATH": "/workspace"
    }
  }
}

Node.js Applications

{
  "native": {
    "type": "generic",
    "path": "./src",
    "image": "node:18-alpine",
    "command": ["npm"],
    "args": ["run", "deploy"],
    "env_vars": {
      "NODE_ENV": "production"
    }
  }
}

Bash Scripts

{
  "native": {
    "type": "generic",
    "path": "./src",
    "image": "alpine:latest",
    "command": ["/bin/sh"],
    "args": ["/workspace/scripts/deploy.sh"],
    "env_vars": {
      "DEBUG": "false"
    }
  }
}

Multi-step Workflows

{
  "native": {
    "type": "generic",
    "path": "./src",
    "image": "python:3.11-slim",
    "command": ["/bin/bash", "-c"],
    "args": [
      "python /workspace/step1.py && python /workspace/step2.py && python /workspace/step3.py"
    ]
  }
}

Advanced Configuration

Custom Entrypoint

{
  "native": {
    "type": "generic",
    "image": "custom/myapp:1.0.0",
    "command": ["/app/entrypoint.sh"],
    "args": ["--config", "/workspace/config.json"]
  }
}

Resource Constraints

{
  "native": {
    "type": "generic",
    "image": "tensorflow/tensorflow:latest",
    "command": ["python"],
    "args": ["/workspace/train.py"],
    "env_vars": {
      "TF_CPP_MIN_LOG_LEVEL": "2",
      "OMP_NUM_THREADS": "4"
    }
  }
}

Multi-language Scripts

{
  "native": {
    "type": "generic",
    "image": "ubuntu:22.04",
    "command": ["/bin/bash", "-c"],
    "args": [
      "apt-get update && apt-get install -y python3 nodejs && python3 /workspace/setup.py && node /workspace/deploy.js"
    ]
  }
}

Best Practices

Image Selection

• Use specific tags: Never use latest in production

• Choose minimal images: Alpine-based images are smaller

• Consider security: Use official images from trusted sources

• Optimize size: Use multi-stage builds for complex dependencies

Command Configuration

• Be explicit: Always specify command and args for clarity

• Use absolute paths: Reference /workspace/ for mounted files

• Handle errors: Use set -e in bash scripts

• Provide fallbacks: Include error handling in commands

Environment Variables

• Use meaningful names: Choose descriptive variable names

• Set defaults: Provide sensible default values

• Document purpose: Explain what each variable does

• Avoid secrets: Use Bluebricks secrets for sensitive data

Path Configuration

• Use relative paths: Set path relative to package root

• Organize files: Keep scripts in logical directory structure

• Include dependencies: Put all required files in the path

• Document structure: Explain file organization

See also

• Input/Output Handling -- vars.json and outputs.json contract

• Generic Artifact Types -- common patterns and approved registries

• Generic Artifact Lifecycle -- stage-specific configuration