[Agent] Manual rollback for agent upgrades#4918
[Agent] Manual rollback for agent upgrades#4918karenzone wants to merge 6 commits intoelastic:mainfrom
Conversation
✅ Vale Linting ResultsNo issues found on modified lines! The Vale linter checks documentation changes against the Elastic Docs style guide. To use Vale locally or report issues, refer to Elastic style guide for Vale. |
🔍 Preview links for changed docs |
|
cc:/ @pchila @jillguyonnet @nimarezainia, your early comments are welcome. |
|
@karenzone the content looks good to me. Could the "Roll back an Elastic Agent upgrade for Fleet Managed agents" section have a larger font size so it's at the same hierarchical level as "Update RPM and DEB system packages" - currently it feels as though it's part of the RPM and DEB section. |
pchila
left a comment
There was a problem hiding this comment.
Left a couple of suggestion (minor rewording which makes the content clearer, I hope)
Left a question about the Fleet API endpoint to use in order to rollback a single agent since it doesn't look right to me.
Co-authored-by: Paolo Chilà <paolo.chila@elastic.co>
86792c2 to
acf74e8
Compare
jillguyonnet
left a comment
There was a problem hiding this comment.
LGTM overall, left a couple of small comments.
| :Call `POST /api/fleet/agents/{agentID}/rollback`. | ||
|
|
||
| To roll back multiple agents: | ||
| :Call `POST /api/fleet/agents/bulk_rollback`. |
There was a problem hiding this comment.
Do we already have links to the API reference? Probably not a huge deal if not in this case since there are no options, but bulk endpoints expect agents in the request body (either a list of agent ids or a query string, see e.g. bulk migrate), making that explicit could be helpful.
There was a problem hiding this comment.
If I'm reading this correctly, you are asking if we have documented rollbacks in the API docs. We have not. If that's what you are suggesting, we can open an issue for follow up.
Summary
Adds docs for Manual rollback for agent upgrades.
If a user upgrades an agent running v9.3.0 or later, they have the option to roll back to the previously installed version for seven days.
Fixes: elastic/elastic-agent#11536
Generative AI disclosure
- Yes (content refinement)
- No
Copilot (Claude Sonnet 4.5)