MCPcopy Index your code
hub / github.com/Yelp/paasta

github.com/Yelp/paasta @v1.55.2

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.55.2 ↗ · + Follow
5,530 symbols 19,867 edges 385 files 1,094 documented · 20%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Build Status Documentation Status

PaaSTA - Build, Deploy, Connect, and Monitor Services

PaaSTA Logo

PaaSTA is a highly-available, distributed system for building, deploying, and running services using containers and Kubernetes.

PaaSTA has been running production services at Yelp since 2016. It was originally designed to run on top of Apache Mesos but has subsequently been updated to use Kubernetes. Over time the features and functionality that PaaSTA provides have increased but the principal design remains the same.

PaaSTA aims to take a declarative description of the services that teams need to run and then ensures that those services are deployed safely, efficiently, and in a manner that is easy for the teams to maintain. Rather than managing Kubernetes YAML files, PaaSTA provides a simplified schema to describe your service and in addition to configuring Kubernetes it can also configure other infrastructure tools to provide monitoring, logging, cost management etc.

Want to know more about the opinions behind what makes PaaSTA special? Check out the PaaSTA Principles.

Components

Note: PaaSTA is an opinionated platform that uses a few un-opinionated tools. It requires a non-trivial amount of infrastructure to be in place before it works completely:

  • Docker for code delivery and containment
  • Kubernetes for code execution and scheduling (runs Docker containers)
  • Tron for running things on a timer (nightly batches)
  • SmartStack and Envoy for service registration and discovery
  • Sensu for monitoring/alerting
  • Jenkins (optionally) for continuous deployment
  • Prometheus and HPA for autoscaling services

One advantage to having a PaaS composed of components like these is you get to reuse them for other purposes. For example, at Yelp Sensu is not just for PaaSTA, it can be used to monitor all sorts of things. We also use Kubernetes to run other more complex workloads like Jolt and Cassandra. Our service mesh, which is a heavily customised version of SmartStack and Envoy, allows many systems at Yelp to communicate with PaaSTA services and each other.

On the other hand, requiring lots of components, means lots of infrastructure to setup before PaaSTA can work effectively! Realistically, running PaaSTA outside of Yelp would not be sensible, because in addition to the integrations mentioned above we also have strong opinions encoded in other tooling that you would need to replicate. Nevertheless, we code PaaSTA in the open because we think it is useful to share our approach and hope that the code can at least help others understand or solve similar problems.

Integrations and Features

In addition to the direct integrations above PaaSTA also relies on other components to provide PaaSTA users with other features and to manage compute capacity at Yelp.

  • We use Karpenter to autoscale pools of EC2 instances to run PaaSTA. Formerly we used our own autoscaler Clusterman
  • We bake AMIs using Packer
  • We collect logs from services and send them via Monk to Kafka
  • We use StatefulSets to run a few stateful PaaSTA services
  • We autotune the resources needed by each service by monitoring usage (similar to VPA)

Design Goals

  • Declarative, rather than imperative, control
  • Fault tolerance
  • Service isolation
  • Efficient use of resources
  • No single points of failure
  • Pleasant interface

Getting Started

See the getting started documentation for how to deploy PaaSTA. This reference is intended to help understand how PaaSTA works but we don't advise that you use PaaSTA in production.

Debugging PaaSTA (in VS Code)

To debug PaaSTA in VS Code, please refer to the internal PaaSTA wiki page "Debugging PaaSTA (in VS Code)".

Documentation

Read the documentation at Read the Docs.

Yelp-internal Documentation/Links

Videos / Talks About PaaSTA

License

PaaSTA is licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0

Contributing

Everyone is encouraged to contribute to PaaSTA by forking the Github repository and making a pull request or opening an issue.

Core symbols most depended-on inside this repo

get
called by 955
paasta_tools/mesos/framework.py
get
called by 240
paasta_tools/paastaapi/model_utils.py
red
called by 165
paasta_tools/utils.py
debug
called by 131
paasta_tools/paastaapi/configuration.py
load_system_paasta_config
called by 106
paasta_tools/utils.py
update
called by 82
paasta_tools/kubernetes/application/controller_wrappers.py
paasta_prefixed
called by 61
paasta_tools/kubernetes_tools.py
error
called by 53
paasta_tools/cli/cli.py

Shape

Function 2,841
Method 1,775
Route 493
Class 421

Languages

Python100%

Modules by API surface

paasta_tools/utils.py424 symbols
paasta_tools/kubernetes_tools.py241 symbols
tests/test_kubernetes_tools.py206 symbols
tests/test_utils.py205 symbols
tests/cli/test_cmds_status.py153 symbols
tests/cli/test_cmds_validate.py120 symbols
tests/cli/test_cmds_local_run.py114 symbols
paasta_tools/tron_tools.py103 symbols
tests/test_tron_tools.py101 symbols
paasta_tools/cli/cmds/mark_for_deployment.py87 symbols
tests/test_flink_tools.py72 symbols
paasta_tools/metrics/metastatus_lib.py70 symbols

For agents

$ claude mcp add paasta \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page