Docs / Apps (Docker & Git) / Use the Commit Picker for Targeted Deploys

Use the Commit Picker for Targeted Deploys

Published · Last updated: May 2026 · 2 min read

Who this is for

Users who want to deploy a specific version of their code — either a particular git commit or a prior Docker image tag — rather than the latest version.

When to Use the Commit Picker

Use the commit picker when:

  • You want to deploy a specific release tag (e.g., v1.2.3)
  • You need to roll back to a previous working commit after a bad deploy
  • You want to test a specific pull request commit before merging

For Git-Source Apps (source: git)

  1. Open the app detail.
  2. Click Deploy → Advanced Options.
  3. In the Git ref field, enter:
  • A commit SHA (e.g., a3f9d12)
  • A branch name (e.g., feature/my-fix)
  • A tag (e.g., v1.2.3)
  1. Click Deploy.

CloudAIPilot checks out the specified ref before building. This is recorded in the deployment history as a targeted deploy.

For Container Apps (source: docker)

For apps deployed from a Docker image (not from git), use the Image tag field to target a specific image version:

  1. Open the app detail.
  2. Click Deploy → Advanced Options.
  3. In the Image tag field, enter the tag you want to use (e.g., v1.1.2, stable).
  4. Click Deploy.

CloudAIPilot pulls the specified tag and redeploys the container. This is recorded as app.deploy.rollback in the audit log if it references a previous deployment.

Note: Rollback via imageTag is available only for container-kind apps. Compose apps do not support rollback by image tag via the commit picker.

Deploy History as Rollback Reference

The deployment history (see KB-04-11: Deployment History and Rollback) shows the commit SHA or image tag for every past deployment. Use this as a reference to identify which commit or tag you want to target.

What Success Looks Like

After the deploy, the app's commitSha or imageRef field updates to the targeted version. The Activity Center shows the deploy steps completed. The app is running the version you specified.

Related Articles