This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/tooling-docs.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 2806b15 Automatic Site Publish by Buildbot
2806b15 is described below
commit 2806b154f3410eba1ef59975f13b3a7ffbdc5351
Author: buildbot <[email protected]>
AuthorDate: Tue Mar 11 20:15:37 2025 +0000
Automatic Site Publish by Buildbot
---
output/_pagefind/fragment/en_12ee7eb.pf_fragment | Bin 0 -> 1682 bytes
output/_pagefind/fragment/en_6d6db61.pf_fragment | Bin 1685 -> 0 bytes
output/_pagefind/fragment/en_e39ca81.pf_fragment | Bin 0 -> 1712 bytes
output/_pagefind/index/en_bbf88a1.pf_index | Bin 0 -> 6384 bytes
output/_pagefind/index/en_dfb627b.pf_index | Bin 4499 -> 0 bytes
output/_pagefind/pagefind-entry.json | 2 +-
output/_pagefind/pagefind.en_2b44f726d5.pf_meta | Bin 119 -> 0 bytes
output/_pagefind/pagefind.en_d85f2be4de.pf_meta | Bin 0 -> 130 bytes
output/platform.html | 269 +++++++++++++++++++++++
output/trusted-release.html | 5 +-
10 files changed, 272 insertions(+), 4 deletions(-)
diff --git a/output/_pagefind/fragment/en_12ee7eb.pf_fragment
b/output/_pagefind/fragment/en_12ee7eb.pf_fragment
new file mode 100644
index 0000000..1d9db69
Binary files /dev/null and b/output/_pagefind/fragment/en_12ee7eb.pf_fragment
differ
diff --git a/output/_pagefind/fragment/en_6d6db61.pf_fragment
b/output/_pagefind/fragment/en_6d6db61.pf_fragment
deleted file mode 100644
index af95fa5..0000000
Binary files a/output/_pagefind/fragment/en_6d6db61.pf_fragment and /dev/null
differ
diff --git a/output/_pagefind/fragment/en_e39ca81.pf_fragment
b/output/_pagefind/fragment/en_e39ca81.pf_fragment
new file mode 100644
index 0000000..de71013
Binary files /dev/null and b/output/_pagefind/fragment/en_e39ca81.pf_fragment
differ
diff --git a/output/_pagefind/index/en_bbf88a1.pf_index
b/output/_pagefind/index/en_bbf88a1.pf_index
new file mode 100644
index 0000000..b0e5863
Binary files /dev/null and b/output/_pagefind/index/en_bbf88a1.pf_index differ
diff --git a/output/_pagefind/index/en_dfb627b.pf_index
b/output/_pagefind/index/en_dfb627b.pf_index
deleted file mode 100644
index 3786bdd..0000000
Binary files a/output/_pagefind/index/en_dfb627b.pf_index and /dev/null differ
diff --git a/output/_pagefind/pagefind-entry.json
b/output/_pagefind/pagefind-entry.json
index 3f12902..1b7f67f 100644
--- a/output/_pagefind/pagefind-entry.json
+++ b/output/_pagefind/pagefind-entry.json
@@ -1 +1 @@
-{"version":"1.0.4","languages":{"en":{"hash":"en_2b44f726d5","wasm":"en","page_count":5}}}
\ No newline at end of file
+{"version":"1.0.4","languages":{"en":{"hash":"en_d85f2be4de","wasm":"en","page_count":6}}}
\ No newline at end of file
diff --git a/output/_pagefind/pagefind.en_2b44f726d5.pf_meta
b/output/_pagefind/pagefind.en_2b44f726d5.pf_meta
deleted file mode 100644
index 270acf7..0000000
Binary files a/output/_pagefind/pagefind.en_2b44f726d5.pf_meta and /dev/null
differ
diff --git a/output/_pagefind/pagefind.en_d85f2be4de.pf_meta
b/output/_pagefind/pagefind.en_d85f2be4de.pf_meta
new file mode 100644
index 0000000..afc9ccd
Binary files /dev/null and b/output/_pagefind/pagefind.en_d85f2be4de.pf_meta
differ
diff --git a/output/platform.html b/output/platform.html
new file mode 100644
index 0000000..7503377
--- /dev/null
+++ b/output/platform.html
@@ -0,0 +1,269 @@
+<!doctype html>
+<html class="no-js" lang="en" dir="ltr">
+ <head>
+ <meta charset="utf-8">
+ <meta http-equiv="x-ua-compatible" content="ie=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+ <title>Apache Trusted Release Platform Services - ASF Tooling
Website</title>
+<link href="/css/bootstrap.min.css" rel="stylesheet">
+<link href="/css/fontawesome.all.min.css" rel="stylesheet">
+<link href="/css/headerlink.css" rel="stylesheet">
+<script src="/highlight/highlight.min.js"></script>
+<!-- pagefind search -->
+<link href="/_pagefind/pagefind-ui.css" rel="stylesheet">
+<script src="/_pagefind/pagefind-ui.js" type="text/javascript"></script>
+<script>
+ window.addEventListener('DOMContentLoaded', (event) => {
+ new PagefindUI({ element: "#pagefind-search" });
+ });
+ var pageTitle = '';
+ if(pageTitle === '404'){
+ window.addEventListener('DOMContentLoaded', (event) => {
+ new PagefindUI({ element: "#page-404-search" });
+ });
+ }
+</script>
+<!-- pagefind search box styling -->
+<style type="text/css">
+ .search-form {
+ right: 0;
+ left: initial !important;
+ min-width: 25vw;
+ max-width: 90vw;
+ max-height: calc(95vh - 100px);
+ overflow: auto;
+ margin-top: 5px;
+ }
+</style>
+ </head>
+ <body class="d-flex flex-column h-100">
+ <main class="flex-shrink-0">
+ <div>
+<!-- nav bar -->
+<nav class="navbar navbar-expand-lg navbar-dark bg-dark" aria-label="Fifth
navbar example">
+ <div class="container-fluid">
+ <a class="navbar-brand" href="/"><img src="/images/feather.png"
style="height: 32px;"/> ASF Tooling</a>
+ <button class="navbar-toggler" type="button" data-bs-toggle="collapse"
data-bs-target="#navbarADP" aria-controls="navbarADP" aria-expanded="false"
aria-label="Toggle navigation">
+ <span class="navbar-toggler-icon"></span>
+ </button>
+
+ <div class="collapse navbar-collapse" id="navbarADP">
+ <ul class="navbar-nav me-auto mb-2 mb-lg-0">
+ <li class="nav-item dropdown">
+ <a class="nav-link dropdown-toggle" href="#"
data-bs-toggle="dropdown" aria-expanded="false">About</a>
+ <ul class="dropdown-menu">
+ <!--<li><a class="dropdown-item" href="/blog/">Tooling
Blog</a></li>-->
+ <li><a class="dropdown-item" href="/team.html">About the
team</a></li>
+ <li><a class="dropdown-item" href="/trusted-release.html">Trusted
Release</a></li>
+ </ul>
+ </li>
+
+ <li class="nav-item dropdown">
+ <a class="nav-link dropdown-toggle" href="#"
data-bs-toggle="dropdown" aria-expanded="false">Repositories</a>
+ <ul class="dropdown-menu">
+ <li><a class="dropdown-item"
href="https://github.com/apache/tooling-docs/";>Website and Docs</a></li>
+ <li><a class="dropdown-item"
href="https://github.com/apache/tooling-trusted-release";>Trusted
Release</a></li>
+ <li><a class="dropdown-item"
href="https://github.com/apache/infrastructure-agenda";>Agenda Tool</a></li>
+ </ul>
+ </li>
+
+ <li class="nav-item dropdown">
+ <a class="nav-link dropdown-toggle" href="#"
data-bs-toggle="dropdown" aria-expanded="false">Contribute</a>
+ <ul class="dropdown-menu">
+ <li><a class="dropdown-item" href="/volunteer.html">Volunteer with
Tooling</a></li>
+ </ul>
+ </li>
+
+ <li class="nav-item dropdown">
+ <a href="#" class="nav-link dropdown-toggle hidden-xs"
data-bs-toggle="dropdown"><span class="fa-solid fa-magnifying-glass"
aria-hidden="true"></span> Search</a>
+ <ul class="search-form dropdown-menu">
+ <li>
+ <div id="pagefind-search" class="input-group" style="width:
100%; padding: 0 5px;"></div>
+ </li>
+ </ul>
+ </li>
+ </ul>
+ </div>
+ </div>
+</nav><!-- page contents -->
+<div id="contents">
+ <div class="bg-white p-5 rounded">
+ <div class="col-sm-8 mx-auto">
+ <h1>
+ Apache Trusted Release Platform Services
+ </h1>
+ <p><em>This is a discussion and the actual implementation will
diverge.</em></p>
+<p><a href="https://releases.apache.org";>https://releases.apache.org</a></p>
+<h2>Datastore</h2>
+<blockquote>
+<p>We will iterate on these during implementation.</p>
+</blockquote>
+<ol>
+<li>Release Storage. A large filesystem with folders for each release's
files.</li>
+<li>Metadata Database. A database on the server with the metadata schema.</li>
+</ol>
+<p>See <a
href="https://github.com/apache/tooling-docs/blob/main/apache-trusted-release/data-model.md";>Data
Model</a> for a discussion of the objects managed by the ATR.</p>
+<h2>Web Service</h2>
+<ol>
+<li><code>asfquart</code> based asynchronous python web service.</li>
+<li>Fronted by <code>httpd</code>.</li>
+<li>Static content may be served without going through
<code>asfquart</code>.</li>
+<li>Monolithic.</li>
+<li>Fronted by a CDN. The caching policies need to be properly defined.</li>
+</ol>
+<h2>Legacy</h2>
+<ol>
+<li>These domains continue to work in the same way:
+<ul>
+<li>archive.apache.org</li>
+<li>downloads.apache.org and dlcdn.apache.org</li>
+<li>dist.apache.org</li>
+</ul>
+</li>
+<li>See <a
href="https://github.com/apache/tooling-docs/blob/main/apache-trusted-release/svn-dist.md";>Legacy
Releases from SVN Dist</a>. In this development phase we prefer to be at
<em>transition 2</em>.</li>
+</ol>
+<h3>Release Stages</h3>
+<ol>
+<li>Build Releases</li>
+<li>Candidate Releases</li>
+<li>Current Releases</li>
+<li>Archived / Revoked / EOL / Atticked Releases</li>
+</ol>
+<blockquote>
+<p>“Nightlies” a particular build type is for a later phase.</p>
+</blockquote>
+<h3>Release Phases</h3>
+<p>See <a
href="https://github.com/apache/tooling-docs/blob/main/apache-trusted-release/lifecycle.md";>Release
Lifecycle</a> for how phases are chained together to perform a Release.</p>
+<h3>Release co-ordinates</h3>
+<p>The co-ordinates make up the external path to objects. The metadata
database provides the map to the local path.</p>
+<ol>
+<li>Stage (Candidate, Current, Archived, …)</li>
+<li>PMC (Responsible TLP or Incubator PPMC)</li>
+<li>Product Line (Main, Sub-projects)</li>
+<li>Version (String, latest)</li>
+<li>Files, Metadata (A release is a folder of one or more files or
sub-folders)</li>
+</ol>
+<blockquote>
+<p>The following are examples. We will iterate during implementation.</p>
+</blockquote>
+<ul>
+<li>Latest main product release:
<code>/<stage>/<pmc>/latest/<file></code></li>
+<li>Main product by version:
<code>/<stage>/<pmc>/<version>/<file></code></li>
+<li>Latest product release:
<code>/<stage>/<pmc>/<product>/latest/<file></code></li>
+<li>Product release by version:
<code>/<stage>/<pmc>/<product>/<version>/<file></code></li>
+</ul>
+<h3>Restful API</h3>
+<ol>
+<li>
+<p>GET</p>
+<ul>
+<li>Metadata</li>
+<li>Release</li>
+<li>Package files including SBOMs</li>
+<li>Signing keys</li>
+</ul>
+</li>
+<li>
+<p>CRUD on</p>
+<ul>
+<li>Releases - Delete is not removal. It is a stage.</li>
+<li>Artifacts - Managed with a Release. Infra can do targeted full CRUD on
artifacts if required.</li>
+<li>Public Signing Keys - Delete only if unused.</li>
+<li>Votes - Store each vote in metadata.</li>
+<li>SBOMs - Special files stored in the release folder.</li>
+</ul>
+</li>
+<li>
+<p>POST Phases - Transitions, Activities, and Communication</p>
+<ul>
+<li>Transition into Phase.</li>
+<li>Perform Phase activity.</li>
+<li>Optionally email phase status.</li>
+</ul>
+<p>See <a
href="https://github.com/apache/tooling-docs/blob/main/apache-trusted-release/lifecycle.md";>Release
Lifecycle</a> for how phases are chained together to perform a Release.</p>
+</li>
+<li>
+<p>POST Templated Emails</p>
+<ul>
+<li>Announcements</li>
+<li>Votes</li>
+<li>Status</li>
+<li>Transitions</li>
+</ul>
+</li>
+</ol>
+<h3>Web UI</h3>
+<p>Note: this section is a flexible outline of what we intend for the UI, and
may change during implementation.</p>
+<ol>
+<li>
+<p>Directory Pages</p>
+<ul>
+<li>PMC directory (<em>main page</em>) - excludes podlings and atticked
PMCs</li>
+<li>PMC release directory (also PPMC)</li>
+<li>Incubator podling directory</li>
+<li>Atticked PMC directory</li>
+</ul>
+</li>
+<li>
+<p>Release Page</p>
+<ul>
+<li><a href="https://infra.apache.org/release-download-pages.html";>Download
page requirements</a></li>
+<li>Release level metadata</li>
+<li>PMC Information and webspage links</li>
+<li>Download package from directory of release</li>
+<li>Maintenance actions</li>
+<li>History of events</li>
+</ul>
+</li>
+<li>
+<p>PMC Management Page</p>
+<ul>
+<li>PMC level metadata and releases</li>
+<li>Product level metadata and releases</li>
+<li>Manage releases</li>
+<li>PMC lifecycle transitions - podling, TLP, attic.</li>
+</ul>
+</li>
+<li>
+<p>System Admin Page</p>
+<ul>
+<li>Manage Distribution Channels</li>
+<li>Perform Migration Tasks</li>
+<li>Enable GHA Builds</li>
+<li>Manage PMC Transitions</li>
+<li>Watch Operations</li>
+</ul>
+</li>
+<li>
+<p>Audit Page</p>
+<ul>
+<li>ASF event history</li>
+<li>PMC event history</li>
+<li>Product event history</li>
+</ul>
+</li>
+<li>
+<p>Page Template</p>
+<ul>
+<li>Responsive with Header(Hamburger)/Content/Footer.</li>
+<li>Include Search in Header(Hamburger)</li>
+</ul>
+</li>
+</ol>
+
+ </div>
+ </div>
+</div> <!-- footer -->
+ <div class="row">
+ <div class="large-12 medium-12 columns">
+ <p style="font-style: italic; font-size: 0.8rem; text-align: center;">
+ Copyright 2025, <a href="https://www.apache.org/";>The Apache
Software Foundation</a>, Licensed under the <a
href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License, Version
2.0</a>.<br/>
+ Apache® and the Apache feather logo are trademarks of The Apache
Software Foundation.
+ </p>
+ </div>
+ </div>
+ <script type="application/ecmascript" src="/js/bootstrap.bundle.min.js"
integrity="sha384-OERcA2EqjJCMA+/3y+gxIOqMEjwtxJY7qPCqsdltbNJuaOe923+mo//f6V8Qbsw3"></script>
</div>
+ </main>
+ <script>hljs.initHighlightingOnLoad();</script>
+ </body>
+</html>
diff --git a/output/trusted-release.html b/output/trusted-release.html
index b69a9ba..b92af44 100644
--- a/output/trusted-release.html
+++ b/output/trusted-release.html
@@ -92,8 +92,7 @@
<h1>
Apache Trusted Release Platform
</h1>
- <h1>Apache Trusted Release</h1>
-<p>The main project is the Apache Trusted Release Platform.</p>
+ <p>The main project is the Apache Trusted Release Platform.</p>
<h2>1. Automate the Release Process</h2>
<ul>
<li>Minimize human interaction.</li>
@@ -138,7 +137,7 @@
<li>Provide operational status to help Infra monitor ATR operations through
the Infra Reporting Dashboard (IRD).</li>
<li>Develop the platform with consideration about reusability outside of the
ASF ecosystem, where feasible with regards to development costs.</li>
</ul>
-<p>See <a
href="https://github.com/apache/tooling-docs/blob/main/apache-trusted-release/platform.md";>Platform
Services</a> for detailed requirements for the <strong>ATR</strong>.</p>
+<p>See <a href="platform.md">Platform Services</a> for detailed requirements
for the <strong>ATR</strong>.</p>
<h2>4. Automate Release Process around Compliance</h2>
<ul>
<li>Meet Release Policy
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
