Making changes across repositories using Sourcegraph Batch Changes


I had used “Sourcegraph Campaigns” once that I migrated all of my personal repositories from Travis CI to GitHub Actions, which is now branded as Sourcegraph Batch Changes. If this is the first time you heard about it, it is, in my own words, a toolset to create and manage content changes across many, could be dozens if not thousands of repositories.

This time, I want to run tests in CI with Go 1.17 for all of Flamego’s repositories, in addition to Go 1.16 (because Go 1.17 wasn’t released at the time).

Setting up

I will not replicate what has been well-documented in the Batch Changes documentation, and simply putting links to the relevant sections here. To use Batch Changes, I need:

  1. A working Sourcegraph installation
  2. Install the Sourcegraph CLI

Writing the spec file

Most of typing is done through writing the spec file for the Batch Changes to produce changesets, the following is what I have:

# File: add-go-1.17-to-flamego-ci.batch.yaml

name: add-go-1.17-to-flamego-ci
description: This batch change adds Go 1.17 to CI for all Flamego repositories

# Find all Flamego repositories that contain the CI file I want to change.
  - repositoriesMatchingQuery: " file:go.yml go-version: [ 1.16.x ]"

# In each repository
  - run: "sed -i 's/go-version: \\[ 1.16.x \\]/go-version: \\[ 1.16.x, 1.17.x \\]/' .github/workflows/go.yml"
    container: alpine:3

# Describe the GitHub pull request I want for each repository.
  title: 'ci: add Go 1.17'
  body: Updates CI to include Go 1.17
  branch: batch-changes/add-go-1.17 # Push the commit to this branch.
    message: Add Go 1.17 to CI
  published: false

There is only one step in my case, which is replacing all go-version: [ 1.16.x ] with go-version: [ 1.16.x, 1.17.x ] in the .github/workflows/go.yml file, for every repository that matches the search query file:go.yml go-version: [ 1.16.x ].

Preview, apply and publish changes

To generate the changesets, I executed the following command:

$ src batch preview -f add-go-1.17-to-flamego-ci.batch.yaml

src batch preview

This command prints the URL that I can click to preview the changesets, neat!

src batch preview on web

I can click on each item and inspect the actual diff that will be applied:

src batch preview on web with diff

All looks good, so I go ahead and apply them:

apply src batch preview

Honestly, I don’t know what would happen exactly if I choose to publish a changeset, so I start with selecting one of them and make it be published:

publish changesets

It failed. 😂

publish changesets failed

OK… I removed the last line published: false from my spec file, and start over.

Which failed again 😇 because my GitHub Personal Access Token is missing the workflow scope, and it is required for changing files that affects GitHub Actions. Then I granted the workflow scope to the Personal Access Token on, things start to work!

GitHub pull request

Waiting all checks to pass:

GitHub pull request checks passed

Flood someone else’s inbox

Now I have confidence in Batch Changes, let’s publish all the changesets and see what happens.

Here is the side-by-side comparison between Batch Changes UI and the

side-by-side pull request comparison

Here is how it looks like in Batch Changes UI if the CI failed for the pull request:

pull request check failed

I am making progress!

some pull requests merged

Batch Changes changesets are no magic but regular pull requests, so I can make direct pushes to the pull request for fixing little things:

push fixes to the pull request

All done and it’s time to close the Batch Changes.

closed batch changes

Last words

There is no last words.

comments powered by Disqus