Skip to content

Update docs on using concurrency to auto-cancel redundant jobs / runs - #11244

Merged
skedwards88 merged 11 commits into
github:mainfrom
mnquintana:mnquintana/concurrency
Jan 13, 2022
Merged

Update docs on using concurrency to auto-cancel redundant jobs / runs#11244
skedwards88 merged 11 commits into
github:mainfrom
mnquintana:mnquintana/concurrency

Conversation

@mnquintana

Copy link
Copy Markdown
Contributor

Why:

Closes#11243

This PR updates the docs on using concurrency to cancel in-progress jobs / runs to provide examples that scope this behavior to a workflow. The new examples should make it possible for users to approximate the behavior other CI providers give you out of the box for auto-canceling redundant jobs / runs on a PR, without running into all the pitfalls I did that resulted in a long GitHub Support thread. 😅

Reference

To reference the behavior other CI providers document:

What's being changed:

Check off the following:

  • I have reviewed my changes in staging (look for the latest deployment event in your pull request's timeline, then click View deployment).
  • For content changes, I have completed the self-review checklist.

Writer impact (This section is for GitHub staff members only):

  • This pull request impacts the contribution experience
    • I have added the 'writer impact' label
    • I have added a description and/or a video demo of the changes below (e.g. a "before and after video")

@welcome

welcomeBot commented Oct 17, 2021

Copy link
Copy Markdown

Thanks for opening this pull request! A GitHub docs team member should be by to give feedback soon. In the meantime, please check out the contributing guidelines.

{% raw %}
```yaml
concurrency:
group: ${{github.workflow}}-${{ github.head_ref }}

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is github.workflow guaranteed to be unique in a repository with multiple workflows? I wasn't 100% sure from looking at the context docs.

@Choghi
This comment has been minimized.
@Choghi

Copy link
Copy Markdown

Thanks

@ramyaparimiramyaparimi added content This issue or pull request belongs to the Docs Content team hacktoberfest-accepted We might not merge this PR before Nov 1st, but it's a wonderful Hacktoberfest contribution! needs content strategy Wait to open a PR until there's an approved content strategy in the issue labels Oct 18, 2021
@ramyaparimi

Copy link
Copy Markdown
Contributor

@mnquintana
Thanks so much for opening a PR! I'll get this triaged for review ⚡

@lee-dohm

Copy link
Copy Markdown
Contributor

👋 Good to see you again @mnquintana. Thanks so much for the detailed and well-thought-out PR 🙇‍♂️

@mnquintana

Copy link
Copy Markdown
ContributorAuthor

Hey good to see you too @lee-dohm! Thanks so much for giving this a look 🙇🏽

@mnquintana

mnquintana commented Oct 19, 2021

Copy link
Copy Markdown
ContributorAuthor

Hmmm looks like the deploy is failing – not sure if that's something I did or if a maintainer just needs to re-run the workflow

@ramyaparimi

ramyaparimi commented Oct 19, 2021

Copy link
Copy Markdown
Contributor

@mnquintana Thank you for the message!! Definitely nothing you did 💖 The staging build and deploy workflows are temporarily disabled 💛

@github-actions

Copy link
Copy Markdown
Contributor

A stale label has been added to this pull request because it has been open 7 days with no activity. To keep this PR open, add a comment or push a commit within 3 days.

@github-actionsgithub-actionsBot added the stale There is no recent activity on this issue or pull request label Oct 27, 2021
@mnquintana

Copy link
Copy Markdown
ContributorAuthor

Adding a comment to keep the stale bot at bay 👀

@ramyaparimiramyaparimi added waiting for review Issue/PR is waiting for a writer's review and removed stale There is no recent activity on this issue or pull request needs content strategy Wait to open a PR until there's an approved content strategy in the issue labels Oct 28, 2021
@mnquintana

mnquintana commented Nov 8, 2021

Copy link
Copy Markdown
ContributorAuthor

@ramyaparimi@lee-dohm 👋🏽 Just checking in – any updates on a review for this one? 🙇🏽

@lee-dohm

Copy link
Copy Markdown
Contributor

My apologies @mnquintana! Between Universe and my being on vacation last week, this fell behind. I'll get it in front of the right people and get back to you!

@martin389martin389 assigned martin389 and unassigned martin389Nov 10, 2021
@martin389

Copy link
Copy Markdown
Contributor

Thanks for this PR! I'm working on getting this reviewed now 👍

@mnquintana

Copy link
Copy Markdown
ContributorAuthor

@martin389 👋🏽 Just checking in – any updates on getting this PR reviewed? 🙇🏽

@martin389

Copy link
Copy Markdown
Contributor

Status update: I've found someone who can review this work, and its now in their queue 👍

@mnquintana

Copy link
Copy Markdown
ContributorAuthor

@martin389 👋🏽 Just checking in again - any chance of getting this PR reviewed this week? 🙇🏽

@martin389

Copy link
Copy Markdown
Contributor

Status update: Following up with reviewers 👀

@martin389

Copy link
Copy Markdown
Contributor

Unassigning myself so that the tech reviewer can take this.

@martin389martin389 removed their assignment Dec 16, 2021
@mnquintana

mnquintana commented Jan 12, 2022

Copy link
Copy Markdown
ContributorAuthor

Happy New Year! Are there any plans to ever review this PR? 3 months for a content review seems a bit extreme.

@ramyaparimi

Copy link
Copy Markdown
Contributor

@mnquintana You’re absolutely right. I apologize for how long this has taken, three months is completely out of line with our expectations for ourselves. We appreciate the patience and understanding you’ve shown thus far. I’m going to talk to the team and find out how we can get this resolved as soon as possible.
Stay tuned!

@ramyaparimiramyaparimi added the actions This issue or pull request should be reviewed by the docs actions team label Jan 13, 2022

@skedwards88skedwards88 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This PR adds great examples! Thank you for taking the time to share your knowledge (and thank you for your patience waiting for a review). I made some suggestions that I will go ahead and incorporate, then I'll get this merged down for you.

Comment threaddata/reusables/actions/actions-group-concurrency.md Outdated
Comment threaddata/reusables/actions/actions-group-concurrency.md Outdated
Comment threaddata/reusables/actions/actions-group-concurrency.md Outdated
Comment threaddata/reusables/actions/actions-group-concurrency.md Outdated
Comment threaddata/reusables/actions/actions-group-concurrency.md Outdated
Comment threaddata/reusables/actions/actions-group-concurrency.md Outdated
Comment threaddata/reusables/actions/actions-group-concurrency.md Outdated
Comment threaddata/reusables/actions/actions-group-concurrency.md Outdated
skedwards88
skedwards88 previously approved these changes Jan 13, 2022
@skedwards88skedwards88 added the ready to merge This pull request is ready to merge label Jan 13, 2022
@skedwards88
skedwards88 enabled auto-merge (squash) January 13, 2022 19:35
@skedwards88
skedwards88 merged commit 7ae281c into github:mainJan 13, 2022
@github-actions

Copy link
Copy Markdown
Contributor

Thanks very much for contributing! Your pull request has been merged 🎉 You should see your changes appear on the site in approximately 24 hours. If you're looking for your next contribution, check out our help wanted issues

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

actionsThis issue or pull request should be reviewed by the docs actions teamcontentThis issue or pull request belongs to the Docs Content teamhacktoberfest-acceptedWe might not merge this PR before Nov 1st, but it's a wonderful Hacktoberfest contribution!ready to mergeThis pull request is ready to mergewaiting for reviewIssue/PR is waiting for a writer's review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

GitHub Actions: Examples for canceling in-progress jobs / runs with concurrency groups lead to confusing behavior

7 participants

@mnquintana@Choghi@ramyaparimi@lee-dohm@martin389@skedwards88@docubot