-
Notifications
You must be signed in to change notification settings - Fork 28
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
Aklite v95 changes #802
Aklite v95 changes #802
Conversation
After the introduction of `check` command in aktualizr-lite command line interface, the list command no longer updates the TUF metadata. So, the check command should be used when verifying in the device that a new target was added to the factory. Signed-off-by: Andre Detsch <[email protected]>
Signed-off-by: Andre Detsch <[email protected]>
Signed-off-by: Andre Detsch <[email protected]>
@mike-sul to avoid delaying the required changes, I've not added a change on how we document the CLI exit codes yet, as I'm not very satisfied with the current solutions I have. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
lgtm, let's also add an entry to this page: https://docs.foundries.io/latest/reference-manual/ota/update-rollback.html#update-rollback
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM, minor suggestions
@@ -211,22 +221,32 @@ It yields an error if the specified Target has not been pulled before, and also | |||
It is necessary to verify the return codes for each command to guarantee the correct update process flow, | |||
as detailed in the next section. | |||
|
|||
Rollback to previous working version |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Rollback to previous working version | |
Rollback to Previous Working Version |
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
|
||
.. warning:: The rollback command is in beta stage, | ||
and is subject to change over the following releases. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
and is subject to change over the following releases. | |
and is subject to change. |
Optional suggestion.
.. warning:: The rollback command is in beta stage, | ||
and is subject to change over the following releases. | ||
|
||
The ``rollback`` command can be used to abort the current installation and revert the system to the previous successfully installed target. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The ``rollback`` command can be used to abort the current installation and revert the system to the previous successfully installed target. | |
The ``rollback`` command can be used to abort the current installation and revert the system to the previous successfully installed Target. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've also changed abort
to cancel
The ``rollback`` command can be used to abort the current installation and revert the system to the previous successfully installed target. | ||
No download operation is done in that case. | ||
|
||
If there is no installation being done, the current running target is marked as failing, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
If there is no installation being done, the current running target is marked as failing, | |
If there is no installation being done, the current running Target is marked as failing. |
No download operation is done in that case. | ||
|
||
If there is no installation being done, the current running target is marked as failing, | ||
to avoid having it automatically installed again, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
to avoid having it automatically installed again, | |
This avoids having it automatically installed again, |
|
||
If there is no installation being done, the current running target is marked as failing, | ||
to avoid having it automatically installed again, | ||
and an installation of the previous successful target is performed. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
and an installation of the previous successful target is performed. | |
and an installation of the previous successful Target is performed. |
and an installation of the previous successful target is performed. | ||
In that situation, the installation is preceded by a download (pull) operation. | ||
|
||
Like in a regular installation, the exit code can be used to identify if a reboot is required in order to finalize the rollback. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Like in a regular installation, the exit code can be used to identify if a reboot is required in order to finalize the rollback. | |
Like in a regular installation, the exit code can be used to identify if a reboot is required in to finalize the rollback. |
Signed-off-by: Andre Detsch <[email protected]>
44424d4
to
1c741ea
Compare
@kprosise I've accepted your suggestions, thanks. I thought about adding another commit to the current PR, adding an additional section, but I may leave it for another PR. |
@detsch shall I go ahead and merge? |
@kprosise yes, please. I'll deal with @vanmaegima's suggestion in another PR
|
PR Template and Checklist
Please complete as much as possible to speed up the reviewing process.
Readiness and adding reviewers as appropriate is required.
All PRs should be reviewed by a technical writer/documentation team and a peer.
If effecting customers—which is a majority of content changes—a member of Customer Success must also review.
Readiness
Overview
Update aktualizr-lite CLI information considering improvements made for v95
Checklist
make linkcheck
.-s, --signoff
).-S, --gpg-sign
).Comments
Any thing else that a maintainer/reviewer should know.
This could include potential issues, rational for approach, etc.