3diy
/
moonraker
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: bring up the update_manager documentation 

Signed-off-by:  Eric Callahan <arksine.code@gmail.com>
This commit is contained in:
Eric Callahan 2022-04-04 08:52:40 -04:00
parent 5c9409c28d
commit 58228ec161
No known key found for this signature in database
GPG Key ID: 7027245FBBDDF59A
1 changed files with 91 additions and 43 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

134
docs/configuration.md
View File

@ -1108,37 +1108,59 @@ enable_packagekit: True
# updates will be processed via PackageKit over D-Bus. When set to False # updates will be processed via PackageKit over D-Bus. When set to False
# the "apt cli" fallback will be used. The default is True. # the "apt cli" fallback will be used. The default is True.
channel: dev channel: dev
# The update channel applied to Klipper and Moonraker. May be 'dev' # The update channel applied to Klipper and Moonraker. May dev or
# which will fetch updates using git, or 'beta' which will fetch # beta. The dev channel will update to the latest commit pushed
# zipped beta releases. Note that this channel does not apply to # to the repo, whereas the beta channel will update to the lastest
# client updates, a client's update channel is determined by its # commit tagged by Moonraker. The beta channel will see less frequent
# 'type' option. When this option is changed the next "update" will # updates and should be more stable. Users on the beta channel will have
# swap channels, any untracked files in the application's path will be # more opportunity to review breaking changes before choosing to update.
# removed during this process. The default is dev. # The default is dev.
``` ```
#### Client Configuration #### Extension Configuration
This allows client programs such as Fluidd, KlipperScreen, and Mainsail to be The update manager may be configured manage additional software, hencefore
updated in addition to klipper, moonraker, and the system os. Repos that have referred to as "extensions". In general terms, an extension may be defined
been modified or cloned from unofficial sources are not supported. as a piece of software hosted on GitHub. The update manager breaks this
down into 3 basic types:
Moonraker supports updates for "application" based clients and "web" based - `web`: A front end such as Mainsail or Fluidd. Updates are deployed via
clients. Each are detailed separately below. zip files created for GitHub releases.
- `git_repo`: Used to manage extensions that do not fall into the "web" type.
Updates are deployed directly via git. Typical usage scenarios are to
manage extensions installed a service such as KliperScreen, repos containing
configuration, and unofficial 3rd party extensions for Klipper and Moonraker.
See the note below in reference to unofficial extensions.
- `zip`: This can be used to mananged various extensions like the `git_repo`
type, however its updates are deployed via zipped GitHub releases.
!!! Note
To benefit the community Moonraker facilitates updates for 3rd party
"Klippy Extras" and "Moonraker Components". While many of these
extensions are well developed and tested, users should always be
careful when using such extensions. Moonraker and Klipper provide
no official support for such extensions, thus users experiencing an
issue should not create bug reports on the Klipper or Moonraker issue
trackers without first reproducing the issue with all unofficial
extensions disabled.
##### Web type (front-end) configuration
```ini ```ini
# moonraker.conf # moonraker.conf
[update_manager client_name] [update_manager extension_name]
type: web type: web
# The client type. For web clients this should be 'web', or 'web_beta'. # The management type. This should always be "web" for browser based
# The 'web_beta' type will enable updates for releases tagged with # front ends. This parameter must be provided.
# "prerelease" on GitHub. This parameter must be provided. channel: stable
# May be stable or beta. When beta is specified "pre-release"
# updates are available.
repo: repo:
# This is the GitHub repo of the client, in the format of user/client. # This is the GitHub repo of the front end, in the format of owner/repo_name.
# For example, this could be set to fluidd-core/fluidd to update Fluidd or # For example, this could be set to fluidd-core/fluidd to update Fluidd or
# mainsail-crew/mainsail to update Mainsail. This parameter must be provided. # mainsail-crew/mainsail to update Mainsail. This parameter must be provided.
path: path:
# The path to the client's files on disk. This parameter must be provided. # The path to the front end's files on disk. This parameter must be provided.
persistent_files: persistent_files:
# A list of newline separated file names that should persist between # A list of newline separated file names that should persist between
# updates. This is useful for static configuration files, or perhaps # updates. This is useful for static configuration files, or perhaps
@ -1147,19 +1169,18 @@ refresh_interval:
# This overrides the refresh_interval set in the primary [update_manager] # This overrides the refresh_interval set in the primary [update_manager]
# section. # section.
info_tags: info_tags:
# Optional information tags about this application that are reported to # Optional information tags about this extensions that are reported via
# clients as a list of strings. Each tag should be separated by a new line. # Moonraker's API as a list of strings. Each tag should be separated by
# For example: # a new line. For example:
# info_tags: # info_tags:
# desc=My Client App # desc=My Client App
# action=webcam_restart # action=webcam_restart
# Clients my use these tags to perform additonal actions or display # Front ends may use these tags to perform additonal actions or display
# information, see your client documentation for details on configuration. # information, see your extension documentation for details on configuration.
# The default is an empty list. # The default is an empty list.
``` ```
This second example is for "applications". These may be git repositories ##### All other extensions
or zipped distributions.
!!! Note !!! Note
Git repos must have at least one tag for Moonraker to identify its Git repos must have at least one tag for Moonraker to identify its
@ -1170,13 +1191,22 @@ or zipped distributions.
```ini ```ini
# moonraker.conf # moonraker.conf
# service_name must be the name of the systemd service # When defining a service, the "extension_name" must be the name of the
[update_manager service_name] # systemd service
[update_manager extension_name]
type: git_repo type: git_repo
# Can be git_repo, zip, or zip_beta. See your the client's documentation # Can be git_repo or zip. This value is set depending on how an extension
# for recommendations on which value to use. Generally a git_repo is # chooses to deploy updates, see its documentation for details This
# an applications "dev" channel, zip_beta is its "beta" channel, and zip # parameter must be provided.
# is its "stable" channel. This parameter must be provided. channel: dev
# The update channel. The available value differs depending on the
# "type" option.
# type: git_repo - May be dev or beta. The dev channel will update to
# the latest pushed commit, whereas the beta channel
# will update to the latest tagged commit.
# type: zip - May be be stable or beta. When beta is specified
# "pre-release" updates are available.
# The default is dev.
path: path:
# The absolute path to the client's files on disk. This parameter must be # The absolute path to the client's files on disk. This parameter must be
# provided. # provided.
@ -1192,11 +1222,11 @@ primary_branch:
# option allows clients to specify 'main', or their own unique name, as # option allows clients to specify 'main', or their own unique name, as
# the branch used for repo validity checks. The default is master. # the branch used for repo validity checks. The default is master.
env: env:
# The path to the client's virtual environment executable on disk. For # The path to the extension's virtual environment executable on disk. For
# example, Moonraker's venv is located at ~/moonraker-env/bin/python. # example, Moonraker's venv is located at ~/moonraker-env/bin/python.
# The default is no env, which disables updating python packages. # The default is no env, which disables updating python packages.
requirements: requirements:
# This is the location in the repository to the client's virtual environment # This is the location in the repository to the extension's python
# requirements file. This location is relative to the root of the repository. # requirements file. This location is relative to the root of the repository.
# This parameter must be provided if the "env" option is set, otherwise it # This parameter must be provided if the "env" option is set, otherwise it
# should be omitted. # should be omitted.
@ -1213,27 +1243,45 @@ enable_node_updates:
host_repo: host_repo:
# The GitHub repo in which zipped releases are hosted. Note that this does # The GitHub repo in which zipped releases are hosted. Note that this does
# not need to match the repository in the "origin" option, as it is possible # not need to match the repository in the "origin" option, as it is possible
# to use a central GitHub repository to host multiple client builds. As # to use a central GitHub repository to host multiple extension builds. As
# an example, Moonraker's repo hosts builds for both Moonraker and Klipper. # an example, Moonraker's repo hosts builds for both Moonraker and Klipper.
# This option defaults to the repo extracted from the "origin" option, # This option defaults to the repo extracted from the "origin" option,
# however if the origin is not hosted on GitHub then this parameter must # however if the origin is not hosted on GitHub then this parameter must
# be provided. # be provided.
is_system_service: True is_system_service: True
# If set to true the update manager will attempt to use systemctl to restart # This should be set to False for repos that are not installed as a service
# the service after an update has completed. This can be set to flase for # or do not need to restart a service after updates. This option sets the
# repos that are not installed as a service. The default is True. # default value for the "managed_services" option. When set to False,
# "managed_services" defaults to an empty list. When set to True,
# "managed_services" defaults to a list containing a single item, a service
# matching the "extension_name" provided in the section header. The default
# is True.
# NOTE: In the future this option will be deprecated. In preparation
# for this, extensions that are installed as service, such as "KlipperScreen"
# should ignore this option and set the "managed_services" option.
managed_services:
# A list of one or more systemd services that must be restarted after an
# update is complete. Multiple services must be separated by whitespace.
# Currently this option is restricted to the following values:
# <name> - The name configured in the extension's section header.
# If the section header is [update_manager KlipperScreen]
# then KlipperScreen would be a valid value.
# klipper - The klipper service will be restarted after an update
# moonraker - The moonraker service will be restarted after an update
# When this option is specified it overrides the "is_system_service" option.
# Thus it is not required to specify both, only one or the other. The
# default depends on "is_system_service" as explained above.
refresh_interval: refresh_interval:
# This overrides the refresh_interval set in the primary [update_manager] # This overrides the refresh_interval set in the primary [update_manager]
# section. # section.
info_tags: info_tags:
# Optional information tags about this application that are reported to # Optional information tags about this application that will be reported
# clients as a list of strings. Each tag should be separated by a new line. # front ends as a list of strings. Each tag should be separated by a new line.
# For example: # For example:
# info_tags: # info_tags:
# desc=Special Application # desc=Special Application
# klipper_restart # Front ends my use these tags to perform additonal actions or display
# Clients my use these tags to perform additonal actions or display # information, see your extension documentation for details on configuration.
# information, see your client documentation for details on configuration.
# The default is an empty list. # The default is an empty list.
``` ```