Basic usage of rp-cli
Example helloworld-binding with rp-cli
After following the “getting started for a developer” chapter, you will have at least one project with one application. The application choosen for the example is helloworld-binding.
List your projects
You can list your projects with rp-cli:
# List the projects available for the user on redpesk infrastructure
$ rp-cli projects list
ID Slug Name Version Type
bfdcddbd-120c-41b2-b5e7-f53b6f0cf292 my-awesome-project my-awesome-project [Not set] standard-applications
ea5cbf8c-7b6f-4063-b236-4eb70b2be1ce my-test-project My Test Project [Not set] standard-applications
98a31932-6077-4bdb-b5bd-1099a55931eb my-image-project My Image Project [Not set] standard-images
The project created before in the “getting started for a developer” part is named My awesome project, with the slug my-awesome-project.
List your applications
You can also list your applications like below:
$ rp-cli applications list
ID Name Slug Type Project
986e735c-4b46-4ab2-8be1-7e67ea833317 Helloworld binding helloworld-binding standard my-awesome-project
6abde310-c253-4209-b901-d65905d4972f Mustach mustach standard my-test-project
This command shows your application Helloworld binding in the project described before.
Get informations about an application
To have informations about this application, just use the following command:
$ rp-cli applications get helloworld-binding --project my-awesome-project -v
ID: 986e735c-4b46-4ab2-8be1-7e67ea833317
Name: Helloworld binding
Package Name: helloworld-binding
Slug: helloworld-binding
Type: standard
Parent project: my-awesome-project
Description: A binding example, implemented in a redpesk® context
Distributions: redpesk-lts-arz-1.0-update [Mand]
Autotests: OFF
Autoaudits: OFF
Auto rebuild SRPM: ON
Audits settings: {"audit":null}
Creation time: 2023-06-20 10:21:53.269993 +0000 UTC
Update time: 2023-06-20 14:33:31.084615 +0000 UTC
Bookmarked: false
Build type: standard_build_cross
Source URL: https://github.com/redpesk-samples/helloworld-binding.git
Source Revision: master-next
External Specfile: conf.d/packaging/helloworld-binding.spec
Services:
- Name: download_sources
- Parameters:
download: false
force: false
- Name: excludearch
- Parameters:
arches: []
- Name: import_gitpkg
- Parameters:
ref: ""
url: ""
- Name: import_reference
- Parameters:
name: ""
ref: ""
url: ""
- Name: setverrel
- Parameters:
release: true
version: true
Build an application
To build the application Helloworld binding in the project My awesome project, just execute this command:
$ rp-cli applications build helloworld-binding --project my-awesome-project -v
-- Application build requested by user --
Building the "helloworld-binding" application...
---------- Build event received ---------
Build ID: 109585
Application ID: helloworld-binding
Distribution: redpesk-devel-arz
Status: open
Subtask: srpm
Subtask state: open
Subtask method: buildSRPMFromSCM
Subtask method description: Packaging sources into SRPM package
-----------------------------------------
[...]
Subtask method: buildArch
Subtask method description: Building native application
-----------------------------------------
--------- Application build done --------
Test an application
After building the application, you may want to launch some tests. The command to launch the tests is the following:
$ rp-cli applications test helloworld-binding --project my-awesome-project
-- Application test requested by user --
Testing the application on build 10...
[STATE CHANGE] pending -- TOTAL => 0
[STATE CHANGE] deploying -- TOTAL => 0
[STATE CHANGE] started -- TOTAL => 0
[STATE CHANGE] started -- TOTAL => 0
[STATE CHANGE] success -- TOTAL => 10
------- Application test succeeded ------
Other usages of rp-cli
In the previous part, you retrieved a project with its application from the redpesk infrastructure, in order to build it. With the rp-cli tool, it is also possible to add projects and applications without going through the user interface, and many other things. If you want more information about rp-cli, use the help with:
$ rp-cli help
You may also find an advanced documentation more detailed than this previous example, as well as a list of commands available with rp-cli.