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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
|
.. _multi_region:
Multi-region application
~~~~~~~~~~~~~~~~~~~~~~~~
Since Newton release, Murano supports multi-region application deployment.
All MuranoPL resource classes are inherited from the
``io.murano.CloudResource`` class.
An application developer can set a custom region for ``CloudResource``
subclasses deployment.
Set a region for resources
--------------------------
**To set a region for resources:**
#. Specify a region for ``CloudResource`` subclasses deployment
through the ``regionName`` property. For example:
.. code-block:: yaml
Application:
?:
type: com.example.apache.ApacheHttpServer
enablePHP: $.appConfiguration.enablePHP
...
instance:
?:
type: io.murano.resources.LinuxMuranoInstance
regionName: 'CustomRegion'
...
#. Retrieve ``io.murano.CloudRegion`` objects:
.. code-block:: yaml
$region: $.instance.getRegion()
$regionName: $region.name
$regionLocalStack: $region.stack
$regionDefaultNetworks: $region.defaultNetworks
As a result, all region-local properties are moved from the ``io.murano.Environment``
class to the new :ref:`cloud-region` class.
For backward compatibility, the ``io.murano.Environment`` class stores
region-specific properties of default region, except the ``defaultNetworks``
in its own properties.
The ``Environment::defaultNetworks`` property contains templates for
the ``CloudRegion::defaultNetworks`` property.
Through current UI, you cannot select networks, flavor, images
and availability zone from a non-default region.
We suggest using regular text fields to specify region-local resources.
Networking and multi-region applications
----------------------------------------
By default, each region has its own separate network.
To ensure connectivity between the networks, create and configure networks in regions
before deploying the application and use ``io.murano.resources.ExistingNeutronNetwork``
to connect the instance to an existing network.
Example:
.. code-block:: yaml
Application:
?:
type: application.fully.qualified.Name
...
instance_in_region1:
?:
type: io.murano.resources.LinuxMuranoInstance
regionName: 'CustomRegion1'
networks:
useEnvironmentNetwork: false
useFlatNetwork: false
customNetworks:
- ?:
type: io.murano.resources.ExistingNeutronNetwork
regionName: 'CustomRegion1'
internalNetworkName: 'internalNetworkNameInCustomRegion1'
internalSubnetworkName: 'internalSubNetNameInCustomRegion1'
instance_in_region2:
?:
type: io.murano.resources.LinuxMuranoInstance
regionName: 'CustomRegion2'
networks:
useEnvironmentNetwork: false
useFlatNetwork: false
customNetworks:
- ?:
type: io.murano.resources.ExistingNeutronNetwork
regionName: 'CustomRegion2'
internalNetworkName: 'internalNetworkNameInCustomRegion2'
internalSubnetworkName: 'internalSubNetNameInCustomRegion2'
...
Also, you can configure networks with the same name and use a template
for the region networks.
That is, describe ``io.murano.resources.ExistingNeutronNetwork`` only once
and assign it to the ``Environment::defaultNetworks::environment`` property.
The environment will create ``Network`` objects for regions from the
``ExistingNeutronNetwork`` template.
Example:
.. code-block:: console
OS_REGION_NAME="RegionOne" openstack network create <NETWORK-NAME>
OS_REGION_NAME="RegionTwo" openstack network create <NETWORK-NAME>
# configure subnets
#...
# add ExistingNeutronNetwork to environment object model
murano environment-create --join-net-id <NETWORK-NAME> <ENV_NAME>
# also it is possible to specify subnet from <NETWORK-NAME>
murano environment-create --join-net-id <NETWORK-NAME> --join-subnet-id <SUBNET_NAME> <ENV_NAME>
Additionally, consider the ``[networking]`` section in the configuration
file.
Currently, ``[networking]`` settings are common for all regions.
.. code-block:: ini
[networking]
external_network = %EXTERNAL_NETWORK_NAME%
router_name = %MURANO_ROUTER_NAME%
create_router = true
If you choose an automatic neutron configuration, configure the external
network with identical names in all regions.
If you disable the automatic router creation, create routers with
identical names in all regions.
Also, the ``default_dns`` address must be reachable from all created networks.
.. note::
To use regions, first configure them as described in :ref:`multi-region`.
|
