Using AtomGit Hosted Runners

Applicable scenarios: No need to build your own infrastructure, directly use the official resource pool Runner provided by AtomGit to execute pipeline tasks, suitable for most building, testing, and lightweight deployment scenarios.

Configuration Guide

Official Hosted Runner Tag System

AtomGit Action's official resource pool Runner uses a three-part tag format:

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

Segment	Meaning	Optional Values
os-version	Operating System	ubuntu-latest, ubuntu-24, ubuntu-22
arch	CPU Architecture	x64, arm64
flavor	Resource Specification	slim, small, medium, large, xlarge, 2xlarge

Resource Specification Details

Specification	CPU	Memory	Applicable Scenario	Tag Example
slim	1 Core	4 GB	Lightweight checks (lint, syntax validation)	{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 Runner only provides resources of slim, small, and medium specifications. If you need a Runner with Large or higher specifications, please contact AtomGit customer service.

Specify Runner in Workflow

# Use Hosted Runner
stages:
  - name: lint
    jobs:
      - name: code-check
        runs-on: {ubuntu-24,x64,slim}       # Use slim for lightweight tasks
        steps:
          - run: npm run lint
  - name: build
    jobs:
      - name: compile
        runs-on: {ubuntu-24,x64,medium}     # Use medium for medium compilation
        steps:
          - run: make build
  - 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 in AtomGit Action, equivalent to:

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

That is, it defaults to using the latest Ubuntu, x64 architecture, and small specification (2 cores, 8GB).

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

Multiple Tag Matching

runs-on can specify multiple tags; the Runner must meet all tags to be selected:

jobs:
  - 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 you need fixed versions, it is recommended to explicitly install them in the step or use the container field to specify a custom image.