Skip to content
This repository has been archived by the owner on Feb 12, 2021. It is now read-only.

os: add user-docs on how to use custom torcx remotes and images #1261

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

lucab
Copy link
Contributor

@lucab lucab commented Oct 4, 2018

This adds a walk-through and CLC snippets on how to configure custom
remotes and use addons from there.

@lucab lucab force-pushed the ups/torcx-using-custom-remotes branch from b7b661f to 1c6fce4 Compare October 4, 2018 13:47
This adds a walk-through and CLC snippets on how to configure custom
remotes and use addons from there.
@lucab lucab force-pushed the ups/torcx-using-custom-remotes branch from 1c6fce4 to 67850ac Compare October 9, 2018 13:25
Copy link
Contributor

@ajeddeloh ajeddeloh left a comment

Choose a reason for hiding this comment

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

LGTM aside from one tiny grammer nit.


If it is not possible to provision any of the configured addons for the upcoming OS, the update will not applied and the process will be re-tried later.

This can happen if an addon is not anymore present on a remote, if the image matching the new OS version is not yet available, or in case of any other error when fetching from a remote.
Copy link
Contributor

Choose a reason for hiding this comment

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

addon is not present anymore on a remote


## Remotes Overview

A Torcx [remote][torcx-remotes-design] is a collection of addon images for torcx, served from a remote source, which can be fetched by a node for use by [torcx-generator][torcx-overview].
Copy link

Choose a reason for hiding this comment

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

Might make sense to add a the in fetched by a node for us by _the_ [torcx generator]

## Remotes Overview

A Torcx [remote][torcx-remotes-design] is a collection of addon images for torcx, served from a remote source, which can be fetched by a node for use by [torcx-generator][torcx-overview].
Images for configured addons can be retrieved automatically on first-boot provisioning (i.e. in initramfs) and when preparing for new OS updates (i.e. before marking a node as "reboot needed").
Copy link

Choose a reason for hiding this comment

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

Can new remotes be added outside of first-boot/updates? If not then the can be in configured addons can be should probably be replaced with are

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants