Go Other
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
ci
cmd/marathon-resource
.codeclimate.yml
.gitignore
.mdlrc
.travis.yml
CONTRIBUTING.md
LICENSE
README.md
mdlstyle.rb
pre-commit-go.yml

README.md

Marathon Resource

Build Status Coverage Status Code Climate License Go Report Card Docker Pulls

A Concourse resource to deploy applications to Marathon.

Source Configuration

  • app_id: Required. The name of your app in Marathon.

  • uri: Required. The URI of the Marathon instance you wish to deploy to.

  • basic_auth: Optional. Use if you are using HTTP Basic Auth to protect your Marathon instance. Takes user_name and password

  • api_token: Optional. Use if you are using DC/OS and need to set an HTTP API token.

Behavior

check: Extract versions of an app from Marathon.

Returns a list of any versions greater than or equal the last know version of the app defined by app_id.

in: Fetch data about the current version of an app.

Returns JSON description of the current running version of the app.

Parameters

None.

out: Deploy an app to Marathon.

Given a JSON file specified by app_json, post it to Marathon to deploy the app. The resource will cancel the deployment if its not successful after time_out.

Parameters

  • app_json: Required. Path to the JSON file describing your marathon app. For more information about the format see the Marathon docs.

  • time_out: Required. How long, in seconds, to wait for Marathon to deploy the app. Timed out deployments will roll back and fail the job.

  • replacements: Optional. A name/value list of templated strings in the app.json to replace during the deploy. Useful for things such as passwords or urls that change.

  • replacement_files: Optional. Similar to replacements except value is a path to a file who's content will be used in the replace.

  • restart_if_no_update: Optional. If Marathon doesn't detect any change in your app.json it won't deploy a new version. Setting this to true will restart an existing app causing a new version. Default is false.

Example Configuration

Resource type

- name: marathon
  type: docker-image
  source:
    repository: ckaznocha/marathon-resource

Resource

- name: marathon_app
  type: marathon
  source:
    app_id: my_app
    uri: http://my-marathon.com/
    basic_auth:
      user_name: my_name
      password: {{ marathon_password }}

Plan

- get: marathon_app
- put: marathon_app
  params:
    app_json: path/to/app.json
    time_out: 10
    replacements:
    - name: db_password
      value: {{ db_password }}
    - name: db_url
      value: {{ db_url }}

Contributing

See the CONTRIBUTING file.

License

See LICENSE file