Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
50 commits
Select commit Hold shift + click to select a range
95907bb
Create config subfolder structure
lzdanski Feb 27, 2026
6ca9d1f
move execution methods
lzdanski Feb 27, 2026
df0c491
rename to guides
lzdanski Feb 27, 2026
2e0afe7
update hradcoded URLs
lzdanski Feb 27, 2026
a9af323
redistribute files
lzdanski Feb 27, 2026
21ed49e
improve build errors
lzdanski Mar 2, 2026
d49821b
fix index
lzdanski Mar 2, 2026
d34f21b
fix rel-link build errors
lzdanski Mar 2, 2026
60ae0d9
fix typo
lzdanski Mar 2, 2026
7d36d9f
reformat ref structure
lzdanski Mar 2, 2026
6788dbe
restructure
lzdanski Mar 2, 2026
d663aec
Make local exec mode page
lzdanski Mar 2, 2026
00e1e0e
add cosmos-managed venv
lzdanski Mar 2, 2026
a0108e0
Execution mode section refactor
lzdanski Mar 2, 2026
68377ff
🎨 [pre-commit.ci] Auto format from pre-commit.com hooks
pre-commit-ci[bot] Mar 2, 2026
a8737d8
Update docker
lzdanski Mar 2, 2026
6d6828c
add eks
lzdanski Mar 3, 2026
0038103
async mode
lzdanski Mar 3, 2026
798eee7
invocation modes
lzdanski Mar 3, 2026
aa3c90d
kubernetes E.M.
lzdanski Mar 3, 2026
4267440
Local execution mode
lzdanski Mar 3, 2026
cd3bfcc
Azure container instance
lzdanski Mar 3, 2026
ed87bbc
fix filepath
lzdanski Mar 3, 2026
387b4d6
Execution modes restructure
lzdanski Mar 3, 2026
e914a2d
fix formatting
lzdanski Mar 3, 2026
ea4f941
Merge branch 'restructure-get-started-guides' into execution-mode-ove…
lzdanski Mar 3, 2026
66b4afd
Address consistency feedback
lzdanski Mar 3, 2026
01981c3
fix title capitalization
lzdanski Mar 3, 2026
72dfe27
Apply suggestions from code review
lzdanski Mar 4, 2026
cb511ea
Create config subfolder structure
lzdanski Feb 27, 2026
7561367
move execution methods
lzdanski Feb 27, 2026
0851001
rename to guides
lzdanski Feb 27, 2026
0769ac0
update hradcoded URLs
lzdanski Feb 27, 2026
0018a46
redistribute files
lzdanski Feb 27, 2026
d8663b6
improve build errors
lzdanski Mar 2, 2026
554a0dc
fix index
lzdanski Mar 2, 2026
d86e8e9
fix rel-link build errors
lzdanski Mar 2, 2026
461f78a
fix typo
lzdanski Mar 2, 2026
898a5c9
reformat ref structure
lzdanski Mar 2, 2026
6b75ba3
restructure
lzdanski Mar 2, 2026
548df84
🎨 [pre-commit.ci] Auto format from pre-commit.com hooks
pre-commit-ci[bot] Mar 2, 2026
c638c18
fix build errors
lzdanski Mar 3, 2026
426808d
add optimize, execution modes redirects
lzdanski Mar 3, 2026
3a5957b
Apply suggestions from code review
lzdanski Mar 4, 2026
3837e64
🎨 [pre-commit.ci] Auto format from pre-commit.com hooks
pre-commit-ci[bot] Mar 4, 2026
2e48b97
Link and directory fixes
lzdanski Mar 4, 2026
253dbb4
Merge branch 'restructure-get-started-guides' into execution-mode-ove…
lzdanski Mar 4, 2026
ce1a87b
Add troubleshooting section
lzdanski Mar 4, 2026
ca2d06f
Add choose an EM guide
lzdanski Mar 4, 2026
469df2c
Add guide overview landing page
lzdanski Mar 4, 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
Binary file added docs/_static/execution_mode_map.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
22 changes: 22 additions & 0 deletions docs/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -53,3 +53,25 @@
}

generate_mapping_docs()

# -- Begin docs redirect section
# -- To test redirects in a local build, paste the redirect source, and append .html to the end.
# -- For example, "airflow3_compatibility/index" redirect must be tested using "airflow3_compatibility/index.html"
# -- https://documatt.com/sphinx-reredirects/usage/
redirects = {
"configuration/caching": "../optimize_performance/caching.html",
"configuration/memory_optimization": "../optimize_performance/memory_optimization.html",
"configuration/partial-parsing": "../optimize_performance/partial-parsing.html",
"configuration/selecting-excluding": "../optimize_performance/selecting-excluding.html",
"getting_started/async-execution-mode": "../guides/run_dbt/airflow-worker/async-execution-mode.html",
"getting_started/aws-container-run-job": "../guides/run_dbt/airflow-worker/async-execution-mode.html",
"getting_started/azure-container-instance": "../guides/run_dbt/container/azure-container-instance.html",
"getting_started/custom-airflow-properties": "../run_dbt/airflow-worker/custom-airflow-properties.html",
"getting_started/docker": "../guides/run_dbt/container/docker.html",
"getting_started/execution-modes-local-conflicts": "../reference/troubleshooting/execution-modes-local-conflicts.html",
"getting_started/gcp-cloud-run-job": "../guides/run_dbt/container/gcp-cloud-run-job.html",
"getting_started/kubernetes": "../guides/run_dbt/container/kubernetes.html",
"getting_started/operators": "../guides/run_dbt/operators/operators.html",
"getting_started/watcher-execution-mode": "../guides/run_dbt/airflow-worker/watcher-execution-mode.html",
"getting_started/watcher-kubernetes-execution-mode": "../guides/run_dbt/container/watcher-kubernetes-execution-mode.html",
}
36 changes: 0 additions & 36 deletions docs/configuration/index.rst

This file was deleted.

4 changes: 3 additions & 1 deletion docs/contributing.rst
Original file line number Diff line number Diff line change
Expand Up @@ -155,17 +155,19 @@ To run the checks manually, run:
Writing Docs
____________

`Hatch <https://hatch.pypa.io/latest/>`_ is a unified command-line tool for managing dependencies and environment isolation for Python developers. In Cosmos, we use a Hatchto declare the dependencies required for the project itself, as well as for tests and documentation builds.
`Hatch <https://hatch.pypa.io/latest/>`_ is a unified command-line tool for managing dependencies and environment isolation for Python developers. In Cosmos, we use a Hatch to declare the dependencies required for the project itself, as well as for tests and documentation builds.

If you don’t already have Hatch installed, please `install it <https://hatch.pypa.io/latest/install/>`_ before proceeding. As an example, on macOS, you can do so with:

.. code-block:: bash

brew install hatch


You can run the docs locally by running the following:

.. code-block:: bash

hatch run docs:serve


Expand Down
4 changes: 2 additions & 2 deletions docs/getting_started/astro.rst
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
.. _astro:

Getting Started on Astro
========================
Getting Started with Cosmos on Astro
====================================

While it is possible to use Cosmos on Astro with all :ref:`Execution Modes <execution-modes>`, we recommend using the ``local`` execution mode. It's the simplest to set up and use.

Expand Down
4 changes: 2 additions & 2 deletions docs/getting_started/dbt-airflow-concepts.rst
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
.. _dbt-airflow-concepts:

Similar dbt & Airflow concepts
==============================
Similar dbt and Airflow concepts
================================

While dbt is an open source tool for data transformations and analysis, using SQL, Airflow focuses on being a platform
for the development, scheduling and monitoring of batch-oriented workflows, using Python. Although both tools have many
Expand Down
111 changes: 0 additions & 111 deletions docs/getting_started/docker.rst

This file was deleted.

Loading