Developing DC/OS Services

Developing your own DC/OS components

This section describes the developer-specific DC/OS components, explaining what is necessary to package and provide your own service on DC/OS.

The Mesosphere Distributed Cloud Operating System (DC/OS) provides the optimal user experience possible for orchestrating and managing a datacenter. If you are an Apache Mesos developer, you are already familiar with developing a framework. DC/OS extends Apache Mesos by including a web interface for health checks and monitoring, a command-line, a service packaging description, and a repository that catalogs those packages.

Package Repositories

The DC/OS Catalog contains all of the services that are installable on DC/OS. For more information on DC/OS Catalog, see the GitHub Catalog repository. Our general recommendation is to use the DC/OS CLI rather than the DC/OS web interface throughout the process of creating a package for the Catalog.

All packaged services are required to meet a certain standard as defined by Mesosphere. For details on submitting a DC/OS service, see Getting Started with Catalog.

DC/OS service structure

Each DC/OS service in the Catalog repo is comprised of JSON configuration files. These files are used create the packages that are installed on DC/OS.

FilenameDescriptionRequired
config.jsonSpecifies the supported configuration properties, represented as a JSON-schema.No
marathon.json.mustacheSpecifies a Mustache template that creates a Marathon app definition capable of running your service.No
package.jsonSpecifies the high level metadata about the package.Yes
resource.jsonSpecifies all of the required externally hosted resources (e.g. Docker images, HTTP objects and images).No

For more information, see Getting Started with Catalog.

CLI Specification

Using the command line interface