{"id":18600740,"url":"https://github.com/meltwater/puppet-marathon","last_synced_at":"2025-04-10T18:31:31.081Z","repository":{"id":18479119,"uuid":"21674399","full_name":"meltwater/puppet-marathon","owner":"meltwater","description":"Puppet Module for Mesos Marathon","archived":false,"fork":false,"pushed_at":"2020-01-04T09:02:34.000Z","size":59,"stargazers_count":6,"open_issues_count":4,"forks_count":19,"subscribers_count":153,"default_branch":"master","last_synced_at":"2025-03-25T03:01:35.409Z","etag":null,"topics":["marathon","puppet"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/meltwater.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-07-10T01:17:35.000Z","updated_at":"2020-02-18T07:52:30.000Z","dependencies_parsed_at":"2022-09-11T20:30:39.790Z","dependency_job_id":null,"html_url":"https://github.com/meltwater/puppet-marathon","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meltwater%2Fpuppet-marathon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meltwater%2Fpuppet-marathon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meltwater%2Fpuppet-marathon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meltwater%2Fpuppet-marathon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/meltwater","download_url":"https://codeload.github.com/meltwater/puppet-marathon/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248271762,"owners_count":21075800,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["marathon","puppet"],"created_at":"2024-11-07T02:05:13.345Z","updated_at":"2025-04-10T18:31:30.701Z","avatar_url":"https://github.com/meltwater.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# marathon\n[![Puppet Forge Version](http://img.shields.io/puppetforge/v/meltwater/marathon.svg)](https://forge.puppetlabs.com/meltwater/marathon)\n[![Puppet Forge Downloads](http://img.shields.io/puppetforge/dt/meltwater/marathon.svg)](https://forge.puppetlabs.com/meltwater/marathon)\n[![Travis branch](https://img.shields.io/travis/meltwater/puppet-marathon/master.svg)](https://travis-ci.org/meltwater/puppet-marathon)\n[![By Meltwater](https://img.shields.io/badge/by-meltwater-28bbbb.svg)](http://underthehood.meltwater.com/)\n[![Maintenance](https://img.shields.io/maintenance/yes/2016.svg)](https://github.com/meltwater/puppet-marathon/commits/master)\n[![license](https://img.shields.io/github/license/meltwater/puppet-marathon.svg)](https://github.com/meltwater/puppet-marathon/blob/master/LICENSE)\n\n#### Table of Contents\n\n1. [Overview](#overview)\n2. [Module Description - What the module does and why it is useful](#module-description)\n3. [Setup - The basics of getting started with marathon](#setup)\n    * [What marathon affects](#what-marathon-affects)\n    * [Beginning with marathon](#beginning-with-marathon)\n4. [Usage - Configuration options and additional functionality](#usage)\n5. [Reference - An under-the-hood peek at what the module is doing and how](#reference)\n5. [Limitations - OS compatibility, etc.](#limitations)\n   * [RedHat module dependencies](#redhat-module-dependecies)\n\n## Overview\n\nProvides a class to install the [Marathon](https://mesosphere.github.io/marathon/) framework for [Mesos](http://mesos.apache.org/).\n\n## Module Description\nThe marathon module sets up marathon on a mesos cluster.\n\nThis module has been tested against Marathon 0.13.0 and Mesos 0.26.0 and is known to not support\nall features against earlier versions.\n\n## Setup\n\n### What marathon affects\n\n* marathon repository files.\n* marathon package.\n* marathon configuration file.\n* marathon service.\n\n### Beginning with marathon\n\n\n```puppet\ninclude '::marathon'\n```\n\n## Usage\n\nAll options and configuration can be done through interacting with the parameters\non the main marathon class.  These are documented below.\n\n## marathon class\n\nTo begin with the marathon class controls the installation of marathon.  In here\nyou can control many parameters relating to the package and service, such as\ndisabling puppet support of the service:\n\n```puppet\nclass { '::marathon':\n  package_ensure  =\u003e 'present',\n  version         =\u003e '0.15.2',\n  manage_repo     =\u003e true,\n  install_java    =\u003e false,\n  init_style      =\u003e 'systemd',\n  bin_path        =\u003e '/usr/bin',\n  extra_options   =\u003e '--event_subscriber http_callback',\n  master          =\u003e ['localhost'], # or ['localhost:2181']\n  master_url_type =\u003e 'zookeeper', # default\n  master_zk_path  =\u003e 'mesos', # default\n  zk              =\u003e ['localhost'],\n  zk_path         =\u003e 'marathon', # default\n  zk_default_port =\u003e '2181', # default\n  manage_user     =\u003e true,\n  user            =\u003e 'marathon',\n  group           =\u003e 'marathon',\n}\n\n```\n\nOr automatically installing java as part of the marathon setup:\n\n```puppet\nclass { '::marathon':\n  ...\n  install_java =\u003e true,\n  java_version =\u003e 'java-1.7.0-openjdk',\n}\n```\n\n## Reference\n\n## Classes\n\n* marathon: Main class for installation and service management.\n* marathon::install: Handles package installation.\n* marathon::params: Different configuration data for different systems.\n* marathon::service: Handles the marathon service.\n* marathon::repo: Handles apt repo for Redhat/Debian systems.\n\n### Parameters\n\n#### `package`\n\nString, the name of the package to install.\n\n#### `package_ensure`\n\nDetermines the ensure state of the package.  Set to present by default, but could\nbe changed to latest.\n\n#### `version`\n\nDetermines the version of the package.  Set to undef by default, but could\nbe changed to 0.15.2, etc...\n\n#### `manage_repo`\n\nBoolean, whether or not to manage package repositories for mesosphere.\n\n#### `install_java`\n\nBoolean, if enabled install the java JDK\n\n#### `java_version`\n\nString, the java version to install.\n\n#### `init_style`\n\nString, the style of init system your system uses.\n\n#### `bin_path`\n\nString, the path of the marathon executable.\n\n#### `service_enable`\n\nBoolean, if enabled enables the marathon service.\n\n#### `service_ensure`\n\nThe state of the service..\n\n#### `extra_options`\n\nString, the extra options on the marathon command\n\n#### `master`\n\nArray, An array of Mesos master URLs.\nIf using zookeeper, the format is ``['host1', 'host2']`` or\n``['host1:2181', 'host2:2181']``. That will internally\nbe converted to a zk url like ``zk://host1:port,host2:port/mesos`` by using\n``master_zk_path``(default: mesos) and ``zk_default_port``(default: 2181)\nIf not using ZooKeeper, a format like ``['http://host1', 'http://host2']``\nis also acceptable with ``master_url_type`` set to \"http\"\n\n#### `zk`\n\nArray, The ZooKeeper Hosts for storing state.\nAn array of ZooKeeper IPs.\nThe format is ``['host1', 'host2']`` or\n``['host1:2181', 'host2:2181']``. That will internally be converted\nto a zk url like ``zk://host1:port,host2:port/marathon`` by using\n``zk_path``(default: marathon) and ``zk_default_port``(default: 2181)\n\n#### `master_url_type`\n\nString, the type of the master endpoints, 'zookeeper' or 'http'\n\n#### `master_zk_path`\n\nString, the trailing path to use for the ``master`` endpoints.\n\n#### `zk_path`\n\nString, the trailing path to use for the ``zk`` endpoints.\n\n#### `zk_default_port`\n\nString, the default port to use for zookeeper urls.\n\n#### `manage_user`\n\nBoolean, if enabled sets up the user that the marathon process will run as .\n\n#### `user`\n\nString, the user name to use if ``manage_user = true``.\n\n#### `group`\n\nString, the user group to use if ``manage_user = true``.\n\n\n## Limitations\n\nThis module has been built on and tested against Puppet 3.x and Puppet 4.x\n\nThe module has been tested on:\n\n* RedHat Enterprise Linux 6/7\n* Debian 6/7\n* CentOS 6/7\n* Ubuntu 12.04/14.04\n\nTesting on other platforms has been light and cannot be guaranteed.\n\n### Module dependencies\n\nIf running CentOS/RHEL, and using the yum provider, ensure the ``epel`` repo is present.\n\nIf you want to run Marathon, you'll likely want to look at this module too ``https://forge.puppetlabs.com/deric/mesos``\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeltwater%2Fpuppet-marathon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmeltwater%2Fpuppet-marathon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeltwater%2Fpuppet-marathon/lists"}