Deploying a code change to DotCom

Developers should rarely need to perform these steps since we have tooling to ensure that code change merged to release are automatically deployed

To learn more about the continuous delivery process for DotCom, visit the deployments documentation.


In order to deploy a code change to DotCom, an image needs to exist that has the code change. CI builds images that are merged to main and pass all tests.

In extreme circumstances, you can follow the steps here to build an image that bypasses tests.

Manually deploying an image to DotCom

In case an image needs to be deployed faster than the daily release cycle allows, follow these steps:

  1. Find the image by either going to the buildkite CI logs on Sourcegraph or searching Dockerhub for the correct tag.

  2. The Sourcegraph tag format is [build_number]_[date]_[short git SHA1]

  3. Create a branch off the release branch of the DotCom repo

  4. Make the relevant image changes in the YAML files

    • Typically, the image will need to be updated in a Deployment or StatefulSet file
  5. Create a pull request

  6. Request a review from the devinfra GitHub team (preferable) or another member of the engineering department.

    • Note: 1 approval is required before merging
  7. Merge the pull request

  8. Once built and deployed verify change was successful