DBaaS InMemoryDB ReplicaSet

Creates and manages DBaaS InMemoryDB Replica Set objects.

Manages a DBaaS InMemoryDB Replica Set.

Example Usage

resource "ionoscloud_datacenter" "example" {
  name                    = "example"
  location                = "de/txl"
  description             = "Datacenter for DBaaS InMemoryDB replica sets"
}

resource "ionoscloud_lan"  "example" {
  datacenter_id           = ionoscloud_datacenter.example.id 
  public                  = false
  name                    = "example"
}

resource "ionoscloud_server" "example" {
  name                    = "example"
  datacenter_id           = ionoscloud_datacenter.example.id
  cores                   = 2
  ram                     = 2048
  availability_zone       = "ZONE_1"
  cpu_family              = "INTEL_SKYLAKE"
  image_name              = "rockylinux-8-GenericCloud-20230518"
  image_password          = "password"
  volume {
    name                  = "example"
    size                  = 10
    disk_type             = "SSD Standard"
  }
  nic {
    lan                   = ionoscloud_lan.example.id
    name                  = "example"
    dhcp                  = true
  }
}

locals {
 prefix                   = format("%s/%s", ionoscloud_server.example.nic[0].ips[0], "24")
 database_ip              = cidrhost(local.prefix, 1)
 database_ip_cidr         = format("%s/%s", local.database_ip, "24")
}

resource "ionoscloud_inmemorydb_replicaset" "example" {
  location = ionoscloud_datacenter.example.location
  display_name = "ExampleReplicaSet"
  version = "7.2"
  replicas = 4
  resources {
    cores = 1
    ram = 6
  }
  persistence_mode = "RDB"
  eviction_policy = "noeviction"
  connections   {
    datacenter_id         =  ionoscloud_datacenter.example.id
    lan_id                =  ionoscloud_lan.example.id
    cidr                  =  local.database_ip_cidr
  }
  maintenance_window {
    day_of_the_week       = "Monday"
    time                  = "10:00:00"
  }
  credentials {
    username = "myuser"
    plain_text_password = "testpassword"
  }
}

Argument Reference

• display_name - (Required)[string] The human-readable name of your replica set.

• location - (Optional)[string] The location of your replica set. Updates to the value of the field force the replica set to be re-created. If this is not set and if no value is provided for the IONOS_API_URL env var, the default location will be: de/fra.

• version - (Required)[string] The InMemoryDB version of your replica set.

• replicas - (Required)[int] The total number of replicas in the replica set (one active and n-1 passive). In case of a standalone instance, the value is 1. In all other cases, the value is > 1. The replicas will not be available as read replicas, they are only standby for a failure of the active instance.

• resources - (Required)[object] The resources of the individual replicas.

  • cores - (Required)[int] The number of CPU cores per instance.

  • ram - (Required)[int] The amount of memory per instance in gigabytes (GB).

  • storage - (Computed)[int] The size of the storage in GB. The size is derived from the amount of RAM and the persistence mode and is not configurable.

• persistence_mode - (Required)[string] Specifies How and If data is persisted, possible values are:

  • None - Data is inMemory only and will not be persisted. Useful for cache only applications.

  • AOF - (Append Only File) AOF persistence logs every write operation received by the server. These operations can then be replayed again at server startup, reconstructing the original dataset. Commands are logged using the same format as the InMemoryDB protocol itself.

  • RDB - RDB persistence performs snapshots of the current in memory state.

  • RDB_AOF - Both RDB and AOF persistence are enabled.

• eviction_policy - (Required)[string] The eviction policy for the replica set, possible values are:

  • noeviction - No eviction policy is used. InMemoryDB will never remove any data. If the memory limit is reached, an error will be returned on write operations.

  • allkeys-lru - The least recently used keys will be removed first.

  • allkeys-lfu - The least frequently used keys will be removed first.

  • allkeys-random - Random keys will be removed.

  • volatile-lru - The least recently used keys will be removed first, but only among keys with the expire field set to true.

  • volatile-lfu - The least frequently used keys will be removed first, but only among keys with the expire field set to true.

  • volatile-random - Random keys will be removed, but only among keys with the expire field set to true.

  • volatile-ttl - The key with the nearest time to live will be removed first, but only among keys with the expire field set to true.

• connections - (Required)[object] The network connection for your replica set. Only one connection is allowed. Updates to the value of the fields force the replica set to be re-created.

  • datacenter_id - (Required)[string] The datacenter to connect your instance to.

  • lan_id - (Required)[string] The numeric LAN ID to connect your instance to.

  • cidr - (Required)[string] The IP and subnet for your instance. Note the following unavailable IP ranges: 10.233.64.0/18, 10.233.0.0/18, 10.233.114.0/24.

• credentials - (Required)[object] Credentials for the InMemoryDB replicaset, only one type of password can be used since they are mutually exclusive. These values are used to create the initial InMemoryDB user, updating any of these will force recreation of the replica set resource.

  • username - (Required)[string] The username for the initial InMemoryDB user. Some system usernames are restricted (e.g. 'admin', 'standby').

  • plain_text_password - (Optional)[string] The password for a InMemoryDB user, this is a field that is marked as Sensitive.

  • hashed_password - (Optional)[object] The hashed password for a InMemoryDB user.

    • algorithm - (Required)[string] The value can be only: "SHA-256".

    • hash - (Required)[string] The hashed password.

• maintenance_window - (Optional)(Computed) A weekly 4 hour-long window, during which maintenance might occur.

  • time - (Required)[string] Start of the maintenance window in UTC time.

  • day_of_the_week - (Required)[string] The name of the week day.

• initial_snapshot_id - (Optional)[string] The ID of a snapshot to restore the replica set from. If set, the replica set will be created from the snapshot.

• dns_name - (Computed)[string] The DNS name pointing to your replica set. Will be used to connect to the active/standalone instance.

⚠ NOTE: IONOS_API_URL_INMEMORYDB can be used to set a custom API URL for the resource. location field needs to be empty, otherwise it will override the custom API URL. Setting token or IONOS_API_URL does not have any effect.

Import

Resource DBaaS InMemoryDB Replica Set can be imported using the replicaset_id and the location, separated by :, e.g:

terraform import ionoscloud_inmemorydb_replicaset.example {location}:{replicaSet UUID}