Mise à disposition en cours

Génération 2

Déployez une instance d' IBM Cloud® Databases for Redis via le catalogue, le plug-in CLI Cloud Databases, l'API Cloud Databases ou à l'aide de Terraform.

Provisionnement via la console IBM Cloud

Effectuez le déploiement depuis la console en spécifiant les paramètres suivants.

  1. Dans la section « Détails du service », configurez les éléments suivants :

    • Emplacement: sélectionnez un emplacement prenant en charge la Gen 2.
    • Nom du service: ce nom peut être n'importe quelle chaîne de caractères; il s'agit du nom utilisé sur le Web et dans l'interface en ligne de commande (CLI) pour identifier la nouvelle instance.
    • Groupe de ressources: si vous organisez vos services en groupes de ressources. Pour plus d'informations, voir Gestion des groupes de ressources.

  2. Modèle d'hébergement : « Isolated » est une offre sécurisée à locataire unique destinée aux charges de travail d'entreprise complexes et hautement performantes. Pour plus d'informations, consultez la section « Modèles d'hébergement ».

  3. Allocation des ressources: affinez l'allocation de vos ressources en choisissant la taille d'hôte requise pour votre déploiement et en précisant la taille de disque nécessaire. La taille de l'hôte et l'allocation de disque se font par membre.

    La taille du disque peut être augmentée après son allocation, mais ne peut pas être réduite afin d'éviter toute perte de données.

  4. Dans la configuration du service, procédez aux réglages suivants :

    • Version de la base de données: la version de déploiement de votre base de données. Pour garantir des performances optimales, utilisez la version recommandée. La dernière version mineure est utilisée automatiquement. Pour plus d'informations, consultez la politique relative aux versions des bases de données.
    • Chiffrement: si vous utilisez Key Protect, vous pouvez sélectionner une instance et une clé pour chiffrer le disque de l’instance. Si vous n'utilisez pas votre propre clé, l'instance crée et gère automatiquement sa propre clé de chiffrement de disque.
    • Points de terminaison: configurez les points de terminaison du service dans votre déploiement. Le paramètre par défaut est « privé ».

  5. Cliquez sur Créer. La page « Liste des ressources » de l' Cloud Databases s'ouvre.

  6. Une fois votre instance provisionnée, cliquez sur son nom pour afficher plus d'informations.

Configuration via l'interface de ligne de commande (CLI)

Avant de procéder au provisionnement, suivez les instructions fournies dans la documentation pour installer l'outil CLI « IBM Cloud ».

  1. Connectez-vous à IBM Cloud. Si vous utilisez un ID utilisateur fédéré, il est important de passer à un code d'accès à usage unique (ibmcloud login --sso) ou d'utiliser une clé d'API (ibmcloud --apikey key or @key_file) pour vous authentifier. Pour plus d'informations sur la procédure de connexion via l'interface CLI, consultez la section « Commandes générales de l'interface CLI(ibmcloud) » à l'adresse ibmcloud login.

    ibmcloud login

  2. Sélectionner un groupe de ressources :

    ibmcloud target -g Default

  3. Créez une instance du service « Databases for Redis » dans IBM Cloud en exécutant une commande du type :

    ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> -p '{"dataservices": {"redis": {"host_flavor":"bx3d.4x20"}}}' --user-tags test-redis,do-not-delete

    Par exemple, pour provisionner une instance Databases for Redis, utilisez une commande du type :

    ibmcloud resource service-instance-create redis-test-database databases-for-redis databases-for-redis-gen2-standard ca-mon -p '{"dataservices": {"redis": {"host_flavor":"bx3d.4x20"}}}' --user-tags test-redis,do-not-delete

    Le paramètre « host_flavor » définit la taille de votre instance Compute. Saisissez la valeur correspondant à la configuration de processeur et de mémoire vive souhaitée. Pour connaître les valeurs disponibles pour le type d'hôte, consultez la section « Sélection de la taille du type d'hôte ».

    Les champs de la commande sont décrits dans le tableau suivant :

    Tableau 1. Champs du format de base des commandes
    Zone Description Indicateur
    INSTANCE_NAME Obligatoire Le nom de l'instance peut être n'importe quelle chaîne de caractères; il s'agit du nom utilisé sur le Web et dans l'interface de ligne de commande (CLI) pour identifier le nouveau déploiement.
    SERVICE_NAME Obligatoire Nom ou ID du service. Pour « Databases for Redis », utilisez « databases-for-redis ».
    SERVICE_PLAN_NAME Obligatoire Formule standard « gen2 » (standard-gen2)
    LOCATION Obligatoire L'emplacement où vous souhaitez effectuer le déploiement. Pour récupérer la liste des régions, utilisez la commande « ibmcloud regions ». Dans le cas d'un appel d'API, la « Location » est désignée comme « cible »
    RESOURCE_GROUP Le nom du groupe de ressources. La valeur par défaut est Default. Indiquez l'identifiant du groupe de ressources en cas d'appel d'API. -g
    --parameters Fichier JSON ou chaîne JSON contenant les paramètres nécessaires à la création de l'instance du service -p
    host_flavor Pour « Isolated Compute », sélectionnez la configuration de processeur et de mémoire vive souhaitée. Pour plus d'informations, consultez le tableau ci-dessous ou la section « Modèles d'hébergement ».
    --user-tags Liste des noms de balises utilisateur séparés par des virgules

    Vous verrez s'afficher une réponse similaire à celle-ci :

    Creating service instance redis-test-database in resource group Default of account ICD as user@ibm.com...
OK
Service instance redis-test-database was created.
Name:                   redis-test-database
ID:                     crn:v1:bluemix:public:databases-for-redis:ca-mon:a/23b09aee04da4545b6e32805fa93249d:4b6b8771-b44e-4687-9393-db8a2dec1942::
GUID:                   4b6b8771-b44e-4687-9393-db8a2dec1942
Location:               ca-mon
State:                  provisioning
Type:                   service_instance
Sub Type:
Allow Cleanup:          false
Locked:                 false
One-time credentials:   false
Created at:             2026-06-25T12:48:00Z
Updated at:             2026-06-25T12:48:01Z
Last Operation:
                        Status    create in progress
                        Message   Started create instance operation

    Pour vérifier l'état de l'approvisionnement, utilisez la commande suivante :

    ibmcloud resource service-instance <INSTANCE_NAME>

    Une fois l'opération terminée, vous verrez s'afficher une réponse similaire à celle-ci :

    Retrieving service instance INSTANCE_NAME in resource group default under account USER's Account as USER...
OK
Name:                  INSTANCE_NAME
ID:                    crn:v1:bluemix:public:databases-for-redis:ca-mon:a/23b09aee04da4545b6e32805fa93249d:4b6b8771-b44e-4687-9393-db8a2dec1942::
GUID:                  4b6b8771-b44e-4687-9393-db8a2dec1942
Location:              <LOCATION>
Service Name:          databases-for-redis
Service Plan Name:     standard-gen2
Resource Group Name:   default
State:                 active
Type:                  service_instance
Sub Type:              Public
Locked:                false
Service Endpoints:     private
Created at:            2026-06-25T19:42:07Z
Created by:            USER
Updated at:            2026-06-25T19:53:25Z
Last Operation:
                       Status    create succeeded
                       Message   Provisioning redis with version 8.2 (100%)

Mettre à jour une instance de service

Vous pouvez mettre à jour le nom de l'instance du service, l'identifiant du plan de service et les paramètres à l'aide d'une commande telle que celle-ci :

ibmcloud resource service-instance-update service-instance-current-name --service-plan-id databases-for-redis-gen2-standard -p '{"dataservices": {"redis": {"storage_gb":20}}}' -g Default --name NEW_NAME

Suppression d'une instance de service

Pour supprimer une instance, exécutez une commande du type suivant :

ibmcloud resource service-instance-delete <INSTANCE_NAME_OR_CRN>

Restauration à partir d'une sauvegarde « Redis »

Vous pouvez créer une nouvelle instance d' Redis à partir d'une sauvegarde spécifique à l'aide d'une commande telle que celle-ci :

ibmcloud resource service-instance-create restore-instance-name databases-for-redis standard-gen2 ca-mon -g Default  -p '{
      "dataservices":{
            "restore_backup_id": "<service-instance-crn>:backup:<backup-uuid>"
      }
}'

Mise à disposition via l'API du contrôleur de ressources

Suivez ces étapes pour effectuer un provisionnement à l'aide de l'API Resource Controller.

  1. Obtenez un jeton IAM à l'aide de la commande suivante :

    IAM_TOKEN=$(ibmcloud iam oauth-tokens -o json | jq .iam_token -r)

  2. Vous devez connaître l'ID du groupe de ressources sur lequel vous souhaitez effectuer le déploiement. Ces informations sont disponibles via l'interface de ligne de commande IBM Cloud.

    Utilisez une commande du type :

    ibmcloud resource groups

    Notez l'ID du groupe de ressources souhaité. Dans la plupart des cas, nous utilisons la valeur par défaut du groupe de ressources.

  3. Vous devez connaître la région dans laquelle vous souhaitez effectuer le déploiement.

    Pour répertorier toutes les régions dans lesquelles des déploiements peuvent être provisionnés à partir de la région actuelle, utilisez le plug-in CLI « Cloud Databases ».

    La commande se présente comme suit :

    ibmcloud cdb regions --json

  4. Le paramètre « host_flavor » définit la taille de votre instance Compute. Choisissez la valeur adaptée à votre déploiement. Pour connaître les valeurs disponibles pour le type d'hôte, consultez la section « Gen 2 isolated compute ».

  5. Une fois que vous disposez de toutes les informations nécessaires, créez une nouvelle instance de ressource à l'aide du contrôleur de ressources IBM Cloud.

    curl -X POST https://resource-controller.cloud.ibm.com/v2/resource_instances -H "Authorization: ${IAM_TOKEN}"   -H 'Content-Type: application/json' -d '{
    "name": "redis-test",
    "target": "ca-mon",
    "resource_group": "c21a4e8564c14d1aab2a9a8b441904eb",
    "resource_plan_id": "databases-for-redis-gen2-standard",
    "parameters": {
      "dataservices": {
        "redis": {
          "host_flavor": "bx3d.4x20"
        }
      },
      "service_endpoints": "private",
      "version": "8.2"
    },
    "tags": [
      "redis-test",
      "do-not-delete"
    ]
  }'

    Les zones de la commande sont décrites dans le tableau qui suit.

    Tableau 3. Champs du format de base des commandes
    Zone Description Indicateur
    name Obligatoire Le nom de l'instance peut être n'importe quelle chaîne de caractères; il s'agit du nom utilisé sur le Web et dans l'interface de ligne de commande (CLI) pour identifier le nouveau déploiement.
    target Obligatoire L'emplacement où vous souhaitez effectuer le déploiement. Pour récupérer la liste des régions, utilisez la commande « ibmcloud regions ».
    resource_group Obligatoire L'identifiant du groupe de ressources. La valeur par défaut est Default.
    resource_plan_id Obligatoire Formule standard « gen2 » (databases-for-redis)
    parameters Objet JSON contenant les paramètres nécessaires à la création d'une instance de service
    host_flavor Pour « Isolated Compute », sélectionnez la configuration de processeur et de mémoire vive souhaitée. Pour plus d'informations, consultez la section « Modèles d'hébergement ».
    service_endpoints Obligatoire Configurez les points de terminaison du service de votre déploiement : public, private ou public-and-private.
    version La version de la base de données à déployer. S'il est omis, la base de données est créée avec la version majeure et la version mineure la plus récente.
    tags Tableau de noms de balises utilisateur

Obtenir les détails de l'instance de service

curl -X GET https://resource-controller.cloud.ibm.com/v2/resource_instances/<service-instance-id> -H "Authorization: ${IAM_TOKEN}" | jq

Mettre à jour une instance de service

Vous pouvez mettre à jour le nom et les paramètres de l'instance du service à l'aide de la commande suivante :

curl -X PATCH https://resource-controller.cloud.ibm.com/v2/resource_instances/<service-instance-id> -H "Authorization: ${IAM_TOKEN}" -H 'Content-Type: application/json' -d '{
"name": "redis-test-testing-patch",
"parameters":{"dataservices":{"redis":{"host_flavor":"bx3d.8x40"}}}
}' | jq

Suppression d'une instance de service

Pour supprimer une instance, exécutez la commande suivante :

curl -X DELETE https://resource-controller.cloud.ibm.com/v2/resource_instances/<service-instance-id> -H "Authorization: ${IAM_TOKEN}"

Restauration à partir d'une sauvegarde « Redis »

Vous pouvez créer une nouvelle instance d' Redis à partir d'une sauvegarde spécifique à l'aide de la commande suivante :

curl -X POST   https://resource-controller.cloud.ibm.com/v2/resource_instances   -H "Authorization: ${IAM_TOKEN}"   -H 'Content-Type: application/json' -d '{
    "name": "redis-test-restore",
    "target": "ca-mon",
    "resource_group": "c21a4e8564c14d1aab2a9a8b441904eb",
    "resource_plan_id": "databases-for-redis-gen2-standard",
    "parameters": {
      "dataservices": {
        "restore_backup_id": "<service-instance-crn>:backup:<backup-uuid>"
      }
    },
    "tags": [
      "redis-test"
    ]
  }'

Mise à disposition avec Terraform

Utilisez Terraform pour gérer votre infrastructure via la ressource « ibm_database » pour Terraform, qui prend en charge le provisionnement des déploiements d’ Cloud Databases.

Sélectionnez le modèle d'hébergement sur lequel vous souhaitez que votre base de données soit déployée. Vous pourrez changer ces informations ultérieurement.

Provisionnez une instance d' Databases for Redis, en définissant le paramètre « "host_flavor" » sur le type d'hôte souhaité. Exemple :

data "ibm_resource_group" "group" {
  name = "<your_resource_group>"
}
resource "ibm_resource_instance" "<your_instance_name>" {
  name = "your_instance_name"
  plan = "databases-for-redis-gen2-standard"
  service = "databases-for-redis"
  location = "us-east"
  tags              = ["terraform", "redis"]
  resource_group_id = data.ibm_resource_group.group.id
  timeouts {
    create = "120m"
    update = "120m"
    delete = "15m"
  }
}

Avant d'exécuter un script Terraform sur une instance existante, utilisez la commande « terraform plan » pour comparer l'état actuel de l'infrastructure avec l'état souhaité défini dans vos fichiers Terraform. Toute modification des attributs resource_group_id, service plan, version, key_protect_instance, key_protect_key ou backup_encryption_key_crn entraîne la recréation de votre instance. Pour obtenir la liste des références d'arguments actuelles relatives à la spécification « Forces new resource », consultez le registre Terraform d'ibm_database.

Obtenir les détails de l'instance de service

data "ibm_resource_group" "group" {
  name = "<your_resource_group>"
}
data "ibm_resource_instance" "<your_instance_name>" {
  name              = "<your_instance_name>"
  location          = "us-east"
  resource_group_id = data.ibm_resource_group.group.id
  service = "databases-for-redis"
}
output "<your_instance_name>_output" {
  value ={
    id = data.ibm_resource_instance.<your_instance_name>.id
    name = data.ibm_resource_instance.<your_instance_name>.name
    extensions = data.ibm_resource_instance.<your_instance_name>.extensions
    group_id = data.ibm_resource_instance.<your_instance_name>.resource_group_id
  }
}

Mettre à jour une instance de service

Vous pouvez mettre à jour le paramètre « host flavor » à l'aide de la commande suivante :

data "ibm_resource_group" "group" {
  name = "your_resource_group"
}
resource "ibm_resource_instance" "<your_instance_name>" {
  name = "<your_instance_name>"
  plan = "databases-for-redis-gen2-standard"
  service = "databases-for-redis"
  location = "us-east"
  tags              = ["scaling","tf"]
  resource_group_id = data.ibm_resource_group.group.id
  parameters_json = jsonencode({
  "dataservices": {
      "redis": {
        "host_flavor": "bx2.8x32"
      }
  }
})
  timeouts {
    create = "120m"
    update = "120m"
    delete = "15m"
  }
}

Suppression d'une instance de service

Pour supprimer les ressources gérées par Terraform, exécutez la commande suivante : terraform destroy

  • Lorsque Terraform crée un utilisateur, il génère automatiquement un fichier d'état ( terraform.tfstate ) et les informations correspondantes sont ajoutées aux ressources de ce fichier d'état. Ce fichier répertorie toutes les ressources gérées et est utilisé par Terraform pour déterminer les éléments à supprimer lors d'une opération de suppression.

  • Terraform ne peut supprimer que les ressources qu'il a lui-même créées. Les ressources provisionnées via l'interface utilisateur, l'interface de ligne de commande ou l'API ne peuvent pas être supprimées par Terraform à moins d'avoir été préalablement importées dans l'état Terraform.

  • Toutes les entrées présentes dans les ressources du fichier d'état sont supprimées lorsque vous exécutez la commande « destroy ». Veillez donc à ce que les ressources que vous souhaitez supprimer soient les seules à figurer dans la liste des ressources avant d'exécuter la commande terraform destroy

Restauration à partir d'une sauvegarde « Redis »

Vous pouvez créer une nouvelle instance d' Redis à partir d'une sauvegarde spécifique à l'aide de la commande suivante :

resource "ibm_resource_instance" "<your_instance_name>" {
  name = "<your_instance_name>"
  plan = "databases-for-redis-gen2-standard"
  service = "databases-for-redis"
  location = "us-east"
  tags      = ["terraform", "redis"]
    parameters_json = jsonencode({
      "dataservices": {
        "restore_backup_id": "<service-instance-crn>:backup:<backup-uuid>"
      }
    })
}