File: murano_bundles.rst

package info (click to toggle)
murano 1%3A6.0.0-2
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 10,644 kB
  • sloc: python: 34,127; sh: 717; pascal: 269; makefile: 83
file content (57 lines) | stat: -rw-r--r-- 2,101 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
.. _murano-bundles:

==============
Murano bundles
==============

A bundle is a collection of packages. In the Community App Catalog, you can find
such bundles as ``container-based-apps``, ``app-servers``, and so on.
The packages in the Application Catalog are sorted by usage. You can import
bundles from the catalog using Dashboard or CLI. You can read about this in
:ref:`Managing applications <manage_applications>` and :ref:`Using CLI <use-cli>`.
Specific information about *bundle-import* command can be found at
:ref:`Murano command-line client <cli-ref>`.

Bundle structure
~~~~~~~~~~~~~~~~

Bundle description is a JSON structure, that contains list of packages
in the bundle and bundle version. Here is the example:

    .. code-block:: javascript

       {
           "Packages": [
               {
                   "Name": "com.example.apache.ApacheHttpServer",
                   "Version": ""
               },
               {
                   "Name": "com.example.apache.Tomcat",
                   "Version": ""
               }
           ],
           "Version": 1
       }

    ..

``Name`` is a required parameter and should contain package fully qualified name.
``Version``     is not a mandatory parameter. Version for package entry specifies the
version of the package to look into :ref:`Murano package repository <repository>`.
If it is specified, murano client would look for a file with that version
specification in murano repository (for example ``com.example.MyApp.0.0.1.zip``
for com.example.MyApp of version 0.0.1). If the version is omitted or left
blank client would search for ``com.example.MyApp.zip``.

Create local bundle
~~~~~~~~~~~~~~~~~~~

However, you may need to create a local bundle. You may need it if you want to
setup your own :ref:`Murano package repository <repository>`. To create a new
bundle, perform the following steps:

   #. Navigate to the directory with the target packages.

   #. Create a ``.bundle`` file. List all the required packages in ``Packages``
      section. If needed, specify the bundle version in the ``Version`` section.