Apache Mesos

See the getting started page for more information about downloading, building, and deploying Mesos.

See our community page for more details.

Fundamentals

Configuration for command-line arguments.
High Availability Master Setup
- Replicated Log for information on the Mesos replicated log.
Fault Tolerant Agent Setup
Framework Rate Limiting
Maintenance for performing maintenance on a Mesos cluster.
Upgrades for upgrading a Mesos cluster.
Downgrades for downgrading a Mesos cluster.
Logging
Monitoring / Metrics
Debugging using the new CLI
Operational Guide
Fetcher Cache Configuration
Fault Domains
Performance Profiling for debugging performance issues in Mesos.
Memory Profiling for debugging potential memory leaks in Mesos.

Attributes and Resources for how to describe the agents that comprise a cluster.
Using Resource Roles
- Resource Role Weights for fair sharing.
- Resource Role Quota for how to configure Mesos to provide guaranteed resource allocations for use by a role.
- Reservations for how operators and frameworks can reserve resources on individual agents for use by a role.
- Shared Resources for how to share persistent volumes between tasks managed by different executors on the same agent.
Oversubscription for how to configure Mesos to take advantage of unused resources to launch “best-effort” tasks.

Multiple Disks for how to allow tasks to use multiple isolated disk resources.
Persistent Volume for how to allow tasks to access persistent storage resources.
Container Storage Interface (CSI) Support

Running Workloads in Mesos explains how a scheduler can specify and run tasks.
Framework Development Guide describes how to build applications on top of Mesos.
Guide for Designing Highly Available Mesos Frameworks
Reconciliation for ensuring a framework’s state remains eventually consistent in the face of failures.
Task State Reasons describes how task state reasons are used in Mesos.
Task Health Checking
v1 Scheduler HTTP API for communication between schedulers and the Mesos master.
v1 Executor HTTP API describes the new HTTP API for communication between executors and the Mesos agent.

HTTP Endpoints for available HTTP endpoints.
API Client Libraries lists client libraries for the HTTP APIs.
API Versioning describes HTTP API and release versioning.
RecordIO describes the RecordIO format used by the streaming endpoints of the HTTP API.
API References:
- v0 Java API
- v0 C++ API
- v1 Operator HTTP API for communication between operators and Mesos master/agent.
- v1 Scheduler HTTP API for communication between schedulers and the Mesos master.
- v1 Executor HTTP API describes the new HTTP API for communication between executors and the Mesos agent.
Mesos Modules for specifying Mesos modules for master, agent and tests.
- Allocation Module for how to write custom resource allocators.

Reporting an Issue, Improvement, or Feature for getting started with JIRA.
Beginner Guide for Contributors to get started contributing to Mesos for the first time.
Advanced Contribution Guide to learn the typical workflow used when contributing to Mesos.
Engineering Principles and Practices to serve as a shared set of project-level values for the community.
Style Guides:
- Documentation Style Guide
- Developer Guide for best practices and patterns used in Mesos.
- C++ Style Guide
  - Clang-Format for automatic formatting.
- Doxygen Style Guide
- Markdown Style Guide
Testing Patterns for tips and tricks used in Mesos tests.
C++ Doxygen Reference for internal APIs.
Committers and Maintainers a listing of project committers and component maintainers; useful when seeking feedback.
- Committing guidelines for committing changes.
- Release Guide
- Committer Candidate Guidelines for becoming a committer.
Effective Code Reviewing guidelines, tips, and learnings for how to do effective code reviews.
Reopening a Review for our policy around reviving reviews on ReviewBoard.