docs icon indicating copy to clipboard operation
docs copied to clipboard

"Reuse Workflows" article should explain how to share files across workflows

Open marcofugaro opened this issue 3 years ago • 8 comments

Code of Conduct

What article on docs.github.com is affected?

https://docs.github.com/en/actions/using-workflows/reusing-workflows

What part(s) of the article would you like to see updated?

In the Overview section, there is a little explaination about reusing workflows and there is this screenshot

image

I want to replicate exactly that. Multiple deploy actions which depends on a single build action in my case.

However, reading the article, I wasn't able to find out how to share files across actions. The article ends with sharing strings only.

I think, since that screenshot has been shown as realistic example, the article needs to contain an explanation on how to share built files across workflows.

Additional information

[maintainer edit] Content plan here

marcofugaro avatar Dec 07 '22 16:12 marcofugaro

@Tomyleexrp

Tomyleexrp avatar Dec 08 '22 09:12 Tomyleexrp

@marcofugaro Thanks so much for opening an issue! I'll triage this for the team to take a look :eyes:

cmwilson21 avatar Dec 08 '22 14:12 cmwilson21

Thanks for opening an issue! We've triaged this issue for technical review by a subject matter expert :eyes:

github-actions[bot] avatar Dec 13 '22 06:12 github-actions[bot]

👋 @marcofugaro, I've flagged this issue for an SME to have a look at.

IIUC, there's no built-in way to share files between different workflows; it's is up to you to manage the artifacts between workflows.

One way, using artifact storage built into GitHub Actions, is to use the upload-artifact action to upload an artifact, and then in a different workflow either use the REST API or a third party action to download that artifact. The GitHub-authored download-artifact action only works for artifacts uploaded in the same workflow.

lucascosti avatar Dec 13 '22 06:12 lucascosti

This is a gentle bump for the docs team that this issue is waiting for technical review.

github-actions[bot] avatar Jan 10 '23 16:01 github-actions[bot]

Thank you @lucascosti, I eventually figured it out.

I noticed there is now an artifacts section in the docs. A mention to that section inside the Reusing workflows article would be enough.

marcofugaro avatar Jan 18 '23 09:01 marcofugaro

Thank you @lucascosti, I eventually figured it out.

Good to hear!

I noticed there is now an artifacts section in the docs. A mention to that section inside the Reusing workflows article would be enough.

Yep, that article has always been there, but it's a good idea to link to it.

We could probably add the link at the bottom of the Using outputs from a reusable workflow section to link there.

Feel free for yourself (or anyone else) to open a PR 🙇‍♂️

lucascosti avatar Jan 23 '23 06:01 lucascosti