Skip to content

Installation and usage

Jimmy Berry edited this page Apr 28, 2018 · 3 revisions

Tumbleweed CLI allows one to interact with Tumbleweed snapshot repositories created by tumbleweed-snapshot. Both are currently hosted by myself using AWS S3 and are not officially supported. The original idea proposal can be found in the opensuse-factory list archive and the prototype announcement.

The prototype makes changes to zypper repos and also provides convenience calls to zypper ref and zypper dup.

Installation

zypper in tumbleweed-cli

Usage

See tumbleweed --help for reference.

Usage: tumbleweed [options] command [arguments]

Options:
    --version         Print version string and exit
    --force           Force on operation to occur regardless of checks.
    --install         Initiate install after command.
-h, --help            Display this message and exit

Commands:
status                Show status information (latest and current snapshots).
latest                Show latest snapshot available.
version               Show current installed snapshot.
list                  List available snapshots.
update|upgrade        Switch to and install the latest available snapshot.
switch [version]      Switch to a new snapshot (none for latest).
revert                Revert to the previous snapshot or repo state.
list-repos            List snapshottable repo URLs for the current snapshot.

Examples

$ tumbleweed status
latest   : 20161129
installed: 20161128
$ tumbleweed latest
20161129
$ tumbleweed version
20161128
$ tumbleweed list
20161129
20161128
20161125
$ tumbleweed update
choosing latest version
switching from 20161128 to 20161129
switch 4 repos (tw-debug tw-source tw-non-oss tw-oss)? [y/n] (y): y
[sudo] password for root: 
switched tw-debug
switched tw-source
switched tw-non-oss
switched tw-oss
Repository 'tw-non-oss' is up to date.
Repository 'tw-oss' is up to date.
Repository 'tw-snapshot' is up to date.
Repository 'tw-update' is up to date.
All repositories have been refreshed.
Loading repository data...
Reading installed packages...
Computing distribution upgrade...
...
$ tumbleweed switch --install 20161128
switching from 20161129 to 20161128
switch 4 repos (tw-debug tw-source tw-non-oss tw-oss)? [y/n] (y): y
...

or instead

$ tumbleweed revert --install
revert 4 repos? [y/n] (y): y
...
$ zypper lr -EU
20 | non-oss       | non-oss       | Yes     | (r ) Yes  | No      | http://download.tumbleweed.boombatower.com/20180222/repo/non-oss                                                                                                                        
24 | oss           | oss           | Yes     | (r ) Yes  | No      | http://download.tumbleweed.boombatower.com/20180222/repo/oss
Clone this wiki locally