PACKAGE.md

rmt-server Packaging

Note: Never push changes to the internal build service ibs://Devel:SCC:RMT! The repository links to systemsmanagement:SCC:RMT and gets updated automatically.

Note: Look below for direction on publishing to registry.

• The package is built in OBS at: https://build.opensuse.org/package/show/systemsmanagement:SCC:RMT/rmt-server
• To update the version of RMT, you will have to change the following files:
  • lib/rmt.rb
  • package/obs/rmt-server.spec

1. Checkout/update OBS working copy:

   • If the OBS project is not checked out, check out working copy of OBS project into a separate directory, e.g.:

     mkdir ~/obs
     cd ~/obs
     osc co systemsmanagement:SCC:RMT rmt-server
     

   • Alternatively, if an OBS working copy is already checked out, update the working copy by running osc up

2. Run make dist in your RMT working directory to build a tarball.

3. Copy the files from the package/obs directory to the OBS working directory.

4. Examine the changes by running osc status and osc diff.

5. Stage the changes by running osc addremove.

6. Build the package with osc:

   osc build <repository> <arch> --no-verify

   The list of all build targets and architectures that are configured for the project can be obtained by running osc repos.

7. After the code is reviewed + merged in the git repository: Commit the changes into OBS by running osc ci.

Tag and Release the New Version on Github

1. Tag the version locally and push it to github:

   git tag -a v<version> # for example git tag -a v1.0.0
   git push --tags
   

2. On github, submit a release for the tag. See https://help.github.com/en/articles/creating-releases for assistance.

Submit Requests to openSUSE Factory and SLES

To get a maintenance request accepted, each changelog entry needs to have at least one reference to a bug or feature request like bsc#123 or fate#123. CVEs must be accompanied with the corresponding bsc#, even if it is not reported vs rmt-server.

Note: If you want to disable automatic changes made by osc (e.g. License string) use the --no-cleanup switch. Can be used with commands like osc mr, osc sr and osc ci.

Factory First

To submit a request to openSUSE Factory, issue this commands in the console:

osc sr systemsmanagement:SCC:RMT rmt-server openSUSE:Factory

Submit maintenance updates for SLES to the Internal Build Service

Get target codestreams where to submit

To check out which codestreams the package is currently maintained in, run:

osc -A https://api.suse.de maintained rmt-server

For a more detailed view which target codestreams are in which state, check out: Codestream overview

Submit updates

For each maintained codestream you need to create a new maintenance request:

osc -A https://api.suse.de mr Devel:SCC:RMT rmt-server SUSE:SLE-15:Update

Note: In case the mr (maintenance request) command is not working properly, try sr (submit request) command.

Example:

$ osc -A https://api.suse.de maintained rmt-server
SUSE:SLE-15:Update/rmt-server

$ osc -A https://api.suse.de mr Devel:SCC:RMT rmt-server SUSE:SLE-15:Update
Using target project 'SUSE:Maintenance'
17362323

Note:

• When asked whether or not to supersede a request, the answer is usually "no". Saying "yes" would overwrite the previous request made, cancelling the release process for its codestream.

You can check the status of your requests here and here.

After your requests have been accepted, they still have to pass maintenance testing before they are released to customers. You can check their progress at maintenance.suse.de. If you still need help, the maintenance team can be reached at [email protected] or #maintenance on irc.suse.de.

Packaging and publishing to SUSE registry

SUSE registry houses the rmt-server docker image. The image is built on OBS/IBS, project for SLES 15sp4 based distributions can be found here.

At the moment of writing, the publishing process has to be done manually. This can be achieved my reaching out to the Auto-Build team (only available internally).