Now that you have connected your first node and uploaded your first job, you can now queue that job to run on your Runly infrastructure.

Jobs in uploaded packages can be run by queuing a JSON config from the environment page or API. Each job defines its own config in code, which is serialized as JSON and used to queue the job to run in an environment. A job’s default config (the config in code serialized with its default values) is available from the run page.

Load the Config Editor

Try the following steps to queue a Runly.GettingStarted.Census.PlaceImporter:

  1. Choose the environment to run the job in using the environment list on your dashboard.

  2. In the Active Runs box, click the New Run button.

    new run

  3. In the Job text box, select PlaceImporter from the drop down menu. This automatically chooses the latest version of the package and loads the default config.

Explore the Config

The default config for the PlaceImporter is loaded into the editor and looks something like this:

{
  "baseUrl": "http://www2.census.gov/geo/docs/reference/codes/files/",
  "job": {
    "package": "Runly.GettingStarted",
    "version": "1.0.0",
    "type": "Runly.GettingStarted.Census.PlaceImporter"
  },
  "execution": {
    "parallelTaskCount": 1,
    "exceptionRetryCount": 0,
    "unsuccessfulRetryCount": 0,
    "itemFailureCountToStopJob": 1,
    "handleExceptions": true,
    "outputToFile": false,
    "outputFilePath": "",
    "outputToConsole": false,
    "launchDebugger": false
  }
}

This is the full default config for the job and is expanded to allow you to discover the available options. The minimum config that can be used to queue this job is as follows:

{
  "baseUrl": "http://www2.census.gov/geo/docs/reference/codes/files/",
  "job": "Runly.GettingStarted.Census.PlaceImporter"
}

The only required element is the job key. This specific job also requires a baseUrl to download data from the US Census. The job would be queued with the default execution settings. Runly will find the correct package & version of the job to run based on the environment’s package version settings (by default it will run the latest stable version).

Queue the Job

Increase the execution.parallelTaskCount to 50:

{
  "baseUrl": "http://www2.census.gov/geo/docs/reference/codes/files/",
  "job": "Runly.GettingStarted.Census.PlaceImporter",
  "execution": {
    "parallelTaskCount": 50
  }
}

and queue the job by clicking the Queue Job button to add the run to the environment’s queue.

Congratulations, your first run is queued! You can watch the progress of the run from the environment page’s Active Runs section and view detailed results from the History tab once the run has completed.

Where to Go Next

We recommend you learn how to develop your own jobs using Runly.