How to Manage Workers in App Platform

Background workers can consist of any application code you like. As far as App Platform is concerned, they are the same as services, except they are not “routable,” i.e. they are not accessible via an external URL.

Create Workers

  1. Visit the Apps page and either click Create App if starting from scratch, or click an existing app to add your container image to your solution.
    • If adding an image to an existing solution, click the Components tab, then click Service, Worker, or Job.
  2. Select Container as the source for your code, and choose the image you would like to use from the Repository drop-down.
  3. On the next page, give your new component a name, and select the tag of the image you would like to deploy.
  4. Configure any details such as HTTP routes, environment variables, the run command, or the HTTP port.
  5. Select the instance size you would like to use when a container is created from the image.

When updating the source image tag, a new deployment will be triggered. If the actual tag name has not changed, it is not guaranteed to pull down a fresh copy of the image due to caching. The recommended approach is to use unique tag names for all image updates.

Edit Workers

Go to, click on your app, and click on the Components tab. Click the Worker you’d like to edit.

You can use the configuration settings you see here to change the Worker’s scaling behavior, modify environment variables, edit commands, and more.

Destroy Workers

Go to, click on your app, and click on the Components tab. Click on the Worker you’d like to destroy.

You can destroy the Worker by clicking the Destroy Component button on the bottom of the page and entering its name to confirm your selection.

The build and run commands are the command-line statements that compile your app component at build time and launch your app component after it has been built, respectively.
A component in App Platform is any deployable, billable, run-time software element in your app. A component can be a database, a service, a worker, or a static site.
A container is a single running instance of a service, worker, or static site component shipped on App Platform.
In App Platform, a worker is a type of component that is not internet accessible but runs server-side code written in a supported programming language, such as Python, Ruby, Go, Node.js, or PHP.