CloudAMQP v3.18.0, Jun 13 24

CloudAMQP v3.18.0 published on Thursday, Jun 13, 2024 by Pulumi

cloudamqp.UpgradeRabbitmq

Explore with Pulumi AI

CloudAMQP v3.18.0 published on Thursday, Jun 13, 2024 by Pulumi

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

import * as pulumi from "@pulumi/pulumi";
import * as cloudamqp from "@pulumi/cloudamqp";

// Retrieve latest possible upgradable versions for RabbitMQ and Erlang
const versions = cloudamqp.getUpgradableVersions({
    instanceId: instance.id,
});
// Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
const upgrade = new cloudamqp.UpgradeRabbitmq("upgrade", {instanceId: instance.id});

import pulumi
import pulumi_cloudamqp as cloudamqp

# Retrieve latest possible upgradable versions for RabbitMQ and Erlang
versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])
# Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=instance["id"])

package main

import (
	"github.com/pulumi/pulumi-cloudamqp/sdk/v3/go/cloudamqp"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		// Retrieve latest possible upgradable versions for RabbitMQ and Erlang
		_, err := cloudamqp.GetUpgradableVersions(ctx, &cloudamqp.GetUpgradableVersionsArgs{
			InstanceId: instance.Id,
		}, nil)
		if err != nil {
			return err
		}
		// Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
		_, err = cloudamqp.NewUpgradeRabbitmq(ctx, "upgrade", &cloudamqp.UpgradeRabbitmqArgs{
			InstanceId: pulumi.Any(instance.Id),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using CloudAmqp = Pulumi.CloudAmqp;

return await Deployment.RunAsync(() => 
{
    // Retrieve latest possible upgradable versions for RabbitMQ and Erlang
    var versions = CloudAmqp.GetUpgradableVersions.Invoke(new()
    {
        InstanceId = instance.Id,
    });

    // Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
    var upgrade = new CloudAmqp.UpgradeRabbitmq("upgrade", new()
    {
        InstanceId = instance.Id,
    });

});

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) {
        // Retrieve latest possible upgradable versions for RabbitMQ and Erlang
        final var versions = CloudamqpFunctions.getUpgradableVersions(GetUpgradableVersionsArgs.builder()
            .instanceId(instance.id())
            .build());

        // Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
        var upgrade = new UpgradeRabbitmq("upgrade", UpgradeRabbitmqArgs.builder()
            .instanceId(instance.id())
            .build());

    }
}

resources:
  # Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
  upgrade:
    type: cloudamqp:UpgradeRabbitmq
    properties:
      instanceId: ${instance.id}
variables:
  # Retrieve latest possible upgradable versions for RabbitMQ and Erlang
  versions:
    fn::invoke:
      Function: cloudamqp:getUpgradableVersions
      Arguments:
        instanceId: ${instance.id}

import * as pulumi from "@pulumi/pulumi";
import * as cloudamqp from "@pulumi/cloudamqp";

// Retrieve latest possible upgradable versions for RabbitMQ and Erlang
const versions = cloudamqp.getUpgradableVersions({
    instanceId: instance.id,
});

import pulumi
import pulumi_cloudamqp as cloudamqp

# Retrieve latest possible upgradable versions for RabbitMQ and Erlang
versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])

package main

import (
	"github.com/pulumi/pulumi-cloudamqp/sdk/v3/go/cloudamqp"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		// Retrieve latest possible upgradable versions for RabbitMQ and Erlang
		_, err := cloudamqp.GetUpgradableVersions(ctx, &cloudamqp.GetUpgradableVersionsArgs{
			InstanceId: instance.Id,
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using CloudAmqp = Pulumi.CloudAmqp;

return await Deployment.RunAsync(() => 
{
    // Retrieve latest possible upgradable versions for RabbitMQ and Erlang
    var versions = CloudAmqp.GetUpgradableVersions.Invoke(new()
    {
        InstanceId = instance.Id,
    });

});

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) {
        // Retrieve latest possible upgradable versions for RabbitMQ and Erlang
        final var versions = CloudamqpFunctions.getUpgradableVersions(GetUpgradableVersionsArgs.builder()
            .instanceId(instance.id())
            .build());

    }
}

variables:
  # Retrieve latest possible upgradable versions for RabbitMQ and Erlang
  versions:
    fn::invoke:
      Function: cloudamqp:getUpgradableVersions
      Arguments:
        instanceId: ${instance.id}

If newer version is still available to be upgradable in the data source, re-run again.

import * as pulumi from "@pulumi/pulumi";
import * as cloudamqp from "@pulumi/cloudamqp";

// Retrieve latest possible upgradable versions for RabbitMQ and Erlang
const versions = cloudamqp.getUpgradableVersions({
    instanceId: instance.id,
});
// Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
const upgrade = new cloudamqp.UpgradeRabbitmq("upgrade", {instanceId: instance.id});

import pulumi
import pulumi_cloudamqp as cloudamqp

# Retrieve latest possible upgradable versions for RabbitMQ and Erlang
versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])
# Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=instance["id"])

package main

import (
	"github.com/pulumi/pulumi-cloudamqp/sdk/v3/go/cloudamqp"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		// Retrieve latest possible upgradable versions for RabbitMQ and Erlang
		_, err := cloudamqp.GetUpgradableVersions(ctx, &cloudamqp.GetUpgradableVersionsArgs{
			InstanceId: instance.Id,
		}, nil)
		if err != nil {
			return err
		}
		// Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
		_, err = cloudamqp.NewUpgradeRabbitmq(ctx, "upgrade", &cloudamqp.UpgradeRabbitmqArgs{
			InstanceId: pulumi.Any(instance.Id),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using CloudAmqp = Pulumi.CloudAmqp;

return await Deployment.RunAsync(() => 
{
    // Retrieve latest possible upgradable versions for RabbitMQ and Erlang
    var versions = CloudAmqp.GetUpgradableVersions.Invoke(new()
    {
        InstanceId = instance.Id,
    });

    // Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
    var upgrade = new CloudAmqp.UpgradeRabbitmq("upgrade", new()
    {
        InstanceId = instance.Id,
    });

});

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) {
        // Retrieve latest possible upgradable versions for RabbitMQ and Erlang
        final var versions = CloudamqpFunctions.getUpgradableVersions(GetUpgradableVersionsArgs.builder()
            .instanceId(instance.id())
            .build());

        // Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
        var upgrade = new UpgradeRabbitmq("upgrade", UpgradeRabbitmqArgs.builder()
            .instanceId(instance.id())
            .build());

    }
}

resources:
  # Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
  upgrade:
    type: cloudamqp:UpgradeRabbitmq
    properties:
      instanceId: ${instance.id}
variables:
  # Retrieve latest possible upgradable versions for RabbitMQ and Erlang
  versions:
    fn::invoke:
      Function: cloudamqp:getUpgradableVersions
      Arguments:
        instanceId: ${instance.id}

Create UpgradeRabbitmq Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new UpgradeRabbitmq(name: string, args: UpgradeRabbitmqArgs, opts?: CustomResourceOptions);

@overload
def UpgradeRabbitmq(resource_name: str,
                    args: UpgradeRabbitmqArgs,
                    opts: Optional[ResourceOptions] = None)

@overload
def UpgradeRabbitmq(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    instance_id: Optional[int] = None)

func NewUpgradeRabbitmq(ctx *Context, name string, args UpgradeRabbitmqArgs, opts ...ResourceOption) (*UpgradeRabbitmq, error)

public UpgradeRabbitmq(string name, UpgradeRabbitmqArgs args, CustomResourceOptions? opts = null)

public UpgradeRabbitmq(String name, UpgradeRabbitmqArgs args)
public UpgradeRabbitmq(String name, UpgradeRabbitmqArgs args, CustomResourceOptions options)

type: cloudamqp:UpgradeRabbitmq
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name string: The unique name of the resource.
args UpgradeRabbitmqArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

resource_name str: The unique name of the resource.
args UpgradeRabbitmqArgs: The arguments to resource properties.
opts ResourceOptions: Bag of options to control resource's behavior.

ctx Context: Context object for the current deployment.
name string: The unique name of the resource.
args UpgradeRabbitmqArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args UpgradeRabbitmqArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args UpgradeRabbitmqArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

Constructor example

The following reference example uses placeholder values for all input properties.

var upgradeRabbitmqResource = new CloudAmqp.UpgradeRabbitmq("upgradeRabbitmqResource", new()
{
    InstanceId = 0,
});

example, err := cloudamqp.NewUpgradeRabbitmq(ctx, "upgradeRabbitmqResource", &cloudamqp.UpgradeRabbitmqArgs{
	InstanceId: pulumi.Int(0),
})

var upgradeRabbitmqResource = new UpgradeRabbitmq("upgradeRabbitmqResource", UpgradeRabbitmqArgs.builder()
    .instanceId(0)
    .build());

upgrade_rabbitmq_resource = cloudamqp.UpgradeRabbitmq("upgradeRabbitmqResource", instance_id=0)

const upgradeRabbitmqResource = new cloudamqp.UpgradeRabbitmq("upgradeRabbitmqResource", {instanceId: 0});

type: cloudamqp:UpgradeRabbitmq
properties:
    instanceId: 0

UpgradeRabbitmq Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

The UpgradeRabbitmq resource accepts the following input properties:

InstanceId int: The CloudAMQP instance identifier

InstanceId int: The CloudAMQP instance identifier

instanceId Integer: The CloudAMQP instance identifier

instanceId number: The CloudAMQP instance identifier

instance_id int: The CloudAMQP instance identifier

instanceId Number: The CloudAMQP instance identifier

Outputs

All input properties are implicitly available as output properties. Additionally, the UpgradeRabbitmq resource produces the following output properties:

Id string: The provider-assigned unique ID for this managed resource.

Id string: The provider-assigned unique ID for this managed resource.

id String: The provider-assigned unique ID for this managed resource.

id string: The provider-assigned unique ID for this managed resource.

id str: The provider-assigned unique ID for this managed resource.

id String: The provider-assigned unique ID for this managed resource.

Look up Existing UpgradeRabbitmq Resource

Get an existing UpgradeRabbitmq resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: UpgradeRabbitmqState, opts?: CustomResourceOptions): UpgradeRabbitmq

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        instance_id: Optional[int] = None) -> UpgradeRabbitmq

func GetUpgradeRabbitmq(ctx *Context, name string, id IDInput, state *UpgradeRabbitmqState, opts ...ResourceOption) (*UpgradeRabbitmq, error)

public static UpgradeRabbitmq Get(string name, Input<string> id, UpgradeRabbitmqState? state, CustomResourceOptions? opts = null)

public static UpgradeRabbitmq get(String name, Output<String> id, UpgradeRabbitmqState state, CustomResourceOptions options)

Resource lookup is not supported in YAML

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

resource_name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

The following state arguments are supported:

InstanceId int: The CloudAMQP instance identifier

InstanceId int: The CloudAMQP instance identifier

instanceId Integer: The CloudAMQP instance identifier

instanceId number: The CloudAMQP instance identifier

instance_id int: The CloudAMQP instance identifier

instanceId Number: The CloudAMQP instance identifier

Import

Not possible to import this resource.

To learn more about importing existing cloud resources, see Importing resources.

Package Details

Repository: CloudAMQP pulumi/pulumi-cloudamqp
License: Apache-2.0
Notes: This Pulumi package is based on the cloudamqp Terraform Provider.

CloudAMQP v3.18.0 published on Thursday, Jun 13, 2024 by Pulumi

pulumi/pulumi-cloudamqp

cloudamqp.UpgradeRabbitmq

On this page

On this page

Example Usage

Create UpgradeRabbitmq Resource

Constructor syntax

Parameters

Constructor example

UpgradeRabbitmq Resource Properties

Inputs

Outputs

Look up Existing UpgradeRabbitmq Resource

Import

Package Details

On this page

On this page