nsc base-image build-github-image
Test the build of a base image.
base-image build-github-image performs a test build of a Dockerfile intended
for use as a GitHub Actions runner base image. It's useful for validating that
a custom image configuration builds successfully before you upload it or wire
it up to a GitHub runner profile. This command is also invokable as
nsc github build-base-image — both forms run the exact same command, so
don't be confused if you see either one referenced elsewhere.
Usage
nsc base-image build-github-image [--file string] [--os-label string] [--platform strings]Example
$ nsc base-image build-github-image --file ./Dockerfile --os-label ubuntu-24.04 --platform linux/arm64Optional Flags
-f, --file string
Specifies what Dockerfile to build.
-l, --os-label string
Specifies the OS version of the base image. Default: ubuntu-22.04.
-p, --platform strings
Which platforms to build for (linux/amd64 or linux/arm64). Default:
linux/amd64,linux/arm64.
Related Topics
- nsc github profile test-build-base-image - Build the base image from a GitHub runner profile's Dockerfile
- nsc base-image upload - Convert an existing image into a base image and upload it to nscr.io
- nsc base-image optimize - Optimize a base image for fast worker boot