Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
43 commits
Select commit Hold shift + click to select a range
60b930f
Delete content/pages/atr/maven/README.md
dave2wave Aug 25, 2026
d770dd5
Update links in menu.html for Trusted Releases and Docs
dave2wave Aug 25, 2026
ea5c2c3
Add details about volunteer-led tools
dave2wave Aug 25, 2026
71cdc36
Add design document for Apache Trusted Releases
dave2wave Aug 25, 2026
6bdb040
Update atr-design-doc.md
dave2wave Aug 25, 2026
1829ae9
Fix HTML structure in menu template
dave2wave Aug 25, 2026
524da3e
Revise Trusted Releases documentation
dave2wave Aug 25, 2026
8639809
Update profile setting in .asf.yaml
dave2wave Aug 25, 2026
8a80918
Add release phases to trusted releases documentation
dave2wave Aug 25, 2026
0713c07
Document release phases in trusted releases
dave2wave Aug 25, 2026
c2d4782
Revise contribution details and update links in index.md
dave2wave Aug 25, 2026
db19053
Fix dropdown divider closing tag in menu.html
dave2wave Aug 25, 2026
7069dd8
Add links to ATR resources in index.md
dave2wave Aug 25, 2026
be35b8e
Update checkout action version in workflow
dave2wave Aug 25, 2026
382b83e
Update checkout action version in pre-commit.yml
dave2wave Aug 25, 2026
6a28583
Update pre-commit workflow to use specific cache version
dave2wave Aug 25, 2026
d6b408f
Remove extra blank lines in index.md
dave2wave Aug 25, 2026
59b4b09
Update checkout action version in workflow
dave2wave Aug 25, 2026
c1aef10
Update checkout and cache action comments in workflow
dave2wave Aug 25, 2026
6726c78
Fix syntax for setting PY in pre-commit workflow
dave2wave Aug 25, 2026
ddbcde7
Refine documentation for Apache Trusted Releases platform
dave2wave Aug 26, 2026
10be7da
Revise trusted releases documentation
dave2wave Aug 26, 2026
82a85ba
Enhance documentation for Apache Trusted Releases
dave2wave Aug 27, 2026
c978175
Update markdown headings and structure for clarity
dave2wave Aug 27, 2026
c987cca
Add 'asfgenid' to plugins in pelicanconf.yaml
dave2wave Aug 27, 2026
f7a7627
Update headings and formatting in trusted-releases.md
dave2wave Aug 27, 2026
3be3867
Add metadata and configuration options to pelicanconf
dave2wave Aug 27, 2026
7d467df
Enable metadata and elements in ASF_GENID plugin
dave2wave Aug 27, 2026
a6b98d2
Update headings and formatting in trusted-releases.md
dave2wave Aug 27, 2026
292e2e4
Increase top padding for body in styles.html
dave2wave Aug 27, 2026
2c1d553
Update trusted-releases.md to remove obsolete content
dave2wave Aug 27, 2026
eaa3010
Enhance clarity in voting and release distribution sections
dave2wave Aug 27, 2026
a2533b2
Add TOC to trusted-releases.md
dave2wave Aug 27, 2026
52cd2df
Update table of contents marker in trusted-releases.md
dave2wave Aug 27, 2026
6b46152
Update trusted-releases.md with new TOC
dave2wave Aug 27, 2026
f929e1f
Update markdown formatting and section headers
dave2wave Aug 27, 2026
79d4e57
Clean up formatting in trusted-releases.md
dave2wave Aug 27, 2026
c1a8498
Update headings and format in trusted-releases.md
dave2wave Aug 27, 2026
860419b
Update formatting in trusted-releases.md
dave2wave Aug 27, 2026
a17e14c
Update descriptions for trusted releases repositories
dave2wave Aug 27, 2026
752b183
Fix punctuation and formatting in trusted-releases.md
andrewmusselman Aug 27, 2026
1dcfc4c
Revise title and description for ASF Tooling team
dave2wave Aug 27, 2026
b3d61f2
Replace example workflows link with Maven plugin link
dave2wave Aug 27, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .asf.yaml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
staging:
profile:
profile: ~
autostage: preview/*

pelican:
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/build-pelican.yml
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ jobs:
permissions:
contents: write # because we push to asf-site
steps:
- uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v6.0.0
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: true
ref: ${{ github.ref || 'main' }}
Expand Down
4 changes: 2 additions & 2 deletions .github/workflows/pre-commit.yml
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ jobs:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v6.0.0
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- name: Install
Expand All @@ -21,7 +21,7 @@ jobs:
pip install pre-commit
- name: Set PY
run: echo "PY=$(python -VV | sha256sum | cut -d' ' -f1)" >> "$GITHUB_ENV"
- uses: actions/cache@v4
- uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.0.1
with:
path: ~/.cache/pre-commit
key: pre-commit|${{ env.PY }}|${{ hashFiles('.pre-commit-config.yaml') }}
Expand Down
86 changes: 86 additions & 0 deletions content/pages/atr-design-doc.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,86 @@
Title: Apache Trusted Releases design
license: https://www.apache.org/licenses/LICENSE-2.0

The main project is the Apache Trusted Releases platform. This is the initial design document.

Repositories:

- https://github.com/apache/tooling-trusted-releases
- https://github.com/apache/tooling-releases-client

## 1. Automate the Release Process

- Minimize human interaction.
- Community participation on **Release Votes** remains via email.
- Record all of the key events and metrics for tracking operations and performance.
- PMCs can quickly benefit.
- Infra costs and management complexity are decreased.

## 2. Community

- Work with a selection of **Apache** PMCs, **Incubator PPMCs(podlings)**, and **Infra** for **User Acceptance Testing (UAT)**.
- Co-ordinate with **Infra** on migration and operation.
- Contribute to Infra's **asfquart** and **asfpy** frameworks.
- Provide openings for volunteers to help so long as the contributions are adequate and timely.
- Assure that the **ATR platform** follows industry best practices especially regarding **SBOMs**,
**Certificate Management**, and **Digital Signatures**.
- Help lead the industry to better practices.
- Work within the **ASF** on **Release Policy** improvements.

## 3. Apache Trusted Release Platform (ATR)

- Incorporate all PMC Releases.
- Download page.
- Release Candidate page.
- Archived download page.
- Every PMC has a management interface.
- Current manual release practice is viewable.
- Automated release status.
- **KEYS** file management including revoking keys.
- Trigger release phases.
- Tracking performance.
- Platform includes a RESTful API.
- Serve release artifacts efficiently.
- Make switching from current manual release process to a minimal ATR process very simple.
- System Admins (Infra) have a management interface.
- Provide operational status to help Infra monitor ATR operations through the Infra Reporting Dashboard (IRD).
- Develop the platform with consideration about reusability outside of the ASF ecosystem, where feasible with regards to development costs.

See [Platform Services](platform.html) for detailed requirements for the **ATR**.

## 4. Automate Release Process around Compliance

- Meet Release Policy
- Legal Policy
- Infra Policy
- Security Policy
- SBOMs and Attestations
- Include dependency and license compliance.
- Provide clear attribution and information about Release Votes.
- Certificate and Credential Management
- Manage the signing keys needed for automation.
- Download Page including available SBOM and verification instructions.
- Announcement Email.

## 5. Release Lifecycle Phases

Here is a flow chart showing the [Release Lifecycle Phases](https://github.com/apache/tooling-docs/blob/main/apache-trusted-releases/lifecycle.md).

## 6. Infrastructure Requirements

- Run book for releases.apache.org
- Progress on the retirement path for `svn:dist`. See [Legacy Releases from SVN Dist](svn-dist.html)
for possible transitional states. For the beta test _transition 1B_ is preferred.
- Legacy urls for dist.apache.org, downloads.apache.org, dlcdn.apache.org, and archive.apache.org remain supported.
- Path schemes for downloads.apache.org, dlcdn.apache.org, and archive.apache.org remain.

## 7. Future Requirements

- Integrate with the [Security Advisory Process](https://github.com/apache/tooling-docs/blob/main/apache-trusted-releases/advisory-process.md) to make it easy to track applicable advisories on download pages.
- Expand support for [Evaluating Build Claims](https://github.com/apache/tooling-docs/blob/main/apache-trusted-releases/evaluate.md) to additional build tools.
- Expand automated support for additional [Distribution Channels](https://github.com/apache/tooling-docs/blob/main/apache-trusted-releases/distributions.md).
- Include a [Signing Candidates](https://github.com/apache/tooling-docs/blob/main/apache-trusted-releases/digital-signatures.md) phase during ATR processing.

> There are policy implications to the automation of digital signatures.
> For now, creating digital signatures on certain artifact types must be done prior to GPG signing and
> prior to submission of the release candidate.
4 changes: 0 additions & 4 deletions content/pages/atr/maven/README.md

This file was deleted.

26 changes: 14 additions & 12 deletions content/pages/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,25 +22,19 @@ developed by ASF Infrastructure.
2. Automate the Release Process for the benefit of PMCs while also reducing infrastructure
costs and management complexity.

### Contribute to the Discussion

- Repository: https://github.com/apache/tooling-docs
- ASF Slack Channels: [#tooling-discuss](https://the-asf.slack.com/archives/C086X8CKEMB) – [#apache-trusted-releases](https://the-asf.slack.com/archives/C049WADAAQG)
- Mailing List: dev@tooling.apache.org – [archives](https://lists.apache.org/list.html?dev@tooling.apache.org)
- Subscribe to Mailing List: dev-subscribe@tooling.apache.org

### Apache Trusted Releases (ATR) platform

All ASF Projects may participate in our second Alpha testing the new automation framework.
All ASF PMCs and Incubating podlings may participate in Beta testing of our new [Trusted Releases](/trusted-releases.html) platform.

#### ATR Website

Login to the ATR using your ASF credentials and you will have access to your PMC's projects.
Incubating projects are welcome to join.

1. ATR: https://release-test.apache.org/
2. Open API: https://release-test.apache.org/api/docs
3. Comparison: https://release-test.apache.org/about
1. ATR: https://releases.apache.org
2. Docs: https://releases.apache.org/docs
3. Open API: https://releases.apache.org/api/docs
4. Catalog: https://release-catalog.apache.org

#### Source code

Expand All @@ -49,8 +43,16 @@ Here are the source code repositories. Please view the README.md files for instr
1. Website: https://github.com/apache/tooling-trusted-releases
2. Python Client: https://github.com/apache/tooling-releases-client
3. GitHub Actions: https://github.com/apache/tooling-actions
4. Example Workflows: https://github.com/apache/tooling-asf-example/
4. Maven plugin: https://github.com/apache/tooling-atr-maven-plugin
5. Example Workflows: https://github.com/apache/tooling-asf-example

### Security Issues

To report a new vulnerability you have discovered please follow the [ASF vulnerability reporting process](https://apache.org/security/#reporting-a-vulnerability).

### Contribute to the Discussion

- Repository: https://github.com/apache/tooling-docs
- ASF Slack Channels: [#tooling-discuss](https://the-asf.slack.com/archives/C086X8CKEMB) – [#apache-trusted-releases](https://the-asf.slack.com/archives/C049WADAAQG)
- Mailing List: dev@tooling.apache.org – [archives](https://lists.apache.org/list.html?dev@tooling.apache.org)
- Subscribe to Mailing List: dev-subscribe@tooling.apache.org
4 changes: 2 additions & 2 deletions content/pages/team.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
Title: About the Apache Tooling Team
license: https://www.apache.org/licenses/LICENSE-2.0

# ASF Tooling
# ASF Tooling Initiative

The ASF Tooling team, known as **Tooling**, provides tooling development for select ASF Initiatives.
The ASF Tooling Initiative, known as **Tooling**, provides tooling development for select ASF Initiatives. We consist of both paid staff and volunteers.

## About us

Expand Down
Loading