pulumi-cloudamqp 3.18.0a1709359306__py3-none-any.whl → 3.21.0a1736832130__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of pulumi-cloudamqp might be problematic. Click here for more details.
- pulumi_cloudamqp/__init__.py +9 -0
- pulumi_cloudamqp/_inputs.py +157 -6
- pulumi_cloudamqp/_utilities.py +41 -5
- pulumi_cloudamqp/account_action.py +5 -0
- pulumi_cloudamqp/alarm.py +5 -124
- pulumi_cloudamqp/config/__init__.pyi +5 -0
- pulumi_cloudamqp/config/vars.py +5 -0
- pulumi_cloudamqp/custom_domain.py +9 -2
- pulumi_cloudamqp/extra_disk_size.py +46 -15
- pulumi_cloudamqp/get_account.py +12 -71
- pulumi_cloudamqp/get_account_vpcs.py +14 -5
- pulumi_cloudamqp/get_alarm.py +31 -7
- pulumi_cloudamqp/get_credentials.py +19 -7
- pulumi_cloudamqp/get_instance.py +30 -47
- pulumi_cloudamqp/get_nodes.py +22 -7
- pulumi_cloudamqp/get_notification.py +25 -7
- pulumi_cloudamqp/get_plugins.py +51 -10
- pulumi_cloudamqp/get_plugins_community.py +51 -10
- pulumi_cloudamqp/get_upgradable_versions.py +19 -7
- pulumi_cloudamqp/get_vpc_gcp_info.py +28 -9
- pulumi_cloudamqp/get_vpc_info.py +25 -9
- pulumi_cloudamqp/instance.py +70 -115
- pulumi_cloudamqp/integration_aws_eventbridge.py +11 -2
- pulumi_cloudamqp/integration_log.py +432 -43
- pulumi_cloudamqp/integration_metric.py +326 -23
- pulumi_cloudamqp/node_actions.py +59 -46
- pulumi_cloudamqp/notification.py +118 -61
- pulumi_cloudamqp/outputs.py +71 -60
- pulumi_cloudamqp/plugin.py +54 -35
- pulumi_cloudamqp/plugin_community.py +56 -37
- pulumi_cloudamqp/privatelink_aws.py +49 -60
- pulumi_cloudamqp/privatelink_azure.py +49 -60
- pulumi_cloudamqp/provider.py +5 -5
- pulumi_cloudamqp/pulumi-plugin.json +2 -1
- pulumi_cloudamqp/rabbit_configuration.py +5 -0
- pulumi_cloudamqp/security_firewall.py +70 -24
- pulumi_cloudamqp/upgrade_lavinmq.py +276 -0
- pulumi_cloudamqp/upgrade_rabbitmq.py +300 -27
- pulumi_cloudamqp/vpc.py +17 -6
- pulumi_cloudamqp/vpc_connect.py +63 -80
- pulumi_cloudamqp/vpc_gcp_peering.py +310 -103
- pulumi_cloudamqp/vpc_peering.py +19 -2
- pulumi_cloudamqp/webhook.py +91 -84
- {pulumi_cloudamqp-3.18.0a1709359306.dist-info → pulumi_cloudamqp-3.21.0a1736832130.dist-info}/METADATA +7 -6
- pulumi_cloudamqp-3.21.0a1736832130.dist-info/RECORD +49 -0
- {pulumi_cloudamqp-3.18.0a1709359306.dist-info → pulumi_cloudamqp-3.21.0a1736832130.dist-info}/WHEEL +1 -1
- pulumi_cloudamqp-3.18.0a1709359306.dist-info/RECORD +0 -48
- {pulumi_cloudamqp-3.18.0a1709359306.dist-info → pulumi_cloudamqp-3.21.0a1736832130.dist-info}/top_level.txt +0 -0
|
@@ -4,9 +4,14 @@
|
|
|
4
4
|
|
|
5
5
|
import copy
|
|
6
6
|
import warnings
|
|
7
|
+
import sys
|
|
7
8
|
import pulumi
|
|
8
9
|
import pulumi.runtime
|
|
9
10
|
from typing import Any, Mapping, Optional, Sequence, Union, overload
|
|
11
|
+
if sys.version_info >= (3, 11):
|
|
12
|
+
from typing import NotRequired, TypedDict, TypeAlias
|
|
13
|
+
else:
|
|
14
|
+
from typing_extensions import NotRequired, TypedDict, TypeAlias
|
|
10
15
|
from . import _utilities
|
|
11
16
|
|
|
12
17
|
__all__ = ['UpgradeRabbitmqArgs', 'UpgradeRabbitmq']
|
|
@@ -14,12 +19,20 @@ __all__ = ['UpgradeRabbitmqArgs', 'UpgradeRabbitmq']
|
|
|
14
19
|
@pulumi.input_type
|
|
15
20
|
class UpgradeRabbitmqArgs:
|
|
16
21
|
def __init__(__self__, *,
|
|
17
|
-
instance_id: pulumi.Input[int]
|
|
22
|
+
instance_id: pulumi.Input[int],
|
|
23
|
+
current_version: Optional[pulumi.Input[str]] = None,
|
|
24
|
+
new_version: Optional[pulumi.Input[str]] = None):
|
|
18
25
|
"""
|
|
19
26
|
The set of arguments for constructing a UpgradeRabbitmq resource.
|
|
20
27
|
:param pulumi.Input[int] instance_id: The CloudAMQP instance identifier
|
|
28
|
+
:param pulumi.Input[str] current_version: Helper argument to change upgrade behaviour to latest possible version
|
|
29
|
+
:param pulumi.Input[str] new_version: The new version to upgrade to
|
|
21
30
|
"""
|
|
22
31
|
pulumi.set(__self__, "instance_id", instance_id)
|
|
32
|
+
if current_version is not None:
|
|
33
|
+
pulumi.set(__self__, "current_version", current_version)
|
|
34
|
+
if new_version is not None:
|
|
35
|
+
pulumi.set(__self__, "new_version", new_version)
|
|
23
36
|
|
|
24
37
|
@property
|
|
25
38
|
@pulumi.getter(name="instanceId")
|
|
@@ -33,17 +46,61 @@ class UpgradeRabbitmqArgs:
|
|
|
33
46
|
def instance_id(self, value: pulumi.Input[int]):
|
|
34
47
|
pulumi.set(self, "instance_id", value)
|
|
35
48
|
|
|
49
|
+
@property
|
|
50
|
+
@pulumi.getter(name="currentVersion")
|
|
51
|
+
def current_version(self) -> Optional[pulumi.Input[str]]:
|
|
52
|
+
"""
|
|
53
|
+
Helper argument to change upgrade behaviour to latest possible version
|
|
54
|
+
"""
|
|
55
|
+
return pulumi.get(self, "current_version")
|
|
56
|
+
|
|
57
|
+
@current_version.setter
|
|
58
|
+
def current_version(self, value: Optional[pulumi.Input[str]]):
|
|
59
|
+
pulumi.set(self, "current_version", value)
|
|
60
|
+
|
|
61
|
+
@property
|
|
62
|
+
@pulumi.getter(name="newVersion")
|
|
63
|
+
def new_version(self) -> Optional[pulumi.Input[str]]:
|
|
64
|
+
"""
|
|
65
|
+
The new version to upgrade to
|
|
66
|
+
"""
|
|
67
|
+
return pulumi.get(self, "new_version")
|
|
68
|
+
|
|
69
|
+
@new_version.setter
|
|
70
|
+
def new_version(self, value: Optional[pulumi.Input[str]]):
|
|
71
|
+
pulumi.set(self, "new_version", value)
|
|
72
|
+
|
|
36
73
|
|
|
37
74
|
@pulumi.input_type
|
|
38
75
|
class _UpgradeRabbitmqState:
|
|
39
76
|
def __init__(__self__, *,
|
|
40
|
-
|
|
77
|
+
current_version: Optional[pulumi.Input[str]] = None,
|
|
78
|
+
instance_id: Optional[pulumi.Input[int]] = None,
|
|
79
|
+
new_version: Optional[pulumi.Input[str]] = None):
|
|
41
80
|
"""
|
|
42
81
|
Input properties used for looking up and filtering UpgradeRabbitmq resources.
|
|
82
|
+
:param pulumi.Input[str] current_version: Helper argument to change upgrade behaviour to latest possible version
|
|
43
83
|
:param pulumi.Input[int] instance_id: The CloudAMQP instance identifier
|
|
84
|
+
:param pulumi.Input[str] new_version: The new version to upgrade to
|
|
44
85
|
"""
|
|
86
|
+
if current_version is not None:
|
|
87
|
+
pulumi.set(__self__, "current_version", current_version)
|
|
45
88
|
if instance_id is not None:
|
|
46
89
|
pulumi.set(__self__, "instance_id", instance_id)
|
|
90
|
+
if new_version is not None:
|
|
91
|
+
pulumi.set(__self__, "new_version", new_version)
|
|
92
|
+
|
|
93
|
+
@property
|
|
94
|
+
@pulumi.getter(name="currentVersion")
|
|
95
|
+
def current_version(self) -> Optional[pulumi.Input[str]]:
|
|
96
|
+
"""
|
|
97
|
+
Helper argument to change upgrade behaviour to latest possible version
|
|
98
|
+
"""
|
|
99
|
+
return pulumi.get(self, "current_version")
|
|
100
|
+
|
|
101
|
+
@current_version.setter
|
|
102
|
+
def current_version(self, value: Optional[pulumi.Input[str]]):
|
|
103
|
+
pulumi.set(self, "current_version", value)
|
|
47
104
|
|
|
48
105
|
@property
|
|
49
106
|
@pulumi.getter(name="instanceId")
|
|
@@ -57,42 +114,120 @@ class _UpgradeRabbitmqState:
|
|
|
57
114
|
def instance_id(self, value: Optional[pulumi.Input[int]]):
|
|
58
115
|
pulumi.set(self, "instance_id", value)
|
|
59
116
|
|
|
117
|
+
@property
|
|
118
|
+
@pulumi.getter(name="newVersion")
|
|
119
|
+
def new_version(self) -> Optional[pulumi.Input[str]]:
|
|
120
|
+
"""
|
|
121
|
+
The new version to upgrade to
|
|
122
|
+
"""
|
|
123
|
+
return pulumi.get(self, "new_version")
|
|
124
|
+
|
|
125
|
+
@new_version.setter
|
|
126
|
+
def new_version(self, value: Optional[pulumi.Input[str]]):
|
|
127
|
+
pulumi.set(self, "new_version", value)
|
|
128
|
+
|
|
60
129
|
|
|
61
130
|
class UpgradeRabbitmq(pulumi.CustomResource):
|
|
62
131
|
@overload
|
|
63
132
|
def __init__(__self__,
|
|
64
133
|
resource_name: str,
|
|
65
134
|
opts: Optional[pulumi.ResourceOptions] = None,
|
|
135
|
+
current_version: Optional[pulumi.Input[str]] = None,
|
|
66
136
|
instance_id: Optional[pulumi.Input[int]] = None,
|
|
137
|
+
new_version: Optional[pulumi.Input[str]] = None,
|
|
67
138
|
__props__=None):
|
|
68
139
|
"""
|
|
69
|
-
This resource allows you to
|
|
140
|
+
This resource allows you to upgrade RabbitMQ version. Depending on initial versions of RabbitMQ and Erlang of the CloudAMQP instance, multiple runs may be needed to get to the latest or wanted version. Reason for this is certain supported RabbitMQ version will also automatically upgrade Erlang version.
|
|
70
141
|
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
> -
|
|
74
|
-
> -
|
|
75
|
-
> -
|
|
76
|
-
|
|
142
|
+
There is three different ways to trigger the version upgrade
|
|
143
|
+
|
|
144
|
+
> - Specify RabbitMQ version to upgrade to
|
|
145
|
+
> - Upgrade to latest RabbitMQ version
|
|
146
|
+
> - Old behaviour to upgrade to latest RabbitMQ version
|
|
147
|
+
|
|
148
|
+
See, below example usage for the difference.
|
|
77
149
|
|
|
78
150
|
Only available for dedicated subscription plans running ***RabbitMQ***.
|
|
79
151
|
|
|
80
152
|
## Example Usage
|
|
81
153
|
|
|
154
|
+
<details>
|
|
155
|
+
<summary>
|
|
156
|
+
<b>
|
|
157
|
+
<i>Specify version upgrade, from v1.31.0</i>
|
|
158
|
+
</b>
|
|
159
|
+
</summary>
|
|
160
|
+
|
|
161
|
+
Specify the version to upgrade to. List available upgradable versions, use [CloudAMQP API](https://docs.cloudamqp.com/cloudamqp_api.html#get-available-versions).
|
|
162
|
+
After the upgrade finished, there can still be newer versions available.
|
|
163
|
+
|
|
164
|
+
```python
|
|
165
|
+
import pulumi
|
|
166
|
+
import pulumi_cloudamqp as cloudamqp
|
|
167
|
+
|
|
168
|
+
instance = cloudamqp.Instance("instance",
|
|
169
|
+
name="rabbitmq-version-upgrade-test",
|
|
170
|
+
plan="bunny-1",
|
|
171
|
+
region="amazon-web-services::us-west-1")
|
|
172
|
+
upgrade = cloudamqp.UpgradeRabbitmq("upgrade",
|
|
173
|
+
instance_id=instance.id,
|
|
174
|
+
new_version="3.13.2")
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
</details>
|
|
178
|
+
|
|
179
|
+
<details>
|
|
180
|
+
<summary>
|
|
181
|
+
<b>
|
|
182
|
+
<i>Upgrade to latest possible version, from v1.31.0</i>
|
|
183
|
+
</b>
|
|
184
|
+
</summary>
|
|
185
|
+
|
|
186
|
+
This will upgrade RabbitMQ to the latest possible version detected by the data source `get_upgradable_versions`.
|
|
187
|
+
Multiple runs can be needed to upgrade the version even further.
|
|
188
|
+
|
|
82
189
|
```python
|
|
83
190
|
import pulumi
|
|
84
191
|
import pulumi_cloudamqp as cloudamqp
|
|
85
192
|
|
|
86
|
-
|
|
193
|
+
instance = cloudamqp.Instance("instance",
|
|
194
|
+
name="rabbitmq-version-upgrade-test",
|
|
195
|
+
plan="bunny-1",
|
|
196
|
+
region="amazon-web-services::us-west-1")
|
|
197
|
+
upgradable_versions = instance.id.apply(lambda id: cloudamqp.get_upgradable_versions_output(instance_id=id))
|
|
198
|
+
upgrade = cloudamqp.UpgradeRabbitmq("upgrade",
|
|
199
|
+
instance_id=instance.id,
|
|
200
|
+
current_version=instance.rmq_version,
|
|
201
|
+
new_version=upgradable_versions.new_rabbitmq_version)
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
</details>
|
|
205
|
+
|
|
206
|
+
<details>
|
|
207
|
+
<summary>
|
|
208
|
+
<b>
|
|
209
|
+
<i>Upgrade to latest possible version, before v1.31.0</i>
|
|
210
|
+
</b>
|
|
211
|
+
</summary>
|
|
212
|
+
|
|
213
|
+
Old behaviour of the upgrading the RabbitMQ version. No longer recommended.
|
|
214
|
+
|
|
215
|
+
```python
|
|
216
|
+
import pulumi
|
|
217
|
+
import pulumi_cloudamqp as cloudamqp
|
|
218
|
+
|
|
219
|
+
# Retrieve latest possible upgradable versions for RabbitMQ and Erlang
|
|
220
|
+
versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])
|
|
87
221
|
# Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
|
|
88
|
-
upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=
|
|
222
|
+
upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=instance["id"])
|
|
89
223
|
```
|
|
90
224
|
|
|
91
225
|
```python
|
|
92
226
|
import pulumi
|
|
93
227
|
import pulumi_cloudamqp as cloudamqp
|
|
94
228
|
|
|
95
|
-
versions
|
|
229
|
+
# Retrieve latest possible upgradable versions for RabbitMQ and Erlang
|
|
230
|
+
versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])
|
|
96
231
|
```
|
|
97
232
|
|
|
98
233
|
If newer version is still available to be upgradable in the data source, re-run again.
|
|
@@ -101,18 +236,43 @@ class UpgradeRabbitmq(pulumi.CustomResource):
|
|
|
101
236
|
import pulumi
|
|
102
237
|
import pulumi_cloudamqp as cloudamqp
|
|
103
238
|
|
|
104
|
-
versions
|
|
239
|
+
# Retrieve latest possible upgradable versions for RabbitMQ and Erlang
|
|
240
|
+
versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])
|
|
105
241
|
# Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
|
|
106
|
-
upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=
|
|
242
|
+
upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=instance["id"])
|
|
107
243
|
```
|
|
108
244
|
|
|
245
|
+
</details>
|
|
246
|
+
|
|
247
|
+
## Important Upgrade Information
|
|
248
|
+
|
|
249
|
+
> - All single node upgrades will require some downtime since RabbitMQ needs a restart.
|
|
250
|
+
> - From RabbitMQ version 3.9, rolling upgrades between minor versions (e.g. 3.9 to 3.10), in a multi-node cluster are possible without downtime. This means that one node is upgraded at a time while the other nodes are still running. For versions older than 3.9, patch version upgrades (e.g. 3.8.x to 3.8.y) are possible without downtime in a multi-node cluster, but minor version upgrades will require downtime.
|
|
251
|
+
> - Auto delete queues (queues that are marked AD) will be deleted during the update.
|
|
252
|
+
> - Any custom plugins support has installed on your behalf will be disabled and you need to contact support@cloudamqp.com and ask to have them re-installed.
|
|
253
|
+
> - TLS 1.0 and 1.1 will not be supported after the update.
|
|
254
|
+
|
|
255
|
+
## Multiple runs
|
|
256
|
+
|
|
257
|
+
Depending on initial versions of RabbitMQ and Erlang of the CloudAMQP instance, multiple runs may be needed to get to the latest or wanted version.
|
|
258
|
+
|
|
259
|
+
Example steps needed when starting at RabbitMQ version 3.12.2
|
|
260
|
+
|
|
261
|
+
| Version | Supported upgrading versions | Min version to upgrade Erlang |
|
|
262
|
+
|------------------|-------------------------------------------|-------------------------------|
|
|
263
|
+
| 3.12.2 | 3.12.4, 3.12.6, 3.12.10, 3.12.12, 3.12.13 | 3.12.13 |
|
|
264
|
+
| 3.12.13 | 3.13.2 | 3.13.2 |
|
|
265
|
+
| 3.13.2 | - | - |
|
|
266
|
+
|
|
109
267
|
## Import
|
|
110
268
|
|
|
111
269
|
Not possible to import this resource.
|
|
112
270
|
|
|
113
271
|
:param str resource_name: The name of the resource.
|
|
114
272
|
:param pulumi.ResourceOptions opts: Options for the resource.
|
|
273
|
+
:param pulumi.Input[str] current_version: Helper argument to change upgrade behaviour to latest possible version
|
|
115
274
|
:param pulumi.Input[int] instance_id: The CloudAMQP instance identifier
|
|
275
|
+
:param pulumi.Input[str] new_version: The new version to upgrade to
|
|
116
276
|
"""
|
|
117
277
|
...
|
|
118
278
|
@overload
|
|
@@ -121,33 +281,97 @@ class UpgradeRabbitmq(pulumi.CustomResource):
|
|
|
121
281
|
args: UpgradeRabbitmqArgs,
|
|
122
282
|
opts: Optional[pulumi.ResourceOptions] = None):
|
|
123
283
|
"""
|
|
124
|
-
This resource allows you to
|
|
284
|
+
This resource allows you to upgrade RabbitMQ version. Depending on initial versions of RabbitMQ and Erlang of the CloudAMQP instance, multiple runs may be needed to get to the latest or wanted version. Reason for this is certain supported RabbitMQ version will also automatically upgrade Erlang version.
|
|
125
285
|
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
> -
|
|
129
|
-
> -
|
|
130
|
-
> -
|
|
131
|
-
|
|
286
|
+
There is three different ways to trigger the version upgrade
|
|
287
|
+
|
|
288
|
+
> - Specify RabbitMQ version to upgrade to
|
|
289
|
+
> - Upgrade to latest RabbitMQ version
|
|
290
|
+
> - Old behaviour to upgrade to latest RabbitMQ version
|
|
291
|
+
|
|
292
|
+
See, below example usage for the difference.
|
|
132
293
|
|
|
133
294
|
Only available for dedicated subscription plans running ***RabbitMQ***.
|
|
134
295
|
|
|
135
296
|
## Example Usage
|
|
136
297
|
|
|
298
|
+
<details>
|
|
299
|
+
<summary>
|
|
300
|
+
<b>
|
|
301
|
+
<i>Specify version upgrade, from v1.31.0</i>
|
|
302
|
+
</b>
|
|
303
|
+
</summary>
|
|
304
|
+
|
|
305
|
+
Specify the version to upgrade to. List available upgradable versions, use [CloudAMQP API](https://docs.cloudamqp.com/cloudamqp_api.html#get-available-versions).
|
|
306
|
+
After the upgrade finished, there can still be newer versions available.
|
|
307
|
+
|
|
137
308
|
```python
|
|
138
309
|
import pulumi
|
|
139
310
|
import pulumi_cloudamqp as cloudamqp
|
|
140
311
|
|
|
141
|
-
|
|
312
|
+
instance = cloudamqp.Instance("instance",
|
|
313
|
+
name="rabbitmq-version-upgrade-test",
|
|
314
|
+
plan="bunny-1",
|
|
315
|
+
region="amazon-web-services::us-west-1")
|
|
316
|
+
upgrade = cloudamqp.UpgradeRabbitmq("upgrade",
|
|
317
|
+
instance_id=instance.id,
|
|
318
|
+
new_version="3.13.2")
|
|
319
|
+
```
|
|
320
|
+
|
|
321
|
+
</details>
|
|
322
|
+
|
|
323
|
+
<details>
|
|
324
|
+
<summary>
|
|
325
|
+
<b>
|
|
326
|
+
<i>Upgrade to latest possible version, from v1.31.0</i>
|
|
327
|
+
</b>
|
|
328
|
+
</summary>
|
|
329
|
+
|
|
330
|
+
This will upgrade RabbitMQ to the latest possible version detected by the data source `get_upgradable_versions`.
|
|
331
|
+
Multiple runs can be needed to upgrade the version even further.
|
|
332
|
+
|
|
333
|
+
```python
|
|
334
|
+
import pulumi
|
|
335
|
+
import pulumi_cloudamqp as cloudamqp
|
|
336
|
+
|
|
337
|
+
instance = cloudamqp.Instance("instance",
|
|
338
|
+
name="rabbitmq-version-upgrade-test",
|
|
339
|
+
plan="bunny-1",
|
|
340
|
+
region="amazon-web-services::us-west-1")
|
|
341
|
+
upgradable_versions = instance.id.apply(lambda id: cloudamqp.get_upgradable_versions_output(instance_id=id))
|
|
342
|
+
upgrade = cloudamqp.UpgradeRabbitmq("upgrade",
|
|
343
|
+
instance_id=instance.id,
|
|
344
|
+
current_version=instance.rmq_version,
|
|
345
|
+
new_version=upgradable_versions.new_rabbitmq_version)
|
|
346
|
+
```
|
|
347
|
+
|
|
348
|
+
</details>
|
|
349
|
+
|
|
350
|
+
<details>
|
|
351
|
+
<summary>
|
|
352
|
+
<b>
|
|
353
|
+
<i>Upgrade to latest possible version, before v1.31.0</i>
|
|
354
|
+
</b>
|
|
355
|
+
</summary>
|
|
356
|
+
|
|
357
|
+
Old behaviour of the upgrading the RabbitMQ version. No longer recommended.
|
|
358
|
+
|
|
359
|
+
```python
|
|
360
|
+
import pulumi
|
|
361
|
+
import pulumi_cloudamqp as cloudamqp
|
|
362
|
+
|
|
363
|
+
# Retrieve latest possible upgradable versions for RabbitMQ and Erlang
|
|
364
|
+
versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])
|
|
142
365
|
# Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
|
|
143
|
-
upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=
|
|
366
|
+
upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=instance["id"])
|
|
144
367
|
```
|
|
145
368
|
|
|
146
369
|
```python
|
|
147
370
|
import pulumi
|
|
148
371
|
import pulumi_cloudamqp as cloudamqp
|
|
149
372
|
|
|
150
|
-
versions
|
|
373
|
+
# Retrieve latest possible upgradable versions for RabbitMQ and Erlang
|
|
374
|
+
versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])
|
|
151
375
|
```
|
|
152
376
|
|
|
153
377
|
If newer version is still available to be upgradable in the data source, re-run again.
|
|
@@ -156,11 +380,34 @@ class UpgradeRabbitmq(pulumi.CustomResource):
|
|
|
156
380
|
import pulumi
|
|
157
381
|
import pulumi_cloudamqp as cloudamqp
|
|
158
382
|
|
|
159
|
-
versions
|
|
383
|
+
# Retrieve latest possible upgradable versions for RabbitMQ and Erlang
|
|
384
|
+
versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])
|
|
160
385
|
# Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
|
|
161
|
-
upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=
|
|
386
|
+
upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=instance["id"])
|
|
162
387
|
```
|
|
163
388
|
|
|
389
|
+
</details>
|
|
390
|
+
|
|
391
|
+
## Important Upgrade Information
|
|
392
|
+
|
|
393
|
+
> - All single node upgrades will require some downtime since RabbitMQ needs a restart.
|
|
394
|
+
> - From RabbitMQ version 3.9, rolling upgrades between minor versions (e.g. 3.9 to 3.10), in a multi-node cluster are possible without downtime. This means that one node is upgraded at a time while the other nodes are still running. For versions older than 3.9, patch version upgrades (e.g. 3.8.x to 3.8.y) are possible without downtime in a multi-node cluster, but minor version upgrades will require downtime.
|
|
395
|
+
> - Auto delete queues (queues that are marked AD) will be deleted during the update.
|
|
396
|
+
> - Any custom plugins support has installed on your behalf will be disabled and you need to contact support@cloudamqp.com and ask to have them re-installed.
|
|
397
|
+
> - TLS 1.0 and 1.1 will not be supported after the update.
|
|
398
|
+
|
|
399
|
+
## Multiple runs
|
|
400
|
+
|
|
401
|
+
Depending on initial versions of RabbitMQ and Erlang of the CloudAMQP instance, multiple runs may be needed to get to the latest or wanted version.
|
|
402
|
+
|
|
403
|
+
Example steps needed when starting at RabbitMQ version 3.12.2
|
|
404
|
+
|
|
405
|
+
| Version | Supported upgrading versions | Min version to upgrade Erlang |
|
|
406
|
+
|------------------|-------------------------------------------|-------------------------------|
|
|
407
|
+
| 3.12.2 | 3.12.4, 3.12.6, 3.12.10, 3.12.12, 3.12.13 | 3.12.13 |
|
|
408
|
+
| 3.12.13 | 3.13.2 | 3.13.2 |
|
|
409
|
+
| 3.13.2 | - | - |
|
|
410
|
+
|
|
164
411
|
## Import
|
|
165
412
|
|
|
166
413
|
Not possible to import this resource.
|
|
@@ -180,7 +427,9 @@ class UpgradeRabbitmq(pulumi.CustomResource):
|
|
|
180
427
|
def _internal_init(__self__,
|
|
181
428
|
resource_name: str,
|
|
182
429
|
opts: Optional[pulumi.ResourceOptions] = None,
|
|
430
|
+
current_version: Optional[pulumi.Input[str]] = None,
|
|
183
431
|
instance_id: Optional[pulumi.Input[int]] = None,
|
|
432
|
+
new_version: Optional[pulumi.Input[str]] = None,
|
|
184
433
|
__props__=None):
|
|
185
434
|
opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
|
|
186
435
|
if not isinstance(opts, pulumi.ResourceOptions):
|
|
@@ -190,9 +439,11 @@ class UpgradeRabbitmq(pulumi.CustomResource):
|
|
|
190
439
|
raise TypeError('__props__ is only valid when passed in combination with a valid opts.id to get an existing resource')
|
|
191
440
|
__props__ = UpgradeRabbitmqArgs.__new__(UpgradeRabbitmqArgs)
|
|
192
441
|
|
|
442
|
+
__props__.__dict__["current_version"] = current_version
|
|
193
443
|
if instance_id is None and not opts.urn:
|
|
194
444
|
raise TypeError("Missing required property 'instance_id'")
|
|
195
445
|
__props__.__dict__["instance_id"] = instance_id
|
|
446
|
+
__props__.__dict__["new_version"] = new_version
|
|
196
447
|
super(UpgradeRabbitmq, __self__).__init__(
|
|
197
448
|
'cloudamqp:index/upgradeRabbitmq:UpgradeRabbitmq',
|
|
198
449
|
resource_name,
|
|
@@ -203,7 +454,9 @@ class UpgradeRabbitmq(pulumi.CustomResource):
|
|
|
203
454
|
def get(resource_name: str,
|
|
204
455
|
id: pulumi.Input[str],
|
|
205
456
|
opts: Optional[pulumi.ResourceOptions] = None,
|
|
206
|
-
|
|
457
|
+
current_version: Optional[pulumi.Input[str]] = None,
|
|
458
|
+
instance_id: Optional[pulumi.Input[int]] = None,
|
|
459
|
+
new_version: Optional[pulumi.Input[str]] = None) -> 'UpgradeRabbitmq':
|
|
207
460
|
"""
|
|
208
461
|
Get an existing UpgradeRabbitmq resource's state with the given name, id, and optional extra
|
|
209
462
|
properties used to qualify the lookup.
|
|
@@ -211,15 +464,27 @@ class UpgradeRabbitmq(pulumi.CustomResource):
|
|
|
211
464
|
:param str resource_name: The unique name of the resulting resource.
|
|
212
465
|
:param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
|
|
213
466
|
:param pulumi.ResourceOptions opts: Options for the resource.
|
|
467
|
+
:param pulumi.Input[str] current_version: Helper argument to change upgrade behaviour to latest possible version
|
|
214
468
|
:param pulumi.Input[int] instance_id: The CloudAMQP instance identifier
|
|
469
|
+
:param pulumi.Input[str] new_version: The new version to upgrade to
|
|
215
470
|
"""
|
|
216
471
|
opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
|
|
217
472
|
|
|
218
473
|
__props__ = _UpgradeRabbitmqState.__new__(_UpgradeRabbitmqState)
|
|
219
474
|
|
|
475
|
+
__props__.__dict__["current_version"] = current_version
|
|
220
476
|
__props__.__dict__["instance_id"] = instance_id
|
|
477
|
+
__props__.__dict__["new_version"] = new_version
|
|
221
478
|
return UpgradeRabbitmq(resource_name, opts=opts, __props__=__props__)
|
|
222
479
|
|
|
480
|
+
@property
|
|
481
|
+
@pulumi.getter(name="currentVersion")
|
|
482
|
+
def current_version(self) -> pulumi.Output[Optional[str]]:
|
|
483
|
+
"""
|
|
484
|
+
Helper argument to change upgrade behaviour to latest possible version
|
|
485
|
+
"""
|
|
486
|
+
return pulumi.get(self, "current_version")
|
|
487
|
+
|
|
223
488
|
@property
|
|
224
489
|
@pulumi.getter(name="instanceId")
|
|
225
490
|
def instance_id(self) -> pulumi.Output[int]:
|
|
@@ -228,3 +493,11 @@ class UpgradeRabbitmq(pulumi.CustomResource):
|
|
|
228
493
|
"""
|
|
229
494
|
return pulumi.get(self, "instance_id")
|
|
230
495
|
|
|
496
|
+
@property
|
|
497
|
+
@pulumi.getter(name="newVersion")
|
|
498
|
+
def new_version(self) -> pulumi.Output[Optional[str]]:
|
|
499
|
+
"""
|
|
500
|
+
The new version to upgrade to
|
|
501
|
+
"""
|
|
502
|
+
return pulumi.get(self, "new_version")
|
|
503
|
+
|
pulumi_cloudamqp/vpc.py
CHANGED
|
@@ -4,9 +4,14 @@
|
|
|
4
4
|
|
|
5
5
|
import copy
|
|
6
6
|
import warnings
|
|
7
|
+
import sys
|
|
7
8
|
import pulumi
|
|
8
9
|
import pulumi.runtime
|
|
9
10
|
from typing import Any, Mapping, Optional, Sequence, Union, overload
|
|
11
|
+
if sys.version_info >= (3, 11):
|
|
12
|
+
from typing import NotRequired, TypedDict, TypeAlias
|
|
13
|
+
else:
|
|
14
|
+
from typing_extensions import NotRequired, TypedDict, TypeAlias
|
|
10
15
|
from . import _utilities
|
|
11
16
|
|
|
12
17
|
__all__ = ['VpcArgs', 'Vpc']
|
|
@@ -196,18 +201,21 @@ class Vpc(pulumi.CustomResource):
|
|
|
196
201
|
|
|
197
202
|
# Managed VPC resource
|
|
198
203
|
vpc = cloudamqp.Vpc("vpc",
|
|
204
|
+
name="<VPC name>",
|
|
199
205
|
region="amazon-web-services::us-east-1",
|
|
200
206
|
subnet="10.56.72.0/24",
|
|
201
207
|
tags=[])
|
|
202
208
|
# New instance, need to be created with a vpc
|
|
203
209
|
instance = cloudamqp.Instance("instance",
|
|
210
|
+
name="<Instance name>",
|
|
204
211
|
plan="bunny-1",
|
|
205
212
|
region="amazon-web-services::us-east-1",
|
|
206
213
|
nodes=1,
|
|
207
214
|
tags=[],
|
|
208
215
|
rmq_version="3.9.13",
|
|
209
|
-
vpc_id=
|
|
216
|
+
vpc_id=vpc_cloudamq_vpc["id"],
|
|
210
217
|
keep_associated_vpc=True)
|
|
218
|
+
# Additional VPC information
|
|
211
219
|
vpc_info = cloudamqp.get_vpc_info_output(vpc_id=vpc.id)
|
|
212
220
|
```
|
|
213
221
|
|
|
@@ -219,9 +227,9 @@ class Vpc(pulumi.CustomResource):
|
|
|
219
227
|
$ pulumi import cloudamqp:index/vpc:Vpc <resource_name> <vpc_id>`
|
|
220
228
|
```
|
|
221
229
|
|
|
222
|
-
|
|
230
|
+
To retrieve the identifier for a VPC, either use [CloudAMQP customer API](https://docs.cloudamqp.com/#list-vpcs).
|
|
223
231
|
|
|
224
|
-
|
|
232
|
+
Or use the data source `cloudamqp_account_vpcs` to list all available standalone VPCs for an account.
|
|
225
233
|
|
|
226
234
|
:param str resource_name: The name of the resource.
|
|
227
235
|
:param pulumi.ResourceOptions opts: Options for the resource.
|
|
@@ -253,18 +261,21 @@ class Vpc(pulumi.CustomResource):
|
|
|
253
261
|
|
|
254
262
|
# Managed VPC resource
|
|
255
263
|
vpc = cloudamqp.Vpc("vpc",
|
|
264
|
+
name="<VPC name>",
|
|
256
265
|
region="amazon-web-services::us-east-1",
|
|
257
266
|
subnet="10.56.72.0/24",
|
|
258
267
|
tags=[])
|
|
259
268
|
# New instance, need to be created with a vpc
|
|
260
269
|
instance = cloudamqp.Instance("instance",
|
|
270
|
+
name="<Instance name>",
|
|
261
271
|
plan="bunny-1",
|
|
262
272
|
region="amazon-web-services::us-east-1",
|
|
263
273
|
nodes=1,
|
|
264
274
|
tags=[],
|
|
265
275
|
rmq_version="3.9.13",
|
|
266
|
-
vpc_id=
|
|
276
|
+
vpc_id=vpc_cloudamq_vpc["id"],
|
|
267
277
|
keep_associated_vpc=True)
|
|
278
|
+
# Additional VPC information
|
|
268
279
|
vpc_info = cloudamqp.get_vpc_info_output(vpc_id=vpc.id)
|
|
269
280
|
```
|
|
270
281
|
|
|
@@ -276,9 +287,9 @@ class Vpc(pulumi.CustomResource):
|
|
|
276
287
|
$ pulumi import cloudamqp:index/vpc:Vpc <resource_name> <vpc_id>`
|
|
277
288
|
```
|
|
278
289
|
|
|
279
|
-
|
|
290
|
+
To retrieve the identifier for a VPC, either use [CloudAMQP customer API](https://docs.cloudamqp.com/#list-vpcs).
|
|
280
291
|
|
|
281
|
-
|
|
292
|
+
Or use the data source `cloudamqp_account_vpcs` to list all available standalone VPCs for an account.
|
|
282
293
|
|
|
283
294
|
:param str resource_name: The name of the resource.
|
|
284
295
|
:param VpcArgs args: The arguments to use to populate this resource's properties.
|