paasta_tools: PaaSTA Sauce

paasta_tools is a Python library. It is the sauce that combines the individual strands of PaaSTA – Jenkins, Docker, Mesos, etc. – into a cohesive, highly-available, distributed meal.

Directions (For PaaSTA Users)

• Preparation: paasta_tools and yelpsoa-configs
  • Common Settings
  • Placement Options
    • General
    • Kubernetes
  • kubernetes-[clustername].yaml
  • tron-[clustername].yaml
    • Example Job
    • PaaSTA-Specific Options
  • adhoc-[clustername].yaml
  • smartstack.yaml
    • Error Alerting
  • monitoring.yaml
    • Monitoring Examples
  • service.yaml
  • Where does paasta_tools look for yelpsoa-configs?
• Cooking: How it all comes together
  • Ways That PaaSTA Can Run Services
    • Long Running Services
    • Scheduled Jobs
    • Adhoc Tasks
  • Service configuration
  • Contract with services
  • Deployment
  • How PaaSTA Runs Docker Containers
    • Time Zones In Docker Containers
  • Bouncing
  • Draining
  • Monitoring
  • The PaaSTA command line
• Autoscaling PaaSTA Instances
  • How to use autoscaling
    • Enabling autoscaling
    • Autoscaling components
    • Using multiple metrics providers
    • How to create a custom (bespoke) autoscaling method
    • max_instances alerting
• Deploy Groups
  • What are deploy groups?
    • Deploy groups in kubernetes/tron yamls and deploy.yaml should match
    • Deploy group names are (mostly) just arbitrary strings
    • Canary instances
    • String interpolation
    • Parallel steps
• Persistent Volumes
  • What are Persistent Volumes?
  • Caveats
  • How do I use Persistent Volumes in PaaSTA?

About PaaSTA’s Architecture

• The PaaSTA Contract
• Glossary
• PaaSTA Principles
• SmartStack Service Discovery and PaaSTA Integration
• Resource Isolation in PaaSTA, Kubernetes and Docker

PaaSTA Development

• Contributing
  • Running The Tests
  • Making new versions
  • Testing command-line tab completion
• Development Style Guide
  • General Guidelines
  • Interactive Command Line Tools
  • General Python

Installing The PaaSTA Infrastructure

• Getting Started
• soa-configs
• System Paasta Configs

Generated Docs

• paasta_tools

Indices and tables

• Index
• Module Index
• Search Page