Blacksmith runners

Bellows is generic GitHub Actions tooling with first-class migration support for repositories using Blacksmith runner labels.

Goal

Existing workflows like this do not need to be rewritten:

yaml

1
2
3jobs:
  test:
    runs-on: blacksmith-4vcpu-ubuntu-2204

Bellows maps the runner label to a local Docker image:

yaml

1
2
3runner:
  map:
    blacksmith-4vcpu-ubuntu-2204: ghcr.io/smeltery/kiln:ubuntu-22.04

Default Mappings

Bellows recognizes common labels:

yaml

1
2
3
4
5
6
7
8
9
10
11
12runner:
  map:
    blacksmith-2vcpu-ubuntu-2204: ghcr.io/smeltery/kiln:ubuntu-22.04
    blacksmith-4vcpu-ubuntu-2204: ghcr.io/smeltery/kiln:ubuntu-22.04
    blacksmith-8vcpu-ubuntu-2204: ghcr.io/smeltery/kiln:ubuntu-22.04
    blacksmith-16vcpu-ubuntu-2204: ghcr.io/smeltery/kiln:ubuntu-22.04
    blacksmith-32vcpu-ubuntu-2204: ghcr.io/smeltery/kiln:ubuntu-22.04
    blacksmith-2vcpu-ubuntu-2404: ghcr.io/smeltery/kiln:ubuntu-24.04
    blacksmith-4vcpu-ubuntu-2404: ghcr.io/smeltery/kiln:ubuntu-24.04
    blacksmith-8vcpu-ubuntu-2404: ghcr.io/smeltery/kiln:ubuntu-24.04
    blacksmith-16vcpu-ubuntu-2404: ghcr.io/smeltery/kiln:ubuntu-24.04
    blacksmith-32vcpu-ubuntu-2404: ghcr.io/smeltery/kiln:ubuntu-24.04

If an image tag is unavailable, Bellows uses the closest stable act image and reports the substitution.

Doctor Output

bellows doctor detects Blacksmith labels and reports mappings:

text

1
2
3Found Blacksmith runner: blacksmith-4vcpu-ubuntu-2204
Local image: ghcr.io/smeltery/kiln:ubuntu-22.04
Status: mapped

For unknown labels:

text

1
2
3
4
5
6
7Found Blacksmith runner: blacksmith-gpu-ubuntu-2204
Status: unmapped
Add this to .bellows.yml:

runner:
  map:
    blacksmith-gpu-ubuntu-2204: <local-docker-image>