Using AtomGit Hosted Runners

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

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

Configuration Instructions

Official Hosted Runner Tag System

AtomGit Action official resource pool Runners use 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 Specifications	slim, small, medium, large, xlarge, 2xlarge

Resource Specifications Details

Specification	CPU	Memory	Applicable Scenario	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 tests	{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 of slim, small, and medium specifications. If you need resources of large or higher specifications, please consult AtomGit customer service.

Specify Runner in Workflow

# .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: Packaging
    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]

Which means using the latest Ubuntu, x64 architecture, and small specification (2 cores, 8GB).

jobs:
  simple-test:
    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:
  arm64-build:
    name: arm64-build
    runs-on: {ubuntu-24,arm64,medium}
    steps:
      - run: make build ARCH=arm64

Pre-installed Tools for 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.