From Fedora Project Wiki
m (Location of man page in Github has changed)
 
(13 intermediate revisions by one other user not shown)
Line 10: Line 10:
== Manual page ==
== Manual page ==


You can read Bodhi's man page [https://github.com/fedora-infra/bodhi/blob/develop/docs/man_bodhi.rst online], or you can read it on your system:
You can read Bodhi's man page [https://github.com/fedora-infra/bodhi/blob/develop/docs/man_pages/bodhi.rst online], or you can read it on your system:


<pre>$ man bodhi</pre>
<pre>$ man bodhi</pre>
== Create or query overrides ==
=== Submitting a new override ===
<pre>bodhi overrides save [options] <name-version-release></pre>
For example, you successfully built version '''1.12.0''' of the '''mocha''' package for '''f25''', with a release value of '''3'''. The command would be:
<pre>$ bodhi overrides save --duration=4 --user=willi --notes="Useful details" mocha-1.12.0-3.fc25
Password:
willi's mocha-1.12.0-3.fc20 override (expires 2016-12-30 16:21:17)</pre>
=== Query overrides ===
<pre>$ bodhi overrides query --user=willi</pre>


== Querying updates ==
== Querying updates ==
Line 21: Line 37:


<pre>$ bodhi updates query --packages=rakudo-star</pre>
<pre>$ bodhi updates query --packages=rakudo-star</pre>
View updates by status
<pre>$ bodhi updates query --status testing --releases f25</pre>


== Submitting a new update for multiple builds ==
== Submitting a new update for multiple builds ==


<pre>$ bodhi updates new --request=testing --notes="update to 2016.11" --type=enhancement --user gerd nqp-0.0.2016.11-1.fc25,moarvm-0.2016.11-1.fc25
<pre>$ bodhi updates new --request=testing --notes="update to 2016.11" \
> --type=enhancement --user gerd nqp-0.0.2016.11-1.fc25,moarvm-0.2016.11-1.fc25
Password:  
Password:  
================================================================================
================================================================================
Line 44: Line 65:


</pre>
</pre>
== Changing the state of an update ==
The '''state''' should be one of testing, stable, unpush, obsolete or revoke.
Pushing an update to stable
<pre>$ bodhi updates request --user=gerd rakudo-star-0.0.2016.11-1.el7 stable
Password:
...
            This update has been submitted for stable by gerd.
  https://bodhi.fedoraproject.org/updates/FEDORA-EPEL-2016-5483f2f1e9
</pre>
Pushing an update to stable by update id
<pre>$ bodhi updates request --user=gerd FEDORA-2016-70bb6b7029 stable
Password:
...
</pre>
== Providing feedback for an update ==
<pre>$ bodhi updates comment --user gerd --karma +1 wine-2.0-0.1.rc2.fc25 'This is a comment'
Password:
u'wine-2.0-0.1.rc2.fc25' u'This is a comment' 1
The following comment was added to wine-2.0-0.1.rc2.fc25
This is a comment</pre>

Latest revision as of 07:51, 4 August 2017

Using the bodhi command-line interface

Installing the client

Bodhi 2 is distributed with Fedora >= 26. If you are on an older Fedora version, you can install bodhi 2 from Copr:

$ sudo dnf copr enable bowlofeggs/bodhi
$ sudo dnf update bodhi-client

Manual page

You can read Bodhi's man page online, or you can read it on your system:

$ man bodhi

Create or query overrides

Submitting a new override

bodhi overrides save [options] <name-version-release>

For example, you successfully built version 1.12.0 of the mocha package for f25, with a release value of 3. The command would be:

$ bodhi overrides save --duration=4 --user=willi --notes="Useful details" mocha-1.12.0-3.fc25
Password: 
willi's mocha-1.12.0-3.fc20 override (expires 2016-12-30 16:21:17)

Query overrides

$ bodhi overrides query --user=willi

Querying updates

$ bodhi updates query

View all updates for a given package

$ bodhi updates query --packages=rakudo-star

View updates by status

$ bodhi updates query --status testing --releases f25

Submitting a new update for multiple builds

$ bodhi updates new --request=testing --notes="update to 2016.11" \
> --type=enhancement --user gerd nqp-0.0.2016.11-1.fc25,moarvm-0.2016.11-1.fc25
Password: 
================================================================================
     nqp-0.0.2016.11-1.fc25 moarvm-0.2016.11-1.fc25
================================================================================
  Update ID: FEDORA-2016-cd7e9b089e
    Release: Fedora 25
     Status: pending
       Type: enhancement
      Karma: 0
    Request: testing
      Notes: update to 2016.11
  Submitter: gerd
  Submitted: 2016-12-13 23:34:59
   Comments: bodhi - 2016-12-13 23:34:59 (karma 0)
             This update has been submitted for testing by gerd.

  https://bodhi.fedoraproject.org/updates/FEDORA-2016-cd7e9b089e

Changing the state of an update

The state should be one of testing, stable, unpush, obsolete or revoke.

Pushing an update to stable

$ bodhi updates request --user=gerd rakudo-star-0.0.2016.11-1.el7 stable
Password:
...
             This update has been submitted for stable by gerd.

  https://bodhi.fedoraproject.org/updates/FEDORA-EPEL-2016-5483f2f1e9

Pushing an update to stable by update id

$ bodhi updates request --user=gerd FEDORA-2016-70bb6b7029 stable
Password:
...

Providing feedback for an update

$ bodhi updates comment --user gerd --karma +1 wine-2.0-0.1.rc2.fc25 'This is a comment'
Password: 
u'wine-2.0-0.1.rc2.fc25' u'This is a comment' 1
The following comment was added to wine-2.0-0.1.rc2.fc25
This is a comment