This is an automated email from the ASF dual-hosted git repository.
potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow-site.git
The following commit(s) were added to refs/heads/main by this push:
new ea36c14507 Fix verison replacement bug in 3.0.0 docs (#1170)
ea36c14507 is described below
commit ea36c14507f0cbe347f359b16849f01128220d0d
Author: Jarek Potiuk <[email protected]>
AuthorDate: Wed Apr 23 19:01:45 2025 +0200
Fix verison replacement bug in 3.0.0 docs (#1170)
---
.../apache-airflow/3.0.0/docker-compose.yaml | 4 ++--
.../3.0.0/howto/docker-compose/index.html | 4 ++--
.../3.0.0/installation/installing-from-pypi.html | 22 +++++++++++-----------
3 files changed, 15 insertions(+), 15 deletions(-)
diff --git a/docs-archive/apache-airflow/3.0.0/docker-compose.yaml
b/docs-archive/apache-airflow/3.0.0/docker-compose.yaml
index cb99c6085d..ed8f2ac19e 100644
--- a/docs-archive/apache-airflow/3.0.0/docker-compose.yaml
+++ b/docs-archive/apache-airflow/3.0.0/docker-compose.yaml
@@ -24,7 +24,7 @@
# The following variables are supported:
#
# AIRFLOW_IMAGE_NAME - Docker image name used to run Airflow.
-# Default: apache/airflow:|version|
+# Default: apache/airflow:3.0.0
# AIRFLOW_UID - User ID in Airflow containers
# Default: 50000
# AIRFLOW_PROJ_DIR - Base path to which all the files will be
volumed.
@@ -49,7 +49,7 @@ x-airflow-common:
# In order to add custom dependencies or upgrade provider distributions you
can use your extended image.
# Comment the image line, place your Dockerfile in the directory where you
placed the docker-compose.yaml
# and uncomment the "build" line below, Then run `docker-compose build` to
build the images.
- image: ${AIRFLOW_IMAGE_NAME:-apache/airflow:|version|}
+ image: ${AIRFLOW_IMAGE_NAME:-apache/airflow:3.0.0}
# build: .
environment:
&airflow-common-env
diff --git a/docs-archive/apache-airflow/3.0.0/howto/docker-compose/index.html
b/docs-archive/apache-airflow/3.0.0/howto/docker-compose/index.html
index d90ced7851..05fbee7381 100644
--- a/docs-archive/apache-airflow/3.0.0/howto/docker-compose/index.html
+++ b/docs-archive/apache-airflow/3.0.0/howto/docker-compose/index.html
@@ -989,14 +989,14 @@ you should do those steps:</p>
<code class="docutils literal notranslate"><span
class="pre">docker-compose.yaml</span></code> file. The relevant part of the
docker-compose file of yours should look similar
to (use correct image tag):</p></li>
</ol>
-<div class="highlight-docker notranslate"><div
class="highlight"><pre><span></span><span class="c">#image:
${AIRFLOW_IMAGE_NAME:-apache/airflow:|version|}</span>
+<div class="highlight-docker notranslate"><div
class="highlight"><pre><span></span><span class="c">#image:
${AIRFLOW_IMAGE_NAME:-apache/airflow:3.0.0}</span>
build:<span class="w"> </span>.
</pre></div>
</div>
<ol class="arabic simple" start="2">
<li><p>Create <code class="docutils literal notranslate"><span
class="pre">Dockerfile</span></code> in the same folder your <code
class="docutils literal notranslate"><span
class="pre">docker-compose.yaml</span></code> file is with content similar
to:</p></li>
</ol>
-<div class="highlight-docker notranslate"><div
class="highlight"><pre><span></span><span class="k">FROM</span><span class="w">
</span><span class="s">apache/airflow:|version|</span>
+<div class="highlight-docker notranslate"><div
class="highlight"><pre><span></span><span class="k">FROM</span><span class="w">
</span><span class="s">apache/airflow:3.0.0</span>
<span class="k">ADD</span><span class="w"> </span>requirements.txt<span
class="w"> </span>.
<span class="k">RUN</span><span class="w"> </span>pip<span class="w">
</span>install<span class="w"> </span>apache-airflow<span
class="o">==</span><span class="si">${</span><span
class="nv">AIRFLOW_VERSION</span><span class="si">}</span><span class="w">
</span>-r<span class="w"> </span>requirements.txt
</pre></div>
diff --git
a/docs-archive/apache-airflow/3.0.0/installation/installing-from-pypi.html
b/docs-archive/apache-airflow/3.0.0/installation/installing-from-pypi.html
index c7fd66ad91..8eff9653ee 100644
--- a/docs-archive/apache-airflow/3.0.0/installation/installing-from-pypi.html
+++ b/docs-archive/apache-airflow/3.0.0/installation/installing-from-pypi.html
@@ -732,7 +732,7 @@ using those tools you should use the constraints and
convert them to appropriate
format and workflow that your tool requires.</p>
</div>
<p>Typical command to install Airflow from scratch in a reproducible way from
PyPI looks like below:</p>
-<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>pip<span class="w"> </span>install<span
class="w"> </span><span
class="s2">"apache-airflow[celery]==|version|"</span><span class="w">
</span>--constraint<span class="w"> </span><span
class="s2">"https://raw.githubusercontent.com/apache/airflow/constraints-|version|/constraints-3.9.txt"</span>
+<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>pip<span class="w"> </span>install<span
class="w"> </span><span
class="s2">"apache-airflow[celery]==3.0.0"</span><span class="w">
</span>--constraint<span class="w"> </span><span
class="s2">"https://raw.githubusercontent.com/apache/airflow/constraints-3.0.0/constraints-3.9.txt"</span>
</pre></div>
</div>
<p>Typically, you can add other dependencies and providers as separate command
after the reproducible
@@ -740,7 +740,7 @@ installation - this way you can upgrade or downgrade the
dependencies as you see
constraints. Good practice for those is to extend such <code class="docutils
literal notranslate"><span class="pre">pip</span> <span
class="pre">install</span></code> command with the <code class="docutils
literal notranslate"><span class="pre">apache-airflow</span></code>
pinned to the version you have already installed to make sure it is not
accidentally
upgraded or downgraded by <code class="docutils literal notranslate"><span
class="pre">pip</span></code>.</p>
-<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>pip<span class="w"> </span>install<span
class="w"> </span><span
class="s2">"apache-airflow==|version|"</span><span class="w">
</span>apache-airflow-providers-google<span class="o">==</span><span
class="m">10</span>.1.0
+<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>pip<span class="w"> </span>install<span
class="w"> </span><span
class="s2">"apache-airflow==3.0.0"</span><span class="w">
</span>apache-airflow-providers-google<span class="o">==</span><span
class="m">10</span>.1.0
</pre></div>
</div>
<p>Those are just examples, see further for more explanation why those are the
best practices.</p>
@@ -787,7 +787,7 @@ constraints file for each version of Python that Airflow
supports.</p>
</ul>
<p>The examples below assume that you want to use install Airflow in a
reproducible way with the <code class="docutils literal notranslate"><span
class="pre">celery</span></code> extra,
but you can pick your own set of extras and providers to install.</p>
-<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>pip<span class="w"> </span>install<span
class="w"> </span><span
class="s2">"apache-airflow[celery]==|version|"</span><span class="w">
</span>--constraint<span class="w"> </span><span
class="s2">"https://raw.githubusercontent.com/apache/airflow/constraints-|version|/constraints-3.9.txt"</span>
+<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>pip<span class="w"> </span>install<span
class="w"> </span><span
class="s2">"apache-airflow[celery]==3.0.0"</span><span class="w">
</span>--constraint<span class="w"> </span><span
class="s2">"https://raw.githubusercontent.com/apache/airflow/constraints-3.0.0/constraints-3.9.txt"</span>
</pre></div>
</div>
<div class="admonition note">
@@ -812,14 +812,14 @@ reasons. Installing such dependencies should be done
without constraints as a se
packages to install and pin it to the version that you have, otherwise you
might end up with a
different version of Airflow than you expect because <code class="docutils
literal notranslate"><span class="pre">pip</span></code> can upgrade/downgrade
it automatically when
performing dependency resolution.</p>
-<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>pip<span class="w"> </span>install<span
class="w"> </span><span
class="s2">"apache-airflow[celery]==|version|"</span><span class="w">
</span>--constraint<span class="w"> </span><span
class="s2">"https://raw.githubusercontent.com/apache/airflow/constraints-|version|/constraints-3.9.txt"</span>
-pip<span class="w"> </span>install<span class="w"> </span><span
class="s2">"apache-airflow==|version|"</span><span class="w">
</span>apache-airflow-providers-google<span class="o">==</span><span
class="m">10</span>.1.1
+<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>pip<span class="w"> </span>install<span
class="w"> </span><span
class="s2">"apache-airflow[celery]==3.0.0"</span><span class="w">
</span>--constraint<span class="w"> </span><span
class="s2">"https://raw.githubusercontent.com/apache/airflow/constraints-3.0.0/constraints-3.9.txt"</span>
+pip<span class="w"> </span>install<span class="w"> </span><span
class="s2">"apache-airflow==3.0.0"</span><span class="w">
</span>apache-airflow-providers-google<span class="o">==</span><span
class="m">10</span>.1.1
</pre></div>
</div>
<p>You can also downgrade or upgrade other dependencies this way - even if
they are not compatible with
those dependencies that are stored in the original constraints file:</p>
-<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>pip<span class="w"> </span>install<span
class="w"> </span><span
class="s2">"apache-airflow[celery]==|version|"</span><span class="w">
</span>--constraint<span class="w"> </span><span
class="s2">"https://raw.githubusercontent.com/apache/airflow/constraints-|version|/constraints-3.9.txt"</span>
-pip<span class="w"> </span>install<span class="w"> </span><span
class="s2">"apache-airflow[celery]==|version|"</span><span class="w">
</span>dbt-core<span class="o">==</span><span class="m">0</span>.20.0
+<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>pip<span class="w"> </span>install<span
class="w"> </span><span
class="s2">"apache-airflow[celery]==3.0.0"</span><span class="w">
</span>--constraint<span class="w"> </span><span
class="s2">"https://raw.githubusercontent.com/apache/airflow/constraints-3.0.0/constraints-3.9.txt"</span>
+pip<span class="w"> </span>install<span class="w"> </span><span
class="s2">"apache-airflow[celery]==3.0.0"</span><span class="w">
</span>dbt-core<span class="o">==</span><span class="m">0</span>.20.0
</pre></div>
</div>
<div class="admonition warning">
@@ -852,14 +852,14 @@ conflicting dependencies in your environment.</p>
to continue being able to keep reproducible installation of Airflow and those
dependencies via a single command.
In order to do that, you can produce your own constraints file and use it to
install Airflow instead of the
one provided by the community.</p>
-<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>pip<span class="w"> </span>install<span
class="w"> </span><span
class="s2">"apache-airflow[celery]==|version|"</span><span class="w">
</span>--constraint<span class="w"> </span><span
class="s2">"https://raw.githubusercontent.com/apache/airflow/constraints-|version|/constraints-3.9.txt"</span>
-pip<span class="w"> </span>install<span class="w"> </span><span
class="s2">"apache-airflow==|version|"</span><span class="w">
</span>dbt-core<span class="o">==</span><span class="m">0</span>.20.0
+<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>pip<span class="w"> </span>install<span
class="w"> </span><span
class="s2">"apache-airflow[celery]==3.0.0"</span><span class="w">
</span>--constraint<span class="w"> </span><span
class="s2">"https://raw.githubusercontent.com/apache/airflow/constraints-3.0.0/constraints-3.9.txt"</span>
+pip<span class="w"> </span>install<span class="w"> </span><span
class="s2">"apache-airflow==3.0.0"</span><span class="w">
</span>dbt-core<span class="o">==</span><span class="m">0</span>.20.0
pip<span class="w"> </span>freeze<span class="w"> </span>><span class="w">
</span>my-constraints.txt
</pre></div>
</div>
<p>Then you can use it to create reproducible installations of your
environment in a single operation via
a local constraints file:</p>
-<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>pip<span class="w"> </span>install<span
class="w"> </span><span
class="s2">"apache-airflow[celery]==|version|"</span><span class="w">
</span>--constraint<span class="w"> </span><span
class="s2">"my-constraints.txt"</span>
+<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>pip<span class="w"> </span>install<span
class="w"> </span><span
class="s2">"apache-airflow[celery]==3.0.0"</span><span class="w">
</span>--constraint<span class="w"> </span><span
class="s2">"my-constraints.txt"</span>
</pre></div>
</div>
<p>Similarly as in the case of Airflow original constraints, you can also host
your constraints at your own
@@ -926,7 +926,7 @@ Constraints are only effective during the <code
class="docutils literal notransl
original image. This way you can be sure that <code class="docutils literal
notranslate"><span class="pre">pip</span></code> will not try to downgrade or
upgrade apache
Airflow while installing other requirements, which might happen in case you
try to add a dependency
that conflicts with the version of apache-airflow that you are using:</p>
-<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>pip<span class="w"> </span>install<span
class="w"> </span><span
class="s2">"apache-airflow==|version|"</span><span class="w">
</span><span
class="s2">"apache-airflow-providers-google==8.0.0"</span>
+<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>pip<span class="w"> </span>install<span
class="w"> </span><span
class="s2">"apache-airflow==3.0.0"</span><span class="w">
</span><span
class="s2">"apache-airflow-providers-google==8.0.0"</span>
</pre></div>
</div>
<div class="admonition note">
