Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Write blog post dbt docs in Airflow with Cosmos #1139

Open
1 task
tatiana opened this issue Aug 1, 2024 · 1 comment
Open
1 task

Write blog post dbt docs in Airflow with Cosmos #1139

tatiana opened this issue Aug 1, 2024 · 1 comment
Labels
area:docs Relating to documentation, changes, fixes, improvement dbt:docs Primarily related to dbt docs command or functionality execution:local Related to Local execution environment

Comments

@tatiana
Copy link
Collaborator

tatiana commented Aug 1, 2024

Context

Many people from the community need to realise Cosmos can host dbt docs, as implemented by @dwreeves in #737.

The goal of this blog post is to give visibility to this feature. Check with @dwreeves if he'd like to author or co-author this.

Some possible topics that could be covered:

Acceptance criteria

  • Publish the blog post
@dosubot dosubot bot added area:docs Relating to documentation, changes, fixes, improvement dbt:docs Primarily related to dbt docs command or functionality execution:local Related to Local execution environment labels Aug 1, 2024
tatiana pushed a commit that referenced this issue Oct 11, 2024
…#1250)

## Description

[ dbt_docs_dir is None ] directly triggers the [
dbt_docs_net_set_up.html ] page via the cosmos plugin. I had a hard time
figuring out why my dbt docs weren't hosting properly considering I had
(incorrectly) tried setting up the dbt_docs_dir variable via the Airflow
UI. Once I added the environment variable to my Dockerfile, the dbt Docs
showed correctly in the airflow UI. I had to inspect the source code for
the plugin to find out that cosmos was not correctly seeing the
environment variables I had set up.

Adding a note that the "dbt_docs_dir was not found" would make this
error page much more helpful from a debugging standpoint for me.

## Related Issue(s)

Related to #1245: Make it easier for end-users to create a DAG for
creating/hosting dbt docs
Related to #1139: Write blog post dbt docs in Airflow with Cosmos 

## Breaking Change?

This is my first time creating a PR on a public github, but I think this
is as low impact as you can get :)

## Checklist

- [NA ] I have made corresponding changes to the documentation (if
required)
- [ ] I have added tests that prove my fix is effective or that my
feature works

I don't know how to test this :( Just trying to save others some time if
they have the same problem I had with correctly hosting dbt docs.
Copy link

dosubot bot commented Oct 31, 2024

Hi, @tatiana. I'm helping the Cosmos team manage their backlog and am marking this issue as stale.

You've proposed writing a blog post about how Cosmos can host dbt docs, inspired by @dwreeves' recent implementation. This post aims to enhance visibility on this feature and may cover topics like selecting an object store and the process of generating and hosting dbt docs in the Airflow UI. The main acceptance criterion is the publication of the blog post.

Could you please let us know if this issue is still relevant to the latest version of the Cosmos repository? If it is, feel free to comment here to keep it open. Otherwise, you can close the issue yourself, or it will be automatically closed in 7 days. Thank you!

@dosubot dosubot bot added the stale Issue has not had recent activity or appears to be solved. Stale issues will be automatically closed label Oct 31, 2024
@dosubot dosubot bot closed this as not planned Won't fix, can't repro, duplicate, stale Nov 7, 2024
@dosubot dosubot bot removed the stale Issue has not had recent activity or appears to be solved. Stale issues will be automatically closed label Nov 7, 2024
@tatiana tatiana reopened this Nov 13, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area:docs Relating to documentation, changes, fixes, improvement dbt:docs Primarily related to dbt docs command or functionality execution:local Related to Local execution environment
Projects
None yet
Development

No branches or pull requests

1 participant