Run App Remotely

Run an app remotely

An introduction to running an app remotely with Nextmv Platform.

A run is a single execution of an app against an instance. It is the basic functionality encompassed of receiving an input, running the app, and returning an output. This tutorial will walk you through running an app remotely on Nextmv Cloud. It works the same for both subscription apps and custom apps.

There are several interfaces for running an app:

The Nextmv CLI and Python SDK handle the complete run workflow: large payloads, polling, retries, status checking, timeouts, exponential backoff, and more for you.

The basic steps for running an app are:

  1. Submit a run request with the input (payload) and options (if desired). A run_id is returned.
  2. Sleep for an appropriate amount of time.
  3. Poll for the run status in the metadata using the run_id.
    • If the status is succeeded, you can retrieve the run results.
    • If the status is failed, you can retrieve the run error.
    • If the status is running, you can continue polling.
  4. Retrieve the run results or error using the run_id.

There is a size limit of 5MB for the input and output of a run. Read the section on large payloads for more information.

When a new run is submitted, you can attach it to an existing batch experiment using the batch_experiment_id field. This will ignore existing online experiments attached to the instance (shadow and switchback tests).

You can work with non-json input/output when executing remote runs to your app.

Page last updated