Using AtomGit Hosted Runners

This document introduces the three-part tag system for official hosted Runners of AtomGit, resource specifications details, and how to specify their use in workflows.

No need to build your own infrastructure. Directly use the official resource pool Runners provided by AtomGit to execute pipeline tasks, suitable for most build, test, and lightweight deployment scenarios.

Configuration Instructions

Official Hosted Runner Tag System

AtomGit Action's official resource pool Runners use a three-part tag format:

{os-version},{arch},{flavor}

Part	Meaning	Optional Values
os-version	Operating System	ubuntu-24, euler-25 Note: AtomGit Runner supports the following abbreviations default: [ubuntu-latest, x64, small] ubuntu-latest: [ubuntu-latest,x64,small] euler-latest: [euler-latest,x64,small]
arch	CPU Architecture	x64, arm64
flavor	Resource Specification	slim, small, medium, large, xlarge, 2xlarge

Resource Specification Details

Specification	CPU	Memory	Applicable Scenarios	Tag Example
slim	1 Core	4 GB	Lightweight checks (lint, syntax check)	[ubuntu-24, x64, slim]
small	2 Cores	8 GB	Daily builds, small project testing	[ubuntu-24, x64, small]
medium	4 Cores	16 GB	Medium project compilation, integration testing	[ubuntu-24, x64, medium]
large	8 Cores	32 GB	Large project builds, image packaging	[ubuntu-24, x64, large]
xlarge	16 Cores	64 GB	Heavy compilation, parallel test matrix	[ubuntu-24, x64, xlarge]
2xlarge	32 Cores	128 GB	Extremely heavy tasks, large-scale parallelism	[ubuntu-24, x64, 2xlarge]

Note: The default AtomGit hosted runners only provide resources for the slim, small, and medium specifications. If you require runners with large or higher specifications, please contact AtomGit customer service.

Specifying Runners in Workflows

# .gitcode/workflows/build.yml
stages:
  lint:
    name: Code Check
    jobs:
      name: code-check
      runs-on: [ubuntu-24, x64, slim]       # Use slim for lightweight tasks
      steps:
        - run: npm run lint
  build:
    name: Build
    jobs:
      name: compile
      runs-on: [ubuntu-24, x64, medium]     # Use medium for medium-sized compilation
      steps:
        - run: make build
  package:
    name: Package
    jobs:
      name: docker-build
      runs-on: [ubuntu-24, x64, large]      # Use large for image packaging
      steps:
        - run: docker build -t myapp .

Using the Default Tag

runs-on: default is a shortcut tag for AtomGit Action, equivalent to:

runs-on: [ubuntu-latest, x64, small]

That is, it uses the latest Ubuntu, x64 architecture, and small specification (2 cores, 8G).

jobs:
  simple-test:
    name: simple-test
    runs-on: default
    steps:
      - run: pytest

Multiple Tag Matching

runs-on can specify multiple tags, and the Runner must satisfy all tags to be selected:

jobs:
  arm64-build:
    name: arm64-build
    runs-on: [ubuntu-24, arm64, medium]
    steps:
      - run: make build ARCH=arm64

Pre-installed Tools on Hosted Runners

Tool Category	Pre-installed Content
Language Toolchain	Python 3.x, Node.js 18/20, Go 1.21+, Java 11/17/21
Build Tools	Make, CMake, Maven, Gradle, npm, pip
Version Control	Git, git-lfs

Note: The versions of pre-installed tools may change with Runner image updates. If a fixed version is required, it is recommended to explicitly install it in the step or use the container field to specify a custom image.