This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/datafusion.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 18c6c7e608 Publish built docs triggered by
60457d0b0af59165100091fdc84c5efbe7bd6e63
18c6c7e608 is described below
commit 18c6c7e60889ba211646688d3e13296623e942a6
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Mon Feb 23 10:06:16 2026 +0000
Publish built docs triggered by 60457d0b0af59165100091fdc84c5efbe7bd6e63
---
_sources/contributor-guide/index.md.txt | 28 +++++++++++++++++++++++++++-
contributor-guide/index.html | 31 +++++++++++++++++++++++++++++--
searchindex.js | 2 +-
3 files changed, 57 insertions(+), 4 deletions(-)
diff --git a/_sources/contributor-guide/index.md.txt
b/_sources/contributor-guide/index.md.txt
index 900df2f881..2ee8a2aaac 100644
--- a/_sources/contributor-guide/index.md.txt
+++ b/_sources/contributor-guide/index.md.txt
@@ -202,6 +202,32 @@ It's recommended to write a high-quality issue with a
clear problem statement an
### CI Runners
-We use [Runs-On](https://runs-on.com/) for some actions in the main
repository, which run in the ASF AWS account to speed up CI time. In forks,
these actions run on the default GitHub runners since forks do not have access
to ASF infrastructure.
+#### Runs-On
+
+We use [Runs-On](https://runs-on.com/) for some actions in the main
repository, which run in the ASF AWS account to speed up CI. In forks, these
actions run on the default GitHub runners since forks do not have access to ASF
infrastructure.
+
+To configure them, we use the following format:
+
+`runs-on: ${{ github.repository_owner == 'apache' &&
format('runs-on={0},family=m8a,cpu=16,image=ubuntu24-full-x64,extras=s3-cache,disk=large,tag=datafusion',
github.run_id) || 'ubuntu-latest' }}`
+
+This is a conditional expression that uses Runs-On custom runners for the main
repository and falls back to the standard GitHub runners for forks. Runs-On
configuration follows the [Runs-On
pattern](https://runs-on.com/configuration/job-labels/).
+
+For those actions we also use the [Runs-On
action](https://runs-on.com/caching/magic-cache/#how-to-use), which adds
support for external caching and reports job metrics:
+
+`- uses: runs-on/action@cd2b598b0515d39d78c38a02d529db87d2196d1e`
+
+For the standard GitHub runners, this action will do nothing.
+
+##### Spot Instances
+
+By default, Runs-On actions run as [spot
instances](https://runs-on.com/configuration/spot-instances/), which means they
might occasionally be interrupted. In the CI you would see:
+
+```
+Error: The operation was canceled.
+```
+
+According to Runs-On, spot instance termination is extremely rare for
instances running for less than 1h. Those actions will be restarted
automatically.
+
+#### GitHub Runners
We also use standard GitHub runners for some actions in the main repository;
these are also runnable in forks.
diff --git a/contributor-guide/index.html b/contributor-guide/index.html
index 6d8743fe74..62a763b69d 100644
--- a/contributor-guide/index.html
+++ b/contributor-guide/index.html
@@ -573,10 +573,30 @@ Commenting on the PR will remove the <code
class="docutils literal notranslate">
</section>
<section id="ci-runners">
<h3>CI Runners<a class="headerlink" href="#ci-runners" title="Link to this
heading">#</a></h3>
-<p>We use <a class="reference external"
href="https://runs-on.com/">Runs-On</a> for some actions in the main
repository, which run in the ASF AWS account to speed up CI time. In forks,
these actions run on the default GitHub runners since forks do not have access
to ASF infrastructure.</p>
+<section id="runs-on">
+<h4>Runs-On<a class="headerlink" href="#runs-on" title="Link to this
heading">#</a></h4>
+<p>We use <a class="reference external"
href="https://runs-on.com/">Runs-On</a> for some actions in the main
repository, which run in the ASF AWS account to speed up CI. In forks, these
actions run on the default GitHub runners since forks do not have access to ASF
infrastructure.</p>
+<p>To configure them, we use the following format:</p>
+<p><code class="docutils literal notranslate"><span
class="pre">runs-on:</span> <span class="pre">${{</span> <span
class="pre">github.repository_owner</span> <span class="pre">==</span> <span
class="pre">'apache'</span> <span class="pre">&&</span> <span
class="pre">format('runs-on={0},family=m8a,cpu=16,image=ubuntu24-full-x64,extras=s3-cache,disk=large,tag=datafusion',</span>
<span class="pre">github.run_id)</span> <span class="pre">||</span> <span
class="pre">'ubuntu-latest'</sp [...]
+<p>This is a conditional expression that uses Runs-On custom runners for the
main repository and falls back to the standard GitHub runners for forks.
Runs-On configuration follows the <a class="reference external"
href="https://runs-on.com/configuration/job-labels/">Runs-On pattern</a>.</p>
+<p>For those actions we also use the <a class="reference external"
href="https://runs-on.com/caching/magic-cache/#how-to-use">Runs-On action</a>,
which adds support for external caching and reports job metrics:</p>
+<p><code class="docutils literal notranslate"><span class="pre">-</span> <span
class="pre">uses:</span> <span
class="pre">runs-on/action@cd2b598b0515d39d78c38a02d529db87d2196d1e</span></code></p>
+<p>For the standard GitHub runners, this action will do nothing.</p>
+<section id="spot-instances">
+<h5>Spot Instances<a class="headerlink" href="#spot-instances" title="Link to
this heading">#</a></h5>
+<p>By default, Runs-On actions run as <a class="reference external"
href="https://runs-on.com/configuration/spot-instances/">spot instances</a>,
which means they might occasionally be interrupted. In the CI you would see:</p>
+<div class="highlight-default notranslate"><div
class="highlight"><pre><span></span><span class="n">Error</span><span
class="p">:</span> <span class="n">The</span> <span class="n">operation</span>
<span class="n">was</span> <span class="n">canceled</span><span
class="o">.</span>
+</pre></div>
+</div>
+<p>According to Runs-On, spot instance termination is extremely rare for
instances running for less than 1h. Those actions will be restarted
automatically.</p>
+</section>
+</section>
+<section id="github-runners">
+<h4>GitHub Runners<a class="headerlink" href="#github-runners" title="Link to
this heading">#</a></h4>
<p>We also use standard GitHub runners for some actions in the main
repository; these are also runnable in forks.</p>
</section>
</section>
+</section>
</section>
@@ -645,7 +665,14 @@ Commenting on the PR will remove the <code class="docutils
literal notranslate">
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link"
href="#ai-assisted-contributions">AI-Assisted contributions</a><ul class="nav
section-nav flex-column">
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link"
href="#why-fully-ai-generated-prs-without-understanding-are-not-helpful">Why
fully AI-generated PRs without understanding are not helpful</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link"
href="#better-ways-to-contribute-than-an-ai-dump">Better ways to contribute
than an “AI dump”</a></li>
-<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link"
href="#ci-runners">CI Runners</a></li>
+<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link"
href="#ci-runners">CI Runners</a><ul class="nav section-nav flex-column">
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link"
href="#runs-on">Runs-On</a><ul class="nav section-nav flex-column">
+<li class="toc-h5 nav-item toc-entry"><a class="reference internal nav-link"
href="#spot-instances">Spot Instances</a></li>
+</ul>
+</li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link"
href="#github-runners">GitHub Runners</a></li>
+</ul>
+</li>
</ul>
</li>
</ul>
diff --git a/searchindex.js b/searchindex.js
index 8f4d3320af..aa2fe49e9d 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"!=":[[71,"op-neq"]],"!~":[[71,"op-re-not-match"]],"!~*":[[71,"op-re-not-match-i"]],"!~~":[[71,"id19"]],"!~~*":[[71,"id20"]],"#":[[71,"op-bit-xor"]],"%":[[71,"op-modulo"]],"&":[[71,"op-bit-and"]],"(relation,
name) tuples in logical fields and logical columns are
unique":[[14,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[71,"op-multiply"]],"+":[[71,"op-plus"]],"-":[[71,"op-minus"]],"/":[[71,"op-divide"]],"1.
Array Literal Con [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"!=":[[71,"op-neq"]],"!~":[[71,"op-re-not-match"]],"!~*":[[71,"op-re-not-match-i"]],"!~~":[[71,"id19"]],"!~~*":[[71,"id20"]],"#":[[71,"op-bit-xor"]],"%":[[71,"op-modulo"]],"&":[[71,"op-bit-and"]],"(relation,
name) tuples in logical fields and logical columns are
unique":[[14,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[71,"op-multiply"]],"+":[[71,"op-plus"]],"-":[[71,"op-minus"]],"/":[[71,"op-divide"]],"1.
Array Literal Con [...]
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]