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

Feature: Golden Versions #24055

Merged
merged 5 commits into from
Sep 25, 2024
Merged

Feature: Golden Versions #24055

merged 5 commits into from
Sep 25, 2024

Conversation

philrenaud
Copy link
Contributor

@philrenaud philrenaud commented Sep 24, 2024

Introduces the ability to tag/pin a version of a job, in order to:

  • prevent it from being garbage-collected, and
  • allow future comparisons/diffs and reverts by name (ex: nomad job revert myJob someVersion )

Includes new CLI commands (nomad job history -diff-version, nomad job tag apply, nomad job tag unset) and a new endpoint (POST/PUT and DELETE to v1/job/$jobName/versions/$tagName), plus new diff and CRUD in the web UI:

image

Resolves #23794

@philrenaud philrenaud self-assigned this Sep 24, 2024
@philrenaud philrenaud linked an issue Sep 24, 2024 that may be closed by this pull request
21 tasks
* TaggedVersion information in structs, rather than job_endpoint

* Test for taggedVersion description length

* Some API plumbing
* Tag and Untag at API level on down, but am I unblocking the wrong thing?

* Code and comment cleanup

* Unset methods generally now I stare long into the namespace abyss

* Namespace passes through with QueryOptions removed from a write requesting struct

* Comment and PR review cleanup

* Version back to VersionStr

* Generally consolidate unset logic into apply for version tagging

* Addressed some PR comments

* Auth check and RPC forwarding

* uint64 instead of pointer for job version after api layer and renamed copy

* job tag command split into apply and unset

* latest-version convenience handling moved to CLI command level

* CLI tests for tagging/untagging

* UI parts removed

* Add to job table when unsetting job tag on latest version

* Vestigial no more

* Compare versions by name and version number with the nomad history command (#23889)

* First pass at passing a tagname and/or diff version to plan/versions requests

* versions API now takes compare_to flags

* Job history command output can have tag names and descriptions

* compare_to to diff-tag and diff-version, plus adding flags to history command

* 0th version now shows a diff if a specific diff target is requested

* Addressing some PR comments

* Simplify the diff-appending part of jobVersions and hide None-type diffs from CLI

* Remove the diff-tag and diff-version parts of nomad job plan, with an eye toward making them a new top-level CLI command soon

* Version diff tests

* re-implement JobVersionByTagName

* Test mods and simplification

* Documentation for nomad job history additions

* Prevent pruning and reaping of TaggedVersion jobs (#23983)

tagged versions should not count against JobTrackedVersions
i.e. new job versions being inserted should not evict tagged versions

and GC should not delete a job if any of its versions are tagged

Co-authored-by: Daniel Bennett <[email protected]>

---------

Co-authored-by: Daniel Bennett <[email protected]>

* [ui] Version Tags on the job versions page (#24013)

* Timeline styles and their buttons modernized, and tags added

* styled but not yet functional version blocks

* Rough pass at edit/unedit UX

* Styles consolidated

* better UX around version tag crud, plus adapter and serializers

* Mirage and acceptance tests

* Modify percy to not show time-based things

---------

Co-authored-by: Daniel Bennett <[email protected]>
Copy link

github-actions bot commented Sep 25, 2024

Ember Test Audit comparison

main a750d71 change
passes 1578 1581 +3
failures 0 0 0
flaky 0 0 0
duration 11m 41s 596ms 11m 41s 279ms -317ms

#24059)

* Job revert command and API endpoint can take a string version tag name

* RevertOpts as a signature-modified alternative to Revert()

* job revert CLI test

* Version pointers in endpoint tests

* Dont copy over the tag when a job is reverted to a version with a tag

* Convert tag name to version number at CLI level

* Client method for version lookup by tag

* No longer double-declaring client
Copy link
Member

@tgross tgross left a comment

Choose a reason for hiding this comment

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

All PRs previously reviewed. CI is green. :shipit: !

* Rough pass at the UI for version diff dropdown

* Cleanup and diff fetching via adapter method
Copy link
Member

@gulducat gulducat left a comment

Choose a reason for hiding this comment

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

🤘

@philrenaud philrenaud merged commit e206993 into main Sep 25, 2024
38 checks passed
@philrenaud philrenaud deleted the epic/23794-golden-versions branch September 25, 2024 23:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

☂️ Golden Versions
3 participants