Metadata-Version: 2.1
Name: lcmap-app-deploy
Version: 0.2.0
Summary: Backup/restore Marathon app job definitions.
Home-page: https://eroslab.cr.usgs.gov/lcmap/deployment
Author: USGS EROS LCMAP
Author-email: 
License: Unlicense
Keywords: usgs eros lcmap
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: Public Domain
Classifier: Programming Language :: Python :: 3.6
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
Requires-Dist: requests
Provides-Extra: deploy
Requires-Dist: twine ; extra == 'deploy'
Provides-Extra: docs
Requires-Dist: sphinx ; extra == 'docs'
Requires-Dist: sphinx-autobuild ; extra == 'docs'
Requires-Dist: sphinx-rtd-theme ; extra == 'docs'
Provides-Extra: tests
Requires-Dist: pytest ; extra == 'tests'
Requires-Dist: pytest-cov ; extra == 'tests'

================
lcmap-app-deploy
================

Backup or deploy Marathon application job definitions.

What does it do?
----------------
* Gets job definitions from a Marathon endpoint and saves them to a json file.
* Loads job definitions from a json file and puts them to a Marathon endpoint.
* Project and job name filters can be used to limit which jobs are backed up/deployed.
* A test mode will show what would have been backed up/deployed.


Use
----

.. code:: bash

   # Show app's help/all arguments.
   app-deploy --help

   # Test a backup from a dev Marathon endpoint to a file.
   # Use job filters "/myproject" and then all for all jobs.
   app-deploy --backup --test --env dev --project myproject --job all --file mytest.json

   # Run a backup from a dev Marathon endpoint to a file.
   # Use job filters "/myproject" and then further filter jobs with "myjob" in the name.
   app-deploy --backup --env dev --project myproject --job myjob --file mytest.json

   # Test a deploy from a file to a dev Marathon endpoint.
   # Use job filters "/myproject and then all for all jobs.
   app-deploy --deploy --test --env dev --project myproject --job all --file mytest.json


Install and Run
---------------

.. code:: bash

   pip install lcmap-app-deploy

   export marathon_username=myuser
   export marathon_password=mypw
   export marathon_site_dev=https://hostdev:port/v2/apps
   export marathon_site_test=https://hosttest:port/v2/apps
   export marathon_site_prod=https://hostprod:port/v2/apps

   app-deploy --help


Versioning
----------
lcmap-app-deploy follows semantic versioning: http://semver.org/


