DC/OS is an open-source operating system and distributed system for data center built on Apache Mesos distributed system kernel. As a distributed system, it is a cluster of master nodes and private/public nodes, where each node also has host operating system which manages the underlying machine.
It enables the management of multiple machines as if they were a single computer. It automates resource management, schedules process placement, facilitates inter-process communication, and simplifies the installation and management of distributed services. Its included web interface and available command-line interface (CLI) facilitate remote management and monitoring of the cluster and its services.
- Distributed System : DC/OS is distributed system with group of private and public nodes which are coordinated by master nodes.
- Cluster Manager : DC/OS is responsible for running tasks on agent nodes and providing required resources to them. DC/OS uses Apache Mesos to provide cluster management functionality.
- Container Platform : All DC/OS tasks are containerized. DC/OS uses two different container runtimes, i.e. docker and mesos. So that containers can be started from docker images or they can be native executables (binaries or scripts) which are containerized at runtime by mesos.
- Operating System : As name specifies, DC/OS is an operating system which abstracts cluster h/w and s/w resources and provide common services to applications.
Unlike Linux, DC/OS is not a host operating system. DC/OS spans multiple machines, but relies on each machine to have its own host operating system and host kernel.
The high level architecture of DC/OS can be seen below :
For the detailed architecture and components of DC/OS, please click here.
Adoption and usage of Mesosphere DC/OS:
Mesosphere customers include :
- 30% of the Fortune 50 U.S. Companies
- 5 of the top 10 North American Banks
- 7 of the top 12 Worldwide Telcos
- 5 of the top 10 Highest Valued Startups
Some companies using DC/OS are :
- Tommy Hilfiger
Installing and using DC/OS
Using dcos cli, we can manager cluster nodes, manage marathon tasks and services, install/remove packages from universe and it provides great support for automation process as each cli command can be output to json.
NOTE: The tasks below are executed with and tested on below tools:
- DC/OS 1.11 Open Source
- DC/OS cli 0.6.0
DC/OS commands and scripts
Setup DC/OS cli with DC/OS cluster
The above command will give you the link for oauth authentication and prompt for auth token. You can authenticate yourself with any of Google, Github or Microsoft account. Paste the token generated after authentication to cli prompt. (Provided oauth is enabled).
DC/OS authentication token
DC/OS cluster url
DC/OS cluster name
Access Mesos UI
Access Marathon UI
Access any DC/OS service, like Marathon, Kafka, Elastic, Spark etc.[DC/OS Services]
Access DC/OS slaves info in json using Mesos API [Mesos Endpoints]
Access DC/OS slaves info in json using DC/OS cli
Note : DC/OS cli ‘dcos node --json’ is equivalent to running mesos slaves endpoint (/mesos/slaves)
Access DC/OS private slaves info using DC/OS cli
Access DC/OS public slaves info using DC/OS cli
Access DC/OS private and public slaves info using DC/OS cli
Get public IP of all public agents
Note: As ‘dcos node ssh’ requires private key to be added to ssh. Make sure you add your private key as ssh identity using :
Get public IP of master leader
Get all master nodes and their private ip
Get list of all users who have access to DC/OS cluster
Add users to cluster using Mesosphere script (Run this on master)
Users to add are given in list.txt, each user on new line
Add users to cluster using DC/OS API
Delete users from DC/OS cluster organization
Offers/resources from individual DC/OS agent
In recent versions of the many dcos services, a scheduler endpoint at
will display an HTML table containing a summary of recently-evaluated offers. This table’s contents are currently very similar to what can be found in logs, but in a slightly more accessible format. Alternately, we can look at the scheduler’s logs in stdout. An offer is a set of resources all from one individual DC/OS agent.
Save JSON configs of all running Marathon apps
Get report of Marathon apps with details like container type, Docker image, tag or service version used by Marathon app.
Get DC/OS nodes with more information like node type, node ip, attributes, number of running tasks, free memory, free cpu etc.
Uninstall framework and clean reserved resources if any after framework is deleted/uninstalled. (applicable if running DC/OS 1.9 or older, if higher than 1.10, then only uninstall cli is sufficient)
Get DC/OS apps and their placement constraints
Run shell command on all slaves
Run shell command on master leader
Run shell command on all master nodes
Add node attributes to dcos nodes and run apps on nodes with required attributes using placement constraints
Install DC/OS Datadog metrics plugin on all DC/OS nodes
Get app / node metrics fetched by dcos-metrics component using metrics API
- Get DC/OS node id [dcos node]
- Get Node metrics (CPU, memory, local filesystems, networks, etc) : <dc os_cluster_url="">/system/v1/agent/<agent_id>/metrics/v0/node</agent_id></dc>
- Get id of all containers running on that agent : <dc os_cluster_url="">/system/v1/agent/<agent_id>/metrics/v0/containers</agent_id></dc>
- Get Resource allocation and usage for the given container ID. : <dc os_cluster_url="">/system/v1/agent/<agent_id>/metrics/v0/containers/<container_id></container_id></agent_id></dc>
- Get Application-level metrics from the container (shipped in StatsD format using the listener available at STATSD_UDP_HOST and STATSD_UDP_PORT) : <dc os_cluster_url="">/system/v1/agent/<agent_id>/metrics/v0/containers/<container_id>/app </container_id></agent_id></dc>
Get app / node metrics fetched by dcos-metrics component using dcos cli
- Summary of container metrics for a specific task
- All metrics in details for a specific task
- Summary of Node metrics for a specific node
- All Node metrics in details for a specific node
NOTE - All above commands have ‘--json’ flag to use them programmatically.
Launch / run command inside container for a task
DC/OS task exec cli only supports Mesos containers, this script supports both Mesos and Docker containers.
Get DC/OS tasks by node
Get cluster metadata - cluster Public IP and cluster ID
Get DC/OS metadata - DC/OS version
Get Mesos version
Access DC/OS cluster exhibitor UI (Exhibitor supervises ZooKeeper and provides a management web interface)
Access DC/OS cluster data from cluster zookeeper using Zookeeper Python client - Run inside any node / container
Access dcos cluster data from cluster zookeeper using exhibitor rest API
Get cluster name using Mesos API
Mark Mesos node as decommissioned
Some times instances which are running as DC/OS node gets terminated and can not come back online, like AWS EC2 instances, once terminated due to any reason, can not start back. When Mesos detects that a node has stopped, it puts the node in the UNREACHABLE state because Mesos does not know if the node is temporarily stopped and will come back online, or if it is permanently stopped. In such case, we can explicitly tell Mesos to put a node in the GONE state if we know a node will not come back.
We learned about Mesosphere DC/OS, its functionality and roles. We also learned how to setup and use DC/OS cli and use http authentication to access DC/OS APIs as well as using DC/OS cli for automating tasks.
We went through different API endpoints like Mesos, Marathon, DC/OS metrics, exhibitor, DC/OS cluster organization etc. Finally, we looked at different tricks and scripts to automate DC/OS, like DC/OS node details, task exec, Docker report, DC/OS API http authentication etc.