pulumi-cloudamqp 3.18.0a1710156088__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.

Files changed (48) hide show
  1. pulumi_cloudamqp/__init__.py +9 -0
  2. pulumi_cloudamqp/_inputs.py +157 -6
  3. pulumi_cloudamqp/_utilities.py +41 -5
  4. pulumi_cloudamqp/account_action.py +5 -0
  5. pulumi_cloudamqp/alarm.py +5 -130
  6. pulumi_cloudamqp/config/__init__.pyi +5 -0
  7. pulumi_cloudamqp/config/vars.py +5 -0
  8. pulumi_cloudamqp/custom_domain.py +7 -6
  9. pulumi_cloudamqp/extra_disk_size.py +44 -31
  10. pulumi_cloudamqp/get_account.py +12 -77
  11. pulumi_cloudamqp/get_account_vpcs.py +12 -9
  12. pulumi_cloudamqp/get_alarm.py +29 -11
  13. pulumi_cloudamqp/get_credentials.py +17 -11
  14. pulumi_cloudamqp/get_instance.py +30 -5
  15. pulumi_cloudamqp/get_nodes.py +20 -11
  16. pulumi_cloudamqp/get_notification.py +23 -11
  17. pulumi_cloudamqp/get_plugins.py +49 -14
  18. pulumi_cloudamqp/get_plugins_community.py +49 -14
  19. pulumi_cloudamqp/get_upgradable_versions.py +17 -11
  20. pulumi_cloudamqp/get_vpc_gcp_info.py +26 -17
  21. pulumi_cloudamqp/get_vpc_info.py +23 -17
  22. pulumi_cloudamqp/instance.py +68 -147
  23. pulumi_cloudamqp/integration_aws_eventbridge.py +9 -6
  24. pulumi_cloudamqp/integration_log.py +120 -121
  25. pulumi_cloudamqp/integration_metric.py +326 -23
  26. pulumi_cloudamqp/node_actions.py +57 -58
  27. pulumi_cloudamqp/notification.py +114 -87
  28. pulumi_cloudamqp/outputs.py +71 -60
  29. pulumi_cloudamqp/plugin.py +54 -35
  30. pulumi_cloudamqp/plugin_community.py +54 -35
  31. pulumi_cloudamqp/privatelink_aws.py +43 -74
  32. pulumi_cloudamqp/privatelink_azure.py +43 -74
  33. pulumi_cloudamqp/provider.py +5 -5
  34. pulumi_cloudamqp/pulumi-plugin.json +2 -1
  35. pulumi_cloudamqp/rabbit_configuration.py +5 -0
  36. pulumi_cloudamqp/security_firewall.py +70 -24
  37. pulumi_cloudamqp/upgrade_lavinmq.py +276 -0
  38. pulumi_cloudamqp/upgrade_rabbitmq.py +300 -39
  39. pulumi_cloudamqp/vpc.py +13 -6
  40. pulumi_cloudamqp/vpc_connect.py +57 -102
  41. pulumi_cloudamqp/vpc_gcp_peering.py +260 -139
  42. pulumi_cloudamqp/vpc_peering.py +19 -2
  43. pulumi_cloudamqp/webhook.py +91 -90
  44. {pulumi_cloudamqp-3.18.0a1710156088.dist-info → pulumi_cloudamqp-3.21.0a1736832130.dist-info}/METADATA +7 -6
  45. pulumi_cloudamqp-3.21.0a1736832130.dist-info/RECORD +49 -0
  46. {pulumi_cloudamqp-3.18.0a1710156088.dist-info → pulumi_cloudamqp-3.21.0a1736832130.dist-info}/WHEEL +1 -1
  47. pulumi_cloudamqp-3.18.0a1710156088.dist-info/RECORD +0 -48
  48. {pulumi_cloudamqp-3.18.0a1710156088.dist-info → pulumi_cloudamqp-3.21.0a1736832130.dist-info}/top_level.txt +0 -0
pulumi_cloudamqp/upgrade_rabbitmq.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__ = ['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
- instance_id: Optional[pulumi.Input[int]] = None):
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,60 +114,155 @@ 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 automatically upgrade to the latest possible upgradable versions for RabbitMQ and Erlang. Depending on initial versions of RabbitMQ and Erlang of the CloudAMQP instance, multiple runs may be needed to get to the latest versions. After completed upgrade, check data source `get_upgradable_versions` to see if newer versions is available. Then delete `UpgradeRabbitmq` and create it again to invoke the upgrade.
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
- > **Important Upgrade Information**
72
- > - All single node upgrades will require some downtime since RabbitMQ needs a restart.
73
- > - 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.
74
- > - Auto delete queues (queues that are marked AD) will be deleted during the update.
75
- > - 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.
76
- > - TLS 1.0 and 1.1 will not be supported after the update.
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
 
82
- <!--Start PulumiCodeChooser -->
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
+
83
189
  ```python
84
190
  import pulumi
85
191
  import pulumi_cloudamqp as cloudamqp
86
192
 
87
- versions = cloudamqp.get_upgradable_versions(instance_id=cloudamqp_instance["instance"]["id"])
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"])
88
221
  # Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
89
- upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=cloudamqp_instance["instance"]["id"])
222
+ upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=instance["id"])
90
223
  ```
91
- <!--End PulumiCodeChooser -->
92
224
 
93
- <!--Start PulumiCodeChooser -->
94
225
  ```python
95
226
  import pulumi
96
227
  import pulumi_cloudamqp as cloudamqp
97
228
 
98
- versions = cloudamqp.get_upgradable_versions(instance_id=cloudamqp_instance["instance"]["id"])
229
+ # Retrieve latest possible upgradable versions for RabbitMQ and Erlang
230
+ versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])
99
231
  ```
100
- <!--End PulumiCodeChooser -->
101
232
 
102
233
  If newer version is still available to be upgradable in the data source, re-run again.
103
234
 
104
- <!--Start PulumiCodeChooser -->
105
235
  ```python
106
236
  import pulumi
107
237
  import pulumi_cloudamqp as cloudamqp
108
238
 
109
- versions = cloudamqp.get_upgradable_versions(instance_id=cloudamqp_instance["instance"]["id"])
239
+ # Retrieve latest possible upgradable versions for RabbitMQ and Erlang
240
+ versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])
110
241
  # Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
111
- upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=cloudamqp_instance["instance"]["id"])
242
+ upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=instance["id"])
112
243
  ```
113
- <!--End PulumiCodeChooser -->
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 | - | - |
114
266
 
115
267
  ## Import
116
268
 
@@ -118,7 +270,9 @@ class UpgradeRabbitmq(pulumi.CustomResource):
118
270
 
119
271
  :param str resource_name: The name of the resource.
120
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
121
274
  :param pulumi.Input[int] instance_id: The CloudAMQP instance identifier
275
+ :param pulumi.Input[str] new_version: The new version to upgrade to
122
276
  """
123
277
  ...
124
278
  @overload
@@ -127,51 +281,132 @@ class UpgradeRabbitmq(pulumi.CustomResource):
127
281
  args: UpgradeRabbitmqArgs,
128
282
  opts: Optional[pulumi.ResourceOptions] = None):
129
283
  """
130
- This resource allows you to automatically upgrade to the latest possible upgradable versions for RabbitMQ and Erlang. Depending on initial versions of RabbitMQ and Erlang of the CloudAMQP instance, multiple runs may be needed to get to the latest versions. After completed upgrade, check data source `get_upgradable_versions` to see if newer versions is available. Then delete `UpgradeRabbitmq` and create it again to invoke the upgrade.
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.
131
285
 
132
- > **Important Upgrade Information**
133
- > - All single node upgrades will require some downtime since RabbitMQ needs a restart.
134
- > - 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.
135
- > - Auto delete queues (queues that are marked AD) will be deleted during the update.
136
- > - 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.
137
- > - TLS 1.0 and 1.1 will not be supported after the update.
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.
138
293
 
139
294
  Only available for dedicated subscription plans running ***RabbitMQ***.
140
295
 
141
296
  ## Example Usage
142
297
 
143
- <!--Start PulumiCodeChooser -->
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
+
144
308
  ```python
145
309
  import pulumi
146
310
  import pulumi_cloudamqp as cloudamqp
147
311
 
148
- versions = cloudamqp.get_upgradable_versions(instance_id=cloudamqp_instance["instance"]["id"])
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"])
149
365
  # Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
150
- upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=cloudamqp_instance["instance"]["id"])
366
+ upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=instance["id"])
151
367
  ```
152
- <!--End PulumiCodeChooser -->
153
368
 
154
- <!--Start PulumiCodeChooser -->
155
369
  ```python
156
370
  import pulumi
157
371
  import pulumi_cloudamqp as cloudamqp
158
372
 
159
- versions = cloudamqp.get_upgradable_versions(instance_id=cloudamqp_instance["instance"]["id"])
373
+ # Retrieve latest possible upgradable versions for RabbitMQ and Erlang
374
+ versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])
160
375
  ```
161
- <!--End PulumiCodeChooser -->
162
376
 
163
377
  If newer version is still available to be upgradable in the data source, re-run again.
164
378
 
165
- <!--Start PulumiCodeChooser -->
166
379
  ```python
167
380
  import pulumi
168
381
  import pulumi_cloudamqp as cloudamqp
169
382
 
170
- versions = cloudamqp.get_upgradable_versions(instance_id=cloudamqp_instance["instance"]["id"])
383
+ # Retrieve latest possible upgradable versions for RabbitMQ and Erlang
384
+ versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])
171
385
  # Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
172
- upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=cloudamqp_instance["instance"]["id"])
386
+ upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=instance["id"])
173
387
  ```
174
- <!--End PulumiCodeChooser -->
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 | - | - |
175
410
 
176
411
  ## Import
177
412
 
@@ -192,7 +427,9 @@ class UpgradeRabbitmq(pulumi.CustomResource):
192
427
  def _internal_init(__self__,
193
428
  resource_name: str,
194
429
  opts: Optional[pulumi.ResourceOptions] = None,
430
+ current_version: Optional[pulumi.Input[str]] = None,
195
431
  instance_id: Optional[pulumi.Input[int]] = None,
432
+ new_version: Optional[pulumi.Input[str]] = None,
196
433
  __props__=None):
197
434
  opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
198
435
  if not isinstance(opts, pulumi.ResourceOptions):
@@ -202,9 +439,11 @@ class UpgradeRabbitmq(pulumi.CustomResource):
202
439
  raise TypeError('__props__ is only valid when passed in combination with a valid opts.id to get an existing resource')
203
440
  __props__ = UpgradeRabbitmqArgs.__new__(UpgradeRabbitmqArgs)
204
441
 
442
+ __props__.__dict__["current_version"] = current_version
205
443
  if instance_id is None and not opts.urn:
206
444
  raise TypeError("Missing required property 'instance_id'")
207
445
  __props__.__dict__["instance_id"] = instance_id
446
+ __props__.__dict__["new_version"] = new_version
208
447
  super(UpgradeRabbitmq, __self__).__init__(
209
448
  'cloudamqp:index/upgradeRabbitmq:UpgradeRabbitmq',
210
449
  resource_name,
@@ -215,7 +454,9 @@ class UpgradeRabbitmq(pulumi.CustomResource):
215
454
  def get(resource_name: str,
216
455
  id: pulumi.Input[str],
217
456
  opts: Optional[pulumi.ResourceOptions] = None,
218
- instance_id: Optional[pulumi.Input[int]] = None) -> 'UpgradeRabbitmq':
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':
219
460
  """
220
461
  Get an existing UpgradeRabbitmq resource's state with the given name, id, and optional extra
221
462
  properties used to qualify the lookup.
@@ -223,15 +464,27 @@ class UpgradeRabbitmq(pulumi.CustomResource):
223
464
  :param str resource_name: The unique name of the resulting resource.
224
465
  :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
225
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
226
468
  :param pulumi.Input[int] instance_id: The CloudAMQP instance identifier
469
+ :param pulumi.Input[str] new_version: The new version to upgrade to
227
470
  """
228
471
  opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
229
472
 
230
473
  __props__ = _UpgradeRabbitmqState.__new__(_UpgradeRabbitmqState)
231
474
 
475
+ __props__.__dict__["current_version"] = current_version
232
476
  __props__.__dict__["instance_id"] = instance_id
477
+ __props__.__dict__["new_version"] = new_version
233
478
  return UpgradeRabbitmq(resource_name, opts=opts, __props__=__props__)
234
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
+
235
488
  @property
236
489
  @pulumi.getter(name="instanceId")
237
490
  def instance_id(self) -> pulumi.Output[int]:
@@ -240,3 +493,11 @@ class UpgradeRabbitmq(pulumi.CustomResource):
240
493
  """
241
494
  return pulumi.get(self, "instance_id")
242
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']
@@ -190,28 +195,29 @@ class Vpc(pulumi.CustomResource):
190
195
 
191
196
  ## Example Usage
192
197
 
193
- <!--Start PulumiCodeChooser -->
194
198
  ```python
195
199
  import pulumi
196
200
  import pulumi_cloudamqp as cloudamqp
197
201
 
198
202
  # Managed VPC resource
199
203
  vpc = cloudamqp.Vpc("vpc",
204
+ name="<VPC name>",
200
205
  region="amazon-web-services::us-east-1",
201
206
  subnet="10.56.72.0/24",
202
207
  tags=[])
203
208
  # New instance, need to be created with a vpc
204
209
  instance = cloudamqp.Instance("instance",
210
+ name="<Instance name>",
205
211
  plan="bunny-1",
206
212
  region="amazon-web-services::us-east-1",
207
213
  nodes=1,
208
214
  tags=[],
209
215
  rmq_version="3.9.13",
210
- vpc_id=cloudamq_vpc["vpc"]["id"],
216
+ vpc_id=vpc_cloudamq_vpc["id"],
211
217
  keep_associated_vpc=True)
218
+ # Additional VPC information
212
219
  vpc_info = cloudamqp.get_vpc_info_output(vpc_id=vpc.id)
213
220
  ```
214
- <!--End PulumiCodeChooser -->
215
221
 
216
222
  ## Import
217
223
 
@@ -249,28 +255,29 @@ class Vpc(pulumi.CustomResource):
249
255
 
250
256
  ## Example Usage
251
257
 
252
- <!--Start PulumiCodeChooser -->
253
258
  ```python
254
259
  import pulumi
255
260
  import pulumi_cloudamqp as cloudamqp
256
261
 
257
262
  # Managed VPC resource
258
263
  vpc = cloudamqp.Vpc("vpc",
264
+ name="<VPC name>",
259
265
  region="amazon-web-services::us-east-1",
260
266
  subnet="10.56.72.0/24",
261
267
  tags=[])
262
268
  # New instance, need to be created with a vpc
263
269
  instance = cloudamqp.Instance("instance",
270
+ name="<Instance name>",
264
271
  plan="bunny-1",
265
272
  region="amazon-web-services::us-east-1",
266
273
  nodes=1,
267
274
  tags=[],
268
275
  rmq_version="3.9.13",
269
- vpc_id=cloudamq_vpc["vpc"]["id"],
276
+ vpc_id=vpc_cloudamq_vpc["id"],
270
277
  keep_associated_vpc=True)
278
+ # Additional VPC information
271
279
  vpc_info = cloudamqp.get_vpc_info_output(vpc_id=vpc.id)
272
280
  ```
273
- <!--End PulumiCodeChooser -->
274
281
 
275
282
  ## Import
276
283