Package com.pulumi.cloudamqp

Class UpgradeRabbitmq

  • public class UpgradeRabbitmq
extends com.pulumi.resources.CustomResource
    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 `cloudamqp.getUpgradableVersions` to see if newer versions is available. Then delete `cloudamqp.UpgradeRabbitmq` and create it again to invoke the upgrade. > **Important Upgrade Information** > - All single node upgrades will require some downtime since RabbitMQ needs a restart. > - 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. > - Auto delete queues (queues that are marked AD) will be deleted during the update. > - 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. > - TLS 1.0 and 1.1 will not be supported after the update. Only available for dedicated subscription plans running ***RabbitMQ***. ## Example Usage ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.cloudamqp.CloudamqpFunctions; import com.pulumi.cloudamqp.inputs.GetUpgradableVersionsArgs; import com.pulumi.cloudamqp.UpgradeRabbitmq; import com.pulumi.cloudamqp.UpgradeRabbitmqArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { final var versions = CloudamqpFunctions.getUpgradableVersions(GetUpgradableVersionsArgs.builder() .instanceId(cloudamqp_instance.instance().id()) .build()); var upgrade = new UpgradeRabbitmq("upgrade", UpgradeRabbitmqArgs.builder() .instanceId(cloudamqp_instance.instance().id()) .build()); } } ``` ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.cloudamqp.CloudamqpFunctions; import com.pulumi.cloudamqp.inputs.GetUpgradableVersionsArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { final var versions = CloudamqpFunctions.getUpgradableVersions(GetUpgradableVersionsArgs.builder() .instanceId(cloudamqp_instance.instance().id()) .build()); } } ``` If newer version is still available to be upgradable in the data source, re-run again. ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.cloudamqp.CloudamqpFunctions; import com.pulumi.cloudamqp.inputs.GetUpgradableVersionsArgs; import com.pulumi.cloudamqp.UpgradeRabbitmq; import com.pulumi.cloudamqp.UpgradeRabbitmqArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { final var versions = CloudamqpFunctions.getUpgradableVersions(GetUpgradableVersionsArgs.builder() .instanceId(cloudamqp_instance.instance().id()) .build()); var upgrade = new UpgradeRabbitmq("upgrade", UpgradeRabbitmqArgs.builder() .instanceId(cloudamqp_instance.instance().id()) .build()); } } ``` ## Import Not possible to import this resource.

    • Nested Class Summary

      • Nested classes/interfaces inherited from class com.pulumi.resources.CustomResource

        com.pulumi.resources.CustomResource.CustomResourceInternal

      • Nested classes/interfaces inherited from class com.pulumi.resources.Resource

        com.pulumi.resources.Resource.LazyField<T extends java.lang.Object>, com.pulumi.resources.Resource.LazyFields, com.pulumi.resources.Resource.ResourceInternal

    • Field Summary

      • Fields inherited from class com.pulumi.resources.Resource

        childResources, remote

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      static UpgradeRabbitmq get​(java.lang.String name, com.pulumi.core.Output<java.lang.String> id, UpgradeRabbitmqState state, com.pulumi.resources.CustomResourceOptions options)
      Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
      com.pulumi.core.Output<java.lang.Integer> instanceId()  

      • Methods inherited from class com.pulumi.resources.CustomResource

        getId, id, idFuture

      • Methods inherited from class com.pulumi.resources.Resource

        getChildResources, getResourceName, getResourceType, getUrn, pulumiChildResources, pulumiResourceName, pulumiResourceType, urn

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • UpgradeRabbitmq

        public UpgradeRabbitmq​(java.lang.String name)
        Parameters:
        name - The _unique_ name of the resulting resource.

      • UpgradeRabbitmq

        public UpgradeRabbitmq​(java.lang.String name,
                       UpgradeRabbitmqArgs args)
        Parameters:
        name - The _unique_ name of the resulting resource.
        args - The arguments to use to populate this resource's properties.

      • UpgradeRabbitmq

        public UpgradeRabbitmq​(java.lang.String name,
                       UpgradeRabbitmqArgs args,
                       @Nullable
                       com.pulumi.resources.CustomResourceOptions options)
        Parameters:
        name - The _unique_ name of the resulting resource.
        args - The arguments to use to populate this resource's properties.
        options - A bag of options that control this resource's behavior.

    • Method Detail

      • instanceId

        public com.pulumi.core.Output<java.lang.Integer> instanceId()
        Returns:
        The CloudAMQP instance identifier

      • get

        public static UpgradeRabbitmq get​(java.lang.String name,
                                  com.pulumi.core.Output<java.lang.String> id,
                                  @Nullable
                                  UpgradeRabbitmqState state,
                                  @Nullable
                                  com.pulumi.resources.CustomResourceOptions options)
        Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
        Parameters:
        name - The _unique_ name of the resulting resource.
        id - The _unique_ provider ID of the resource to lookup.
        state -
        options - Optional settings to control the behavior of the CustomResource.