# microsoft/vscode-linux-build-agent architecture

> Architecture diagram of the GitHub repository microsoft/vscode-linux-build-agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/microsoft/vscode-linux-build-agent
- Repository: https://github.com/microsoft/vscode-linux-build-agent

## Overview

##### Project type and purpose
- This is neither a web or full-stack app nor a compiler/package under test; it is an open-source build agent project.
- Its purpose is to automate creation of Linux build containers and cross-compile toolchain images (glibc and musl variants) for VS Code via Docker and Azure Pipelines, producing reusable “Linux Build Agent” images across multiple CPU architectures.

##### File structure
- Top level:
- Dockerfile configurations organized by target OS/distribution and architecture (e.g., alpine-arm64/, alpine-x64/).
- “archived/” holds legacy/unused Dockerfiles.
- Compiler config files (e.g., x86_64-gcc-8.5.0-glibc-2.28.config) define build flags.
- Azure CI pipeline definitions (azure-pipelines.yml, build-containers.yml, build-gnu-toolchain.yml, build-musl-toolchain.yml).
- “snapcraft-x64/” for Snap image packaging.
- “sysroot-scripts/” containing scripts and generated package lists for sysroot creation.
- Patterns:
- CI-as-code: multiple YAML files drive Azure DevOps pipelines.
- Docker-based micro-services: each image build is an isolated Docker build stage.
- Scripted orchestration: Python and shell scripts generate package lists and invoke Docker builds.

##### README for additional insights
- Minimal README: confirms that “pushing to main” triggers builds, implying full automation in CI.

##### Elements
- Clear labels: “Azure DevOps Pipelines,” “Sysroot Scripts,” “Docker Engine,” “External Repos,” “Registry.”
- Pipelines → Sysroot-scripts (generate lists)
- Sysroot-scripts → Docker Builds
- Docker Builds → Registry
- External Repos → Sysroot-scripts & Docker Builds
- Blue rectangles for CI components (pipelines, YAML)
- Orange parallelograms for scripts/services

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Top: CI Pipelines
    subgraph "Azure DevOps Pipelines"
        direction TB
        Pipelines["Azure DevOps Pipelines"]:::ci
        Y1["azure-pipelines.yml"]:::ci
        Y2["build-containers.yml"]:::ci
        Y3["build-gnu-toolchain.yml"]:::ci
        Y4["build-musl-toolchain.yml"]:::ci
    end

    %% Sysroot Scripts
    Sysroot["Sysroot-scripts Service"]:::script

    %% Generated Data
    Packages["Generated Package Lists"]:::data
    P1["bullseye.amd64"]:::data
    P2["bullseye.arm64"]:::data
    P3["bullseye.armhf"]:::data

    %% Docker Engine
    Engine["Docker Engine"]:::engine

    %% Dockerfiles by distro/arch
    subgraph "Dockerfiles by Distro/Arch"
        direction TB
        subgraph "Active Targets"
            direction TB
            DA1["alpine-arm64/Dockerfile"]:::dockerfile
            DA2["alpine-x64/Dockerfile"]:::dockerfile
        end
        subgraph "Archived (Legacy)"
            direction TB
            AR1["archived/arm64/Dockerfile_Unused"]:::dockerfile
            AR2["archived/armhf/Dockerfile_Unused"]:::dockerfile
            AR3["archived/bionic-arm32v7/Dockerfile_Unused"]:::dockerfile
            AR4["archived/bionic-arm64/Dockerfile_Unused"]:::dockerfile
            AR5["archived/bionic-armhf/Dockerfile_Unused"]:::dockerfile
            AR6["archived/bionic-x64-v0/Dockerfile_Unused"]:::dockerfile
            AR7["archived/bionic-x64-v0/xvfb-init.sh"]:::script
            AR8["archived/bionic-x64-v1/Dockerfile_Unused"]:::dockerfile
            AR9["archived/bionic-x64-v1/xvfb-init.sh"]:::script
        end
        subgraph "Snapcraft Packaging"
            direction TB
            SNAP["snapcraft-x64/Dockerfile"]:::dockerfile
        end
    end

    %% Registry and Consumers
    Registry["Container Registry"]:::registry
    Consumers["VS Code Build Consumers"]:::consumer

    %% External Repos
    External["External Package Repositories"]:::external

    %% Connections
    Pipelines --> Y1
    Pipelines --> Y2
    Pipelines --> Y3
    Pipelines --> Y4
    Pipelines -->|triggers| Sysroot
    External -->|provides packages| Sysroot
    Sysroot -->|generates| Packages
    Packages --> P1
    Packages --> P2
    Packages --> P3
    External -->|base layers| Engine
    Sysroot -->|feeds lists| Engine
    Engine -->|builds| DA1
    Engine -->|builds| DA2
    Engine -->|builds| AR1
    Engine -->|builds| AR2
    Engine -->|builds| AR3
    Engine -->|builds| AR4
    Engine -->|builds| AR5
    Engine -->|builds| AR6
    Engine -->|builds| AR7
    Engine -->|builds| AR8
    Engine -->|builds| AR9
    Engine -->|builds| SNAP
    DA1 -->|push| Registry
    DA2 -->|push| Registry
    SNAP -->|push| Registry
    Registry -->|pulled by| Consumers

    %% Click Events
    click Y1 "https://github.com/microsoft/vscode-linux-build-agent/blob/main/azure-pipelines.yml"
    click Y2 "https://github.com/microsoft/vscode-linux-build-agent/blob/main/build-containers.yml"
    click Y3 "https://github.com/microsoft/vscode-linux-build-agent/blob/main/build-gnu-toolchain.yml"
    click Y4 "https://github.com/microsoft/vscode-linux-build-agent/blob/main/build-musl-toolchain.yml"
    click Sysroot "https://github.com/microsoft/vscode-linux-build-agent/blob/main/sysroot-scripts/sysroot-creator.sh"
    click Sysroot "https://github.com/microsoft/vscode-linux-build-agent/blob/main/sysroot-scripts/merge-package-lists.py"
    click Sysroot "https://github.com/microsoft/vscode-linux-build-agent/blob/main/sysroot-scripts/keyring.gpg"
    click P1 "https://github.com/microsoft/vscode-linux-build-agent/blob/main/sysroot-scripts/generated_package_lists/bullseye.amd64"
    click P2 "https://github.com/microsoft/vscode-linux-build-agent/blob/main/sysroot-scripts/generated_package_lists/bullseye.arm64"
    click P3 "https://github.com/microsoft/vscode-linux-build-agent/blob/main/sysroot-scripts/generated_package_lists/bullseye.armhf"
    click DA1 "https://github.com/microsoft/vscode-linux-build-agent/tree/main/alpine-arm64/Dockerfile"
    click DA2 "https://github.com/microsoft/vscode-linux-build-agent/tree/main/alpine-x64/Dockerfile"
    click AR1 "https://github.com/microsoft/vscode-linux-build-agent/tree/main/archived/arm64/Dockerfile_Unused"
    click AR2 "https://github.com/microsoft/vscode-linux-build-agent/tree/main/archived/armhf/Dockerfile_Unused"
    click AR3 "https://github.com/microsoft/vscode-linux-build-agent/tree/main/archived/bionic-arm32v7/Dockerfile_Unused"
    click AR4 "https://github.com/microsoft/vscode-linux-build-agent/tree/main/archived/bionic-arm64/Dockerfile_Unused"
    click AR5 "https://github.com/microsoft/vscode-linux-build-agent/tree/main/archived/bionic-armhf/Dockerfile_Unused"
    click AR6 "https://github.com/microsoft/vscode-linux-build-agent/tree/main/archived/bionic-x64-v0/Dockerfile_Unused"
    click AR7 "https://github.com/microsoft/vscode-linux-build-agent/blob/main/archived/bionic-x64-v0/xvfb-init.sh"
    click AR8 "https://github.com/microsoft/vscode-linux-build-agent/tree/main/archived/bionic-x64-v1/Dockerfile_Unused"
    click AR9 "https://github.com/microsoft/vscode-linux-build-agent/blob/main/archived/bionic-x64-v1/xvfb-init.sh"
    click SNAP "https://github.com/microsoft/vscode-linux-build-agent/tree/main/snapcraft-x64/Dockerfile"

    %% Styles
    classDef ci fill:#D0E6FF,stroke:#4D9FFF,color:#024B98;
    classDef script fill:#FFE8CC,stroke:#FFAA33,color:#994F00;
    classDef data fill:#E6F9D5,stroke:#47B900,color:#155D00;
    classDef engine fill:#F0F0F0,stroke:#999999,color:#333333;
    classDef dockerfile fill:#FFF2F2,stroke:#FF6666,color:#990000;
    classDef external fill:#E0F7FA,stroke:#00ACC1,color:#006064,stroke-dasharray: 5 5;
    classDef registry fill:#F3E5F5,stroke:#AB47BC,color:#4A148C;
    classDef consumer fill:#ECEFF1,stroke:#78909C,color:#102027;
```
