comparison doc/libervia-cli/appication.rst @ 3573:813595f88612

merge changes from main branch
author Goffi <goffi@goffi.org>
date Thu, 17 Jun 2021 13:05:58 +0200
parents 267e4987b58b
children
comparison
equal deleted inserted replaced
3541:888109774673 3573:813595f88612
1 =============================================
2 application: external applications management
3 =============================================
4
5 Libervia can launch and manage external applications. This is useful to integrate external
6 services, notably in the web frontend. The command can be used either with ``application``
7 or the shortcut ``app``.
8
9 list
10 ====
11
12 List available applications. This command can show either the list of available
13 application (which could be launched) and/or the list of running application.
14
15 By default both available and running application are shown, this can be filtered by using
16 ``-f {available,running}, --filter {available,running}``
17
18 example
19 -------
20
21 List available applications::
22
23 $ li app list -f available
24
25 start
26 =====
27
28 Start an application. Depending on the application and its availability locally, this make
29 take some time (resources may have to be downloaded).
30
31 example
32 -------
33
34 Start Weblate::
35
36 $ li app start weblate
37
38 .. _li_app_stop:
39
40 stop
41 =====
42
43 Stop an application. If several instances of the same application are running, ``-i ID,
44 --id ID`` can be used to specify which one must be stopped.
45
46 example
47 -------
48
49 Stop Weblate::
50
51 $ li app stop weblate
52
53
54 exposed
55 =======
56
57 List exposed values from a running application. Exposed values may be the port used,
58 passwords automatically generated, or fields useful for web integration.
59
60 As for :ref:`li_app_stop`, if several instances of the same application are running, one
61 can be specified using ``-i ID, --id ID``.
62
63 example
64 -------
65
66 Show exposed values of a running Weblate::
67
68 $ li account application exposed weblate