Terms and Definitions


In ABF, project stands for a union of software source code, documentation and other artifacts accompanied by meta-information necessary to build and distribute the software product as a package.

Creating a new project

Go to the Projects page and press the New Project button (one can also create a new project just pressing the New Project button on the main page).

ABF Project List.png

The following page will appear:

ABF Create Project.png

Please fill the following values for your project:

Note: you can create a project owned by group only if you are creator of the group or its administrator. If you are not creator or administrator of any group, there will be no choise for you in this field

On this page you can also import SRPM package for you project - just click the 'Choose' button and choose the file to import.

Now press the 'Save' button and your new project will be created. Source code from your SRPM package will be available in ABF git repository in the import branch.

Forking an existing project

One can create a clone of a project that already exists in the system by forking it. (Note that different users/groups can have a project with the same name).

In order to create a fork, look for the project name using ABF web interface:

ABF Search.png

Choose the project you want to fork and click on its name. You will see a page with project description.

ABF Project Page.png

In order to clone the project source code, just use the git repository URL displayed under the main menu (if you are not project owner or developer, this URL will allow you to only checkout the source code, but not to commit your changes back).

In order to create a project fork in ABF, press the "Fork" button. ABF will ask for confirmation and after you press 'OK' you will obtain a completely independent copy of the project, so you will be able to modify it as you wish and to build it inside your own repository.

Now you can see your fork of the project in the Projects section which contains all projects of your own and projects where you are participating.

Building projects

In order to transform project source code into a package that can be published to the repository, you should Build the project.

Go to the Projects section and choose the project you want to build.

ABF Project List.png

Click on its name and then go to the Builds section.

ABF Builds.png

In order to build the project, press the New build button.

ABF New Build.png

For the new build you should specify the following parameters:

When all values are set, press the Build button and the project build will be launched.

Monitoring builds

You can monitor the builds in the Task monitoring section.

ABF Task Monitoring.png

This page displays all building projects which are accessible by you.

Possible build status values include:

You can use filters on this page to sort out projects according to certain criteria.

If you want to get detailed information about some task, just click on its ID:

ABF Build Status.png

Detailed task information will be displayed such as user who launched the build, build parameters, packages, current status and so on.

After the build is completed, you will find detailed build logs on this page.

If the build completed successfully but the packages were not published to repository, this page will also provide you with Container path - address of a container with created packages. You can use this container as a usual repository.

Working with source code using Git

Source code for all projects is stored in the Git repository. To work with repository, you should know its URL which can be seen at the project page in ABF Web UI under the main menu.

ABF Project Page.png

The following Git commands will be useful for the basic repo management:

git clone <repo_address>
you will be asked for a password of your ABF account; in case when you are cloning a public project, you can just enter an empty password.
git checkout <branch_name>
git commit -a -m “commit_summary”
git add --all
git push
you will be asked for a password of your ABF account; in order to push the changes to server, you should have appropriate permissions
git pull

if you get the following error:
error: Peer certificate cannot be authenticated with given CA certificates
then add 'env GIT_SSL_NO_VERIFY=true' before the command, e.g.:
env GIT_SSL_NO_VERIFY=true git clone

if you get the following error:
error: RPC failed; result=22, HTTP code = 411
then run 'git config http.postBuffer 524288000'
and run once again the command that led to this problem

These commands should be enough to start working with ABF.

ABF Documentation
About ABF • ABF Getting Started • ABF User's Guide • ABF Administrator's Guide