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

Aklite v95 changes #802

Merged
merged 4 commits into from
Feb 20, 2025
Merged

Conversation

detsch
Copy link
Member

@detsch detsch commented Feb 18, 2025

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

  • Merge (pending reviews)
  • Merge after date or event
  • Draft

Overview

Update aktualizr-lite CLI information considering improvements made for v95

Checklist

  • Run spelling and grammar check, preferably with linter.
  • Avoid changing any header associated with a link/reference.
  • Step through instructions (or ask someone to do so).
  • Review for wordiness
  • Match tone and style of page/section.
  • Run make linkcheck.
  • View HTML in a browser to check rendering.
  • Use semantic newlines.
  • follow best practices for commits.
    • Descriptive title written in the imperative.
    • Include brief overview of QA steps taken.
    • Mention any related issues numbers.
    • End message with sign off/DCO line (-s, --signoff).
    • Sign commit with your gpg key (-S, --gpg-sign).
    • Squash commits if needed.
  • Request PR review by a technical writer and at least one peer.

Comments

Any thing else that a maintainer/reviewer should know.
This could include potential issues, rational for approach, etc.

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]>
@detsch detsch requested review from mike-sul and kprosise February 18, 2025 21:19
@detsch
Copy link
Member Author

detsch commented Feb 18, 2025

@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.

@detsch detsch requested a review from vanmaegima February 18, 2025 21:22
Copy link
Member

@vanmaegima vanmaegima left a comment

Choose a reason for hiding this comment

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

Copy link
Contributor

@kprosise kprosise left a 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
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
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.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
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.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
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.

Copy link
Member Author

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,
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
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,
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
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.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
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.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
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.

@detsch detsch force-pushed the detsch-aklite-v95-changes branch 2 times, most recently from 44424d4 to 1c741ea Compare February 19, 2025 23:52
@detsch
Copy link
Member Author

detsch commented Feb 19, 2025

@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.

@kprosise
Copy link
Contributor

@detsch shall I go ahead and merge?

@detsch
Copy link
Member Author

detsch commented Feb 20, 2025

@detsch shall I go ahead and merge?

@kprosise yes, please.


I'll deal with @vanmaegima's suggestion in another PR

let's also add an entry to this page: https://docs.foundries.io/latest/reference-manual/ota/update-rollback.html#update-rollback

@kprosise kprosise merged commit 56b9d7b into foundriesio:main Feb 20, 2025
2 of 3 checks passed
@detsch detsch deleted the detsch-aklite-v95-changes branch February 21, 2025 21:23
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.

4 participants