# ansible-community/ansible-build-data architecture

> Architecture diagram of the GitHub repository ansible-community/ansible-build-data, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ansible-community/ansible-build-data
- Repository: https://github.com/ansible-community/ansible-build-data

## Overview

ansible-build-data is a persistent release-data repository for the Ansible community package, not an application runtime. Release engineers coordinate release plans and collection changes, maintain per-major inputs and compatibility ranges, and use antsibull-build to produce version-specific dependency records. Other projects and scripts can refer to these records. The graph reflects the README and file tree; no runtime implementation was sampled, so edges describe documented stewardship and data use rather than internal calls.

Main entry points: [`11/ansible-11.build`](https://github.com/ansible-community/ansible-build-data/blob/main/11/ansible-11.build) (Compatibility ranges), [`11/ansible-11.13.0.deps`](https://github.com/ansible-community/ansible-build-data/blob/main/11/ansible-11.13.0.deps) (Exact dependencies), [`11/ansible.in`](https://github.com/ansible-community/ansible-build-data/blob/main/11/ansible.in) (Collection list), [`11/ansible-11.13.0.yaml`](https://github.com/ansible-community/ansible-build-data/blob/main/11/ansible-11.13.0.yaml) (Release record)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planning["Release planning"]
  node_issue_tracker["GitHub issues"]
  node_milestones["Release milestones"]
  node_community["Community topics"]
end

subgraph group_inputs["Release inputs"]
  node_release_list["Collection list<br/>[ansible.in]"]
  node_version_ranges["Compatibility ranges<br/>[ansible-11.build]"]
end

subgraph group_records["Release records"]
  node_deps["Exact dependencies"]
  node_release_yaml["Release record"]
  node_release_tags["Release tags"]
  node_changelog["Release changelog<br/>[CHANGELOG-v11.md]"]
  node_porting_guide["Porting guide"]
end

subgraph group_collection["Collection information"]
  node_collection_meta["Collection metadata"]
  node_galaxy_requirements["Galaxy requirements"]
end

node_release_engineer(("Release engineer"))
node_antsibull["antsibull-build"]
node_consumers(("Other projects and scripts"))

node_release_engineer -->|"tracks issues"| node_issue_tracker
node_release_engineer -->|"checks releases"| node_milestones
node_release_engineer -->|"raises blockers"| node_community
node_release_engineer -->|"maintains list"| node_release_list
node_release_engineer -->|"sets ranges"| node_version_ranges
node_release_engineer -->|"maintains metadata"| node_collection_meta
node_release_engineer -->|"maintains requirements"| node_galaxy_requirements
node_antsibull -->|"reads ranges"| node_version_ranges
node_antsibull -->|"generates records"| node_deps
node_consumers -->|"refers to versions"| node_deps
node_consumers -->|"refers to releases"| node_release_yaml
node_release_engineer -->|"tracks changes"| node_changelog
node_release_engineer -->|"documents upgrades"| node_porting_guide
node_release_engineer -->|"maintains tags"| node_release_tags

click node_release_list "https://github.com/ansible-community/ansible-build-data/blob/main/11/ansible.in"
click node_version_ranges "https://github.com/ansible-community/ansible-build-data/blob/main/11/ansible-11.build"
click node_collection_meta "https://github.com/ansible-community/ansible-build-data/blob/main/11/collection-meta.yaml"
click node_galaxy_requirements "https://github.com/ansible-community/ansible-build-data/blob/main/11/galaxy-requirements.yaml"
click node_deps "https://github.com/ansible-community/ansible-build-data/blob/main/11/ansible-11.13.0.deps"
click node_release_yaml "https://github.com/ansible-community/ansible-build-data/blob/main/11/ansible-11.13.0.yaml"
click node_release_tags "https://github.com/ansible-community/ansible-build-data/blob/main/11/ansible-11.13.0-tags.yaml"
click node_changelog "https://github.com/ansible-community/ansible-build-data/blob/main/11/CHANGELOG-v11.md"
click node_porting_guide "https://github.com/ansible-community/ansible-build-data/blob/main/11/porting_guide_11.rst"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_issue_tracker,node_milestones,node_community toneBlue
class node_release_list,node_version_ranges toneAmber
class node_deps,node_release_yaml,node_release_tags,node_changelog,node_porting_guide toneMint
class node_collection_meta,node_galaxy_requirements toneRose
class node_release_engineer,node_antsibull,node_consumers toneIndigo
```

## Components

### Release planning

- **GitHub issues**
- **Release milestones**
- **Community topics**

### Release inputs

- [Collection list](https://github.com/ansible-community/ansible-build-data/blob/main/11/ansible.in): `11/ansible.in`
- [Compatibility ranges](https://github.com/ansible-community/ansible-build-data/blob/main/11/ansible-11.build): `11/ansible-11.build`

### Release records

- [Exact dependencies](https://github.com/ansible-community/ansible-build-data/blob/main/11/ansible-11.13.0.deps): `11/ansible-11.13.0.deps`
- [Release record](https://github.com/ansible-community/ansible-build-data/blob/main/11/ansible-11.13.0.yaml): `11/ansible-11.13.0.yaml`
- [Release tags](https://github.com/ansible-community/ansible-build-data/blob/main/11/ansible-11.13.0-tags.yaml): `11/ansible-11.13.0-tags.yaml`
- [Release changelog](https://github.com/ansible-community/ansible-build-data/blob/main/11/CHANGELOG-v11.md): `11/CHANGELOG-v11.md`
- [Porting guide](https://github.com/ansible-community/ansible-build-data/blob/main/11/porting_guide_11.rst): `11/porting_guide_11.rst`

### Collection information

- [Collection metadata](https://github.com/ansible-community/ansible-build-data/blob/main/11/collection-meta.yaml): `11/collection-meta.yaml`
- [Galaxy requirements](https://github.com/ansible-community/ansible-build-data/blob/main/11/galaxy-requirements.yaml): `11/galaxy-requirements.yaml`

### Other components

- **Release engineer**
- **antsibull-build**
- **Other projects and scripts**

## Connections

- Release engineer → GitHub issues: tracks issues
- Release engineer → Release milestones: checks releases
- Release engineer → Community topics: raises blockers
- Release engineer → Collection list: maintains list
- Release engineer → Compatibility ranges: sets ranges
- Release engineer → Collection metadata: maintains metadata
- Release engineer → Galaxy requirements: maintains requirements
- antsibull-build → Compatibility ranges: reads ranges
- antsibull-build → Exact dependencies: generates records
- Other projects and scripts → Exact dependencies: refers to versions
- Other projects and scripts → Release record: refers to releases
- Release engineer → Release changelog: tracks changes
- Release engineer → Porting guide: documents upgrades
- Release engineer → Release tags: maintains tags