Créer des instances

Cette page explique comment créer des instances 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é gcloud CLI, assurez-vous de disposer 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

Console

  1. Accédez à la page Memorystore pour Valkey dans la console Google Cloud .

    Memorystore for Valkey

  2. Cliquez sur Créer une instance.

  3. Sur la page Créer une instance Valkey, sélectionnez les configurations souhaitées pour votre nouvelle instance.

    • Sous Nommez votre instance, saisissez un ID d'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.
      • Exemple : my-instance-1.
    • Sous Choisir une région, sélectionnez une région pour votre instance.
    • Sous Type de nœud, sélectionnez votre type de nœud.
    • Sous Mode, sélectionnez Mode cluster activé ou Mode cluster désactivé.
    • Sous Taille de l'instance, définissez le nombre de segments pour 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 partitions.
    • Si vous souhaitez créer une instance avec des répliques, saisissez le nombre de répliques souhaité (par shard) sous Répliques. Les valeurs acceptables sont "Aucune réplique", "1 réplique" et "2 répliques". La valeur par défaut est "1 réplica" lorsque vous utilisez la console Google Cloud .
    • Sous Configurer la connexion, sélectionnez le réseau de votre choix. Pour en savoir plus sur la mise en réseau privée pour Memorystore pour Valkey, consultez Mise en réseau.
    • Si vous souhaitez activer l'authentification IAM, sélectionnez Activer IAM AUTH.
    • Si vous souhaitez activer le chiffrement en transit, sélectionnez Activer le protocole TLS (Transport Layer Security).
    • Sous Choisir une version, sélectionnez votre version Valkey. La version 7.2 de Valkey est celle par défaut.
  4. Cliquez sur le bouton Create Instance (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 de votre 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.

  • 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 souhaité (par segment). Les valeurs acceptées sont 0, 1 et 2.

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

    • shared-core-nano
    • standard-small
    • highmem-medium
    • highmem-xlarge

    Pour en savoir plus sur les types de nœuds et les configurations d'instance, consultez Spécifications des instances et des nœuds.

  • ENGINE_VERSION est la version du moteur Valkey que vous avez choisie. Les valeurs acceptées sont VALKEY_7_2 et VALKEY_8_0.

  • 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 la section 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, l'instance est définie par défaut sur "Mode cluster activé". Pour en savoir plus, consultez Activer et désactiver le mode cluster.

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.

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) que vous avez choisi. Les valeurs acceptées sont 0, 1 et 2.

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

    • shared-core-nano
    • standard-small
    • highmem-medium
    • highmem-xlarge

    Pour en savoir plus sur les types de nœuds et les configurations d'instance, consultez Spécifications des instances et des nœuds.

  • ENGINE_VERSION est la version du moteur Valkey que vous avez choisie. Les valeurs acceptées sont VALKEY_7_2 et VALKEY_8_0.

  • 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 la section 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.

  • ZONE_DISTRIBUTION_CONFIG_MODE est le mode qui vous permet de choisir entre provisionner une instance à une seule zone ou 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 signalétique ne s'applique que si --zone-distribution-config-mode= est défini sur single-zone.