Creating a Simple Job

This JSON file creates a simple job with no schedule.

Create a JSON file with the following contents.

{
  "id": "my-job",
  "description": "A job that sleeps",
  "run": {
    "cmd": "sleep 1000",
    "cpus": 0.01,
    "mem": 32,
    "disk": 0
  }
}

Add the job from the DC/OS CLI.

dcos job add <my-job>.json

Alternatively, add the job using the API.

curl -X POST -H "Content-Type: application/json" -H "Authorization: token=$(dcos config show core.dcos_acs_token)" $(dcos config show core.dcos_url)/service/metronome/v1/jobs -d@/Users/<your-username>/<myjob>.json

Creating a Job with a Schedule

NOTE: This example JSON only works when you add the job from the DC/OS CLI or the UI.

Create a JSON file with the following contents.

{
    "id": "my-scheduled-job",
    "description": "A job that sleeps on a schedule",
    "run": {
        "cmd": "sleep 20000",
        "cpus": 0.01,
        "mem": 32,
        "disk": 0
    },
    "schedules": [
        {
            "id": "sleep-nightly",
            "enabled": true,
            "cron": "20 0 * * *",
            "concurrencyPolicy": "ALLOW"
        }
    ]
}

Add the job.
```
dcos job add <my-scheduled-job>.json
```

Creating a Job and Associating a Schedule using the API

Add a job without a schedule using the instructions above.

Create a JSON file with the following contents. This is the schedule for your job.

{
    "concurrencyPolicy": "ALLOW",
    "cron": "20 0 * * *",
    "enabled": true,
    "id": "nightly",
    "nextRunAt": "2016-07-26T00:20:00.000+0000",
    "startingDeadlineSeconds": 900,
    "timezone": "UTC"
}

Add the schedule and associate it with the job.

Via the DC/OS CLI:

dcos job schedule add <job-id> <schedule-file>.json

Via the API:

curl -X POST -H "Content-Type: application/json" -H "Authorization: token=$(dcos config show core.dcos_acs_token)" $(dcos config show core.dcos_url)/service/metronome/v1/jobs/<job-id>/schedules -d@/Users/<your-username>/<schedule-file>.json

You can associate a schedule with more than one job.

Creating a Partitioned Jobs Environment

In this example, a partitioned jobs environment is created with the DC/OS UI. This allows you to restrict user access per job, or per job group. The jobs are created in a jobs group named batch, which is a child of a jobs group named dev.

├── dev
    ├── batch
        ├── job1
        ├── job2

The jobs groups are then assigned permissions to users Cory and Alice to restrict access.

Prerequisites:

You must be logged in as a superuser.

Log into the DC/OS UI as a user with the superuser permission.

DC/OS Enterprise login
Create the partitioned jobs.
1. Select Jobs and click CREATE A JOB.
2. In the ID field, type dev.batch.job1.
3. In the Command field, type sleep 1000 (or another valid shell command) and click CREATE A JOB.
  
  New job screen
  
  This creates a job in this directory structure in DC/OS: Jobs > dev > batch > job1.
4. Click the + icon in the top right corner to create another job.
  
  Create another job
5. In the ID field, type dev.batch.job2.
6. In the Command field, type sleep 1000 (or another valid shell command) and click CREATE A JOB. You should have two jobs:
  
  Jobs > dev > batch screen
Run the jobs.
1. Click Jobs > dev > batch > job1 and click Run Now.
  
  Run now menu
2. Click Jobs > dev > batch > job2 and click Run Now.
Assign permissions to the jobs.
1. Select Organization > Users and create new users named Cory and Alice.
  
  Create a new user
2. Select the user Cory and grant access to job1.
3. From the Permissions tab, click ADD PERMISSION and toggle the INSERT PERMISSION STRING button to manually enter the permissions.
  
  Add permissions for user ‘Cory’
4. Copy and paste the permissions in the Permissions Strings field. Specify your job group (dev/batch), job name (job1), and action (read). Actions can be either create, read, update, delete, or full. To permit more than one operation, use a comma to separate them, for example: dcos:service:metronome:metronome:jobs:/dev.batch.job1 read,update.
```
dcos:adminrouter:service:metronome full
dcos:service:metronome:metronome:jobs:dev.batch.job1 read
dcos:adminrouter:ops:mesos full
dcos:adminrouter:ops:slave full
dcos:mesos:master:framework:role:* read
dcos:mesos:master:executor:app_id:/dev/batch/job1 read
dcos:mesos:master:task:app_id:/dev/batch/job1 read
dcos:mesos:agent:framework:role:* read
dcos:mesos:agent:executor:app_id:/dev/batch/job1 read
dcos:mesos:agent:task:app_id:/dev/batch/job1 read
dcos:mesos:agent:sandbox:app_id:/dev/batch/job1 read
```
5. Click ADD PERMISSIONS and then Close.
6. Repeat these steps for user Alice, replacing job1 with job2 in the permissions.
Log out and log back in as your new user to verify the permissions. The user should now have the designated level of access to dev/batch/job1 and dev/batch/job2 inside the Jobs tab. For example, if you log in as Alice, you should only see jobs2:

Restricted view for ‘Alice’

Creating a job which joins a container network

Note: The following procedure requires DC/OS release version 2.0.4 or higher.

To have a job join a network, specify the “networks” field. The following job joins the dcos network, outputs its IP information, then sleeps:

```json
{
  "id": "networking-job",
  "description": "A job that outputs network info and sleeps",
  "run": {
    "cmd": "ip a; sleep 60",
    "docker": {
      "image": "alpine"
    },
    "networks": [{"mode": "container", "name": "dcos"}],
    "cpus": 0.01,
    "mem": 32,
    "disk": 0
  }
}
```

The field networks works identical to the networks field in Marathon.

Job Examples

Examples of common usage scenarios for jobs.

Creating a Simple Job

Creating a Job with a Schedule

Creating a Job and Associating a Schedule using the API

Creating a Partitioned Jobs Environment

Creating a job which joins a container network