Créer des instances

Cette page explique comment créer des instances à une ou plusieurs zones dans Memorystore pour Valkey.

Avant de commencer

Suivez les instructions de la section "Avant de commencer" :

1. Dans la console Google Cloud , sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.
   

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu d'en sélectionner un existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   
   Accéder au sélecteur de projet
2. Assurez-vous que la facturation est activée pour votre projet. Découvrez comment vérifier si la facturation est activée sur un projet.

3. Installez et initialisez la Google Cloud CLI.

   Remarque : Si vous avez déjà installé la gcloud CLI, assurez-vous que vous disposez de la dernière version en exécutant gcloud components update. Vous devez disposer au moins de la version 489.0.0 de gcloud CLI pour accéder aux commandes gcloud CLI de Memorystore pour Valkey.

4. Activez l'API Memorystore pour Valkey.
   Memorystore pour Valkey
5. Activez l'API Network Connectivity.
   API Network Connectivity
6. Activer l'API Service Consumer Management
   API Service Consumer Management

Autres conditions préalables

• Vous devez disposer de l'un des rôles IAM suivants dans le projet Google Cloud que vous utilisez :
  • roles/memorystore.admin (rôle IAM prédéfini "Administrateur Memorystore")
  • roles/owner (rôle IAM de base "Propriétaire")
  • roles/editor (rôle IAM de base Éditeur)

Configurer la mise en réseau

Consultez la page Mise en réseau pour déterminer si vous devez configurer une règle de connexion de service.

Si aucune règle de connexion au service n'a été créée pour le réseau avec lequel vous allez créer l'instance Valkey, suivez les instructions de la section Mise en réseau pour la créer.

Créer une instance multizone

Cette section explique comment créer une instance multizone.

Important : Avant de suivre les étapes de cette procédure, suivez celles des sections Avant de commencer et Configurer la mise en réseau.

Si vous créez une instance avec des répliques et qu'une seule zone de la région dans laquelle vous souhaitez créer l'instance n'est pas disponible, Memorystore pour Valkey crée l'instance dans les zones disponibles de la région. Cette allocation zonale est temporaire. Une fois la zone indisponible redevenue disponible, Memorystore pour Valkey redistribue les nœuds de l'instance de sorte qu'ils soient répartis de manière égale entre les zones.

Si vous créez une instance sans réplicas et qu'une seule zone n'est pas disponible, Memorystore pour Valkey ne parvient pas à créer l'instance.

Console

1. Dans la console Google Cloud , accédez à la page Memorystore pour Valkey.

   Memorystore for Valkey

2. Cliquez sur Créer une instance.

3. Dans la section Nommez votre instance, saisissez un ID pour l'instance. L'ID d'instance ne doit contenir que des lettres minuscules, des chiffres et des traits d'union. Il doit également commencer par une lettre et être unique dans sa région.

4. Dans le menu Région, sélectionnez une région pour votre instance.

5. Dans la section Disponibilité zonale, sélectionnez l'option Multizone, car vous souhaitez créer une instance multizone.

6. Dans la section Type de nœud, sélectionnez l'un des types de nœuds suivants :

   • Cœur partagé (shared-core-nano)
   • Petite (standard-small)
   • Moyenne (highmem-medium)
   • Très grande (highmem-xlarge)

7. Dans la section Mode cluster, indiquez si vous souhaitez une instance avec le mode cluster activé ou désactivé. Pour en savoir plus sur ces types d'instances, consultez Activer et désactiver le mode cluster.

   Remarque : Une fois que vous avez créé une instance avec le mode cluster activé ou désactivé, vous ne pouvez pas la modifier pour passer à l'autre mode. Nous vous recommandons de sélectionner Activé, car ce mode présente de meilleures caractéristiques de scaling horizontal.

8. Dans la section Taille de l'instance, saisissez le nombre de partitions pour votre instance. Le nombre de partitions détermine la capacité de mémoire totale pour stocker les données d'instance. Pour en savoir plus sur les spécifications des instances, consultez Spécifications des instances et des nœuds.

9. Si vous souhaitez créer une instance avec des réplicas, sélectionnez le nombre de réplicas (par shard) dans la section Réplicas. Vous pouvez sélectionner entre 0 et 5 répliques. La valeur par défaut est de 1 réplique.

10. Dans la section Configurer une connexion, sélectionnez le réseau que vos applications peuvent utiliser pour se connecter à cette instance. Pour en savoir plus sur la mise en réseau privée pour Memorystore pour Valkey, consultez Mise en réseau.

11. Facultatif. Si vous souhaitez renforcer la sécurité de votre instance, dans la section Sécurité, activez l'authentification IAM en cochant la case Activer l'authentification IAM.

    Remarque : Si vous cochez cette case, Memorystore pour Valkey coche automatiquement la case Activer le chiffrement en transit (TLS). Par conséquent, Memorystore pour Valkey chiffre vos identifiants pour qu'ils restent confidentiels lorsqu'ils sont transmis de l'instance à l'application.

12. Dans la section Stratégie de persistance des données, indiquez comment vous souhaitez que Memorystore pour Valkey conserve les données de votre instance. Les valeurs acceptées sont No persistence (Pas de persistance), Append Only File (AOF) persistence (Persistance du fichier AOF) et Memory Snapshot persistence (Persistance de l'instantané mémoire).

13. Facultatif. Si vous souhaitez activer les sauvegardes automatiques pour votre instance, procédez comme suit :

    1. Cochez la case Sauvegardes quotidiennes automatiques.
    2. Dans le champ Jours de conservation des sauvegardes, saisissez le nombre de jours pendant lesquels vous souhaitez que Memorystore for Valkey conserve les sauvegardes avant qu'elles ne soient supprimées automatiquement. Vous pouvez spécifier une durée comprise entre 1 et 365 jours. La valeur par défaut est de 35 jours.
    3. Dans le menu Intervalle de temps, sélectionnez une heure pour la sauvegarde quotidienne.

14. Dans la section Choisir une version, sélectionnez votre version Valkey. Les versions disponibles sont 7.2, 8.0 et 9.0 (bêta). La version par défaut est la version 8.0.

    Important : Si vous sélectionnez la version 9.0 pour l'instance, vous ne pourrez pas revenir à une version antérieure.

15. Cliquez sur Créer une instance.

gcloud

Pour créer une instance Memorystore pour Valkey, exécutez la commande create :

gcloud memorystore instances create INSTANCE \
--location=REGION_ID \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]' \
--replica-count=REPLICA_COUNT \
--node-type=NODE_TYPE \
--engine-version=ENGINE_VERSION \
--shard-count=SHARD_COUNT \
--mode=MODE

Remplacez les éléments suivants :

• INSTANCE est l'ID de l'instance Memorystore pour Valkey que vous créez. L'ID d'instance doit comporter entre 1 et 63 caractères. Il ne doit contenir que des lettres minuscules, des chiffres ou des traits d'union. Il doit commencer par une lettre minuscule et se terminer par une lettre minuscule ou un chiffre.

• REGION_ID est la région dans laquelle vous souhaitez placer l'instance.

Remarque : Vous ne pouvez créer des instances Memorystore pour Valkey que dans les régions compatibles.

• PROJECT_ID correspond à l'ID du projet dans lequel vous souhaitez créer votre instance.

• NETWORK_ID correspond à l'ID du réseau que vous souhaitez utiliser pour créer votre instance.

• REPLICA_COUNT correspond au nombre d'instances répliquées (par segment). Les valeurs acceptées sont comprises entre 0 et 5.

• NODE_TYPE est le type de nœud choisi. Les valeurs acceptées sont les suivantes :

  • shared-core-nano
  • standard-small
  • highmem-medium
  • highmem-xlarge
  Attention : Nous vous recommandons d'utiliser le type de nœud shared-core-nano uniquement à des fins de développement ou de test, car ce type de nœud n'est pas soumis à un SLA. Si vous exécutez Memorystore pour Valkey dans un environnement de production, nous vous recommandons d'utiliser les types de nœuds standard-small, highmem-medium ou highmem-xlarge. Pour en savoir plus sur ces types de nœuds, consultez Choisir un type de nœud.

• ENGINE_VERSION correspond à la version de votre instance Memorystore pour Valkey. Les valeurs acceptées pour ce paramètre sont VALKEY_7_2, VALKEY_8_0 et VALKEY_9_0 (aperçu). Si vous ne spécifiez aucune valeur, la valeur par défaut est VALKEY_8_0.

  Important : Si vous spécifiez VALKEY_9_0 comme version de l'instance, vous ne pourrez pas revenir à une version antérieure.

• SHARD_COUNT détermine le nombre de segments dans votre instance. Le nombre de segments détermine la capacité de mémoire totale pour stocker les données d'instance. Les instances avec le mode cluster désactivé n'acceptent qu'un seul segment. Pour en savoir plus, consultez Spécifications des instances et des nœuds.

• MODE détermine si le mode cluster est activé ou désactivé pour l'instance. Si ce champ est omis, le mode cluster est activé par défaut pour l'instance. Pour en savoir plus, consultez Activer et désactiver le mode cluster.

  Remarque : Une fois que vous avez créé une instance avec le mode cluster activé ou désactivé, vous ne pouvez pas la modifier pour passer à l'autre mode. Nous vous recommandons de créer une instance en mode cluster activé, car ce type d'instance présente de meilleures caractéristiques de scaling.

Exemple :

Exemple de mode Cluster activé

gcloud memorystore instances create my-instance \
--location=us-central1 \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \
--replica-count=2 \
--node-type=highmem-medium \
--shard-count=8 \
--mode=cluster

Exemple de mode cluster désactivé

gcloud memorystore instances create my-instance \
--location=us-central1 \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \
--shard-count=1 \
--replica-count=2 \
--node-type=highmem-medium \
--mode=cluster-disabled

Par défaut, le chiffrement en transit est désactivé et le réseau autorisé est default.

Créer une instance à zone unique

Cette section explique comment créer une instance à zone unique.

Important : Avant de suivre ces étapes, suivez celles des sections Avant de commencer et Configurer la mise en réseau.

Console

1. Dans la console Google Cloud , accédez à la page Memorystore pour Valkey.

   Memorystore for Valkey

2. Cliquez sur Créer une instance.

3. Dans la section Nommez votre instance, saisissez un ID pour l'instance. L'ID d'instance ne doit contenir que des lettres minuscules, des chiffres et des traits d'union. Il doit également commencer par une lettre et être unique dans sa région.

4. Dans le menu Région, sélectionnez une région pour votre instance.

5. Dans la section Disponibilité zonale, procédez comme suit :

   1. Sélectionnez l'option Zone unique.

   2. Dans le menu Zone, sélectionnez la zone dans laquelle vous souhaitez que Memorystore pour Valkey crée l'instance.

6. Dans la section Type de nœud, sélectionnez l'un des types de nœuds suivants :

   • Cœur partagé (shared-core-nano)
   • Petite (standard-small)
   • Moyenne (highmem-medium)
   • Très grande (highmem-xlarge)

7. Dans la section Mode cluster, indiquez si vous souhaitez une instance avec le mode cluster activé ou désactivé. Pour en savoir plus sur ces types d'instances, consultez Activer et désactiver le mode cluster.

   Remarque : Une fois que vous avez créé une instance avec le mode cluster activé ou désactivé, vous ne pouvez pas la modifier pour passer à l'autre mode. Nous vous recommandons de sélectionner Activé, car ce mode présente de meilleures caractéristiques de scaling horizontal.

8. Dans la section Taille de l'instance, saisissez le nombre de partitions pour votre instance. Le nombre de partitions détermine la capacité de mémoire totale pour stocker les données d'instance. Pour en savoir plus sur les spécifications des instances, consultez Spécifications des instances et des nœuds.

9. Si vous souhaitez créer une instance avec des réplicas, sélectionnez le nombre de réplicas (par shard) dans la section Réplicas. Vous pouvez sélectionner entre 0 et 5 répliques. La valeur par défaut est de 1 réplique.

10. Dans la section Configurer une connexion, sélectionnez le réseau que vos applications peuvent utiliser pour se connecter à cette instance. Pour en savoir plus sur la mise en réseau privée pour Memorystore pour Valkey, consultez Mise en réseau.

11. Facultatif. Si vous souhaitez renforcer la sécurité de votre instance, dans la section Sécurité, activez l'authentification IAM en cochant la case Activer l'authentification IAM.

    Remarque : Si vous cochez cette case, Memorystore pour Valkey coche automatiquement la case Activer le chiffrement en transit (TLS). Par conséquent, Memorystore pour Valkey chiffre vos identifiants pour qu'ils restent confidentiels lorsqu'ils sont transmis de l'instance à l'application.

12. Dans la section Stratégie de persistance des données, indiquez comment vous souhaitez que Memorystore pour Valkey conserve les données de votre instance. Les valeurs acceptées sont No persistence (Pas de persistance), Append Only File (AOF) persistence (Persistance du fichier AOF) et Memory Snapshot persistence (Persistance de l'instantané mémoire).

13. Facultatif. Si vous souhaitez activer les sauvegardes automatiques pour votre instance, procédez comme suit :

    1. Cochez la case Sauvegardes quotidiennes automatiques.
    2. Dans le champ Jours de conservation des sauvegardes, saisissez le nombre de jours pendant lesquels vous souhaitez que Memorystore for Valkey conserve les sauvegardes avant qu'elles ne soient supprimées automatiquement. Vous pouvez spécifier une durée comprise entre 1 et 365 jours. La valeur par défaut est de 35 jours.
    3. Dans le menu Intervalle de temps, sélectionnez une heure pour la sauvegarde quotidienne.

14. Dans la section Choisir une version, sélectionnez votre version Valkey. Les versions disponibles sont 7.2, 8.0 et 9.0 (bêta). La version par défaut est la version 8.0.

    Important : Si vous sélectionnez la version 9.0 pour l'instance, vous ne pourrez pas revenir à une version antérieure.

15. Cliquez sur Créer une instance.

gcloud

Pour créer une instance à zone unique, exécutez la commande create :

gcloud memorystore instances create INSTANCE \
--location=REGION_ID \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]' \
--replica-count=REPLICA_COUNT \
--node-type=NODE_TYPE \
--engine-version=ENGINE_VERSION \
--shard-count=SHARD_COUNT \
--zone-distribution-config-mode=ZONE_DISTRIBUTION_CONFIG_MODE \
--zone-distribution-config=ZONE \
--mode=MODE

Remplacez les éléments suivants :

• INSTANCE est l'ID de l'instance Memorystore pour Valkey que vous créez. L'ID d'instance doit comporter entre 1 et 63 caractères (lettres minuscules, chiffres ou traits d'union). Il doit commencer par une lettre minuscule et se terminer par une lettre minuscule ou un chiffre.

• REGION_ID est la région dans laquelle vous souhaitez placer l'instance.

• PROJECT_ID correspond à l'ID du projet dans lequel vous souhaitez créer votre instance.

• NETWORK_ID correspond à l'ID du réseau que vous souhaitez utiliser pour créer votre instance.

• REPLICA_COUNT correspond au nombre d'instances répliquées (par segment). Les valeurs acceptées sont comprises entre 0 et 5.

• NODE_TYPE est le type de nœud choisi. Les valeurs acceptées sont les suivantes :

  • shared-core-nano
  • standard-small
  • highmem-medium
  • highmem-xlarge
  Attention : Nous vous recommandons d'utiliser le type de nœud shared-core-nano uniquement à des fins de développement ou de test, car ce type de nœud n'est pas soumis à un SLA. Si vous exécutez Memorystore pour Valkey dans un environnement de production, nous vous recommandons d'utiliser les types de nœuds standard-small, highmem-medium ou highmem-xlarge. Pour en savoir plus sur ces types de nœuds, consultez Choisir un type de nœud.

• ENGINE_VERSION correspond à la version de votre instance Memorystore pour Valkey. Les valeurs acceptées pour ce paramètre sont VALKEY_7_2, VALKEY_8_0 et VALKEY_9_0 (aperçu). Si vous ne spécifiez aucune valeur, la valeur par défaut est VALKEY_8_0.

  Important : Si vous spécifiez VALKEY_9_0 comme version de l'instance, vous ne pourrez pas revenir à une version antérieure.

• SHARD_COUNT détermine le nombre de segments dans votre instance. Le nombre de segments détermine la capacité de mémoire totale pour stocker les données d'instance. Si vous sélectionnez le mode "Mode cluster désactivé", vous ne pouvez spécifier qu'un seul segment pour votre instance. Pour en savoir plus, consultez Spécifications des instances et des nœuds.

• MODE détermine si le mode cluster doit être activé ou désactivé pour l'instance. Si vous omettez ce champ, le mode est défini par défaut sur "Mode cluster activé". Pour en savoir plus, consultez Activer et désactiver le mode cluster.

  Remarque : Une fois que vous avez créé une instance avec le mode cluster activé ou désactivé, vous ne pouvez pas la modifier pour passer à l'autre mode. Nous vous recommandons de créer une instance en mode cluster activé, car ce type d'instance présente de meilleures caractéristiques de scaling.

• ZONE_DISTRIBUTION_CONFIG_MODE est le mode qui vous permet de choisir entre le provisionnement d'une instance à zone unique ou d'une instance multizone. La valeur par défaut est "multizone". Les valeurs acceptées sont single-zone et multi-zone.

• ZONE est la zone dans laquelle vous souhaitez provisionner vos nœuds. Ce signalement ne s'applique que si --zone-distribution-config-mode= est défini sur single-zone.