How to Deploy from a Container Image

Prerequisites

Follow the Quickstart instructions for creating a DigitalOcean Container Registry, and push your image to the registry.

Deploy Component using a Container Image as the Source

  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 Settings tab. Click the Add Component button and then click Web Service, Worker, or Job.
  2. Select DigitalOcean Container Registry as the source for your code, choose the image you would like to use from the Repository drop-down and select the tag of the image you would like to deploy.
  3. Configure any details such as HTTP routes, environment variables, the run command, or the HTTP port.
  4. On the next page, give your new component a name.
  5. Select the plan and 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.

Change the Tag of the Container Source After Deployment

You can change the tag of the container image to use as the source of an existing deployment:

  1. Visit the Apps page, click your app, and navigate to the Settings tab.
  2. Click the icon for the component that you created using a container from your registry.
  3. Under the Source heading, click the Edit link. Use the Tag drop-down to select the desired tag and re-deploy your app.
A container is a single running instance of a service, worker, or static site component shipped on App Platform.