Créer une instance

Une instance Cloud Bigtable est un conteneur pour les clusters Bigtable. Une instance comportant plusieurs clusters utilise la réplication. Vous pouvez créer des clusters dans un maximum de huit régions, avec autant de clusters dans chaque région qu'il y a de zones.

Cette page vous explique comment créer une instance. Avant de lire cette page, vous devez avoir lu la présentation de Bigtable. Nous vous recommandons également de lire la présentation des instances, clusters et nœuds.

Avant de commencer

Préparez votre environnement :

  1. Connectez-vous à votre compte Google.

    Si vous n'en possédez pas déjà un, vous devez en créer un.

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

    Accéder au sélecteur de projet

  3. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.

  4. Activer les API Cloud Bigtable, Cloud Bigtable Admin.

    Activer les API

  5. Installez et initialisez Google Cloud CLI.

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

    Accéder au sélecteur de projet

  7. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.

  8. Activer les API Cloud Bigtable, Cloud Bigtable Admin.

    Activer les API

  9. Installez et initialisez Google Cloud CLI.

Planifiez la configuration :

  1. Facultatif : Si vous envisagez d'activer la réplication, procédez comme suit :

  2. Facultatif : Si vous souhaitez utiliser des clés de chiffrement gérées par le client (CMEK) au lieu du chiffrement géré par Google, effectuez les tâches décrites dans Créer une instance utilisant des CMEK et préparez votre ID de clé CMEK avant de créer l'instance. Vous ne pouvez pas ajouter la protection CMEK après la création d'une instance, et vous ne pouvez pas modifier ni remplacer la clé CMEK après sa création.

Créer une instance

Pour créer une instance Bigtable :

Console

  1. Dans Cloud Console, accédez à la page Créer une instance.

    Accéder à la page Créer une instance

  2. Entrez un nom pour l'instance.

    Cloud Console affiche ce nom pour identifier votre instance.

  3. Entrez un ID d'instance.

    L'ID d'instance est un identifiant permanent pour l'instance.

  4. Cliquez sur Continuer.

  5. Choisissez d'utiliser un disque SSD ou HDD pour vos clusters. Dans la plupart des cas, il est préférable de choisir un disque SSD. Ce choix est définitif. En savoir plus

  6. Cliquez sur Continuer.

  7. Entrez un ID de cluster pour le premier cluster.

    L'ID de cluster est un identifiant permanent pour le cluster.

  8. Choisissez la région et la zone dans lesquelles le premier cluster sera exécuté.

  9. Choisissez un mode de scaling des nœuds pour le cluster. Pour obtenir des conseils de scaling, consultez la section Autoscaling.

    1. Dans le champ Allocation de nœuds manuel, saisissez le nombre de nœuds Bigtable pour le premier cluster. Si vous ne savez pas de combien de nœuds vous avez besoin, utilisez la valeur par défaut. Vous pourrez ajouter des nœuds ultérieurement.
    2. Pour Autoscaling, saisissez les valeurs suivantes :
      • Nombre minimal de nœuds
      • Nombre maximal de nœuds
      • Objectif d'utilisation du CPU

  10. (Facultatif) Pour protéger votre instance avec des clés CMEK plutôt que d'utiliser le chiffrement géré par Google, procédez comme suit :

    1. Cliquez sur Afficher les options de chiffrement.
    2. Cochez la case située à côté de l'option Utiliser une clé de chiffrement gérée par le client (CMEK).
    3. Sélectionnez ou saisissez le nom de ressource de la clé CMEK que vous souhaitez utiliser pour le cluster. Vous ne pourrez pas l'ajouter ultérieurement.
    4. Si vous êtes invité à accorder l'autorisation au compte de service de la clé CMEK, cliquez sur Accorder. Pour effectuer cette tâche, votre compte utilisateur doit disposer du rôle d'administrateur Cloud KMS.
    5. Cliquez sur Enregistrer.

  11. (Facultatif) Pour activer la réplication maintenant, procédez comme suit :

    1. Cliquez sur Afficher les options avancées.
    2. Cliquez sur Ajouter un cluster, saisissez les paramètres du cluster, puis cliquez sur Ajouter. Répétez cette étape pour créer des clusters supplémentaires dans l'instance. Vous pouvez également activer la réplication ultérieurement en ajoutant un cluster.

    Chaque zone d'une région ne peut contenir qu'un seul cluster. Si le bouton Ajouter un cluster est désactivé, modifiez la zone de votre premier cluster.

    Pour créer une instance comportant plus de six clusters, commencez par créer une instance comportant six clusters, puis ajoutez-y d'autres clusters.

  12. Cliquez sur Créer pour créer l'instance.

  13. Vérifiez les paramètres de réplication dans le profil d'application par défaut pour vérifier qu'ils sont adaptés à votre cas d'utilisation de la réplication. Vous devrez peut-être mettre à jour le profil d'application par défaut ou créer des profils d'application personnalisés.

gcloud

  1. Utilisez la commande bigtable instances create pour créer une instance :

    gcloud bigtable instances create INSTANCE_ID \
    --display-name=DISPLAY_NAME \
    [--cluster-storage-type=CLUSTER_STORAGE_TYPE] \
    [--cluster-config=id=CLUSTER_ID,zone=CLUSTER_ZONE, \
    nodes=CLUSTER_NUM_NODES] \
    [--cluster-config=id=CLUSTER_ID,zone=CLUSTER_ZONE, \
    autoscaling-min-nodes=AUTOSCALING_MIN_NODES, \
    autoscaling-max-nodes=AUTOSCALING_MAX_NODES, \
    autoscaling-cpu-target=AUTOSCALING_CPU_TARGET] \
    [kms-key=KMS_KEY]

    Remplacez les éléments suivants :

    • INSTANCE_ID : identifiant permanent de l'instance
    • DISPLAY_NAME : nom lisible permettant d'identifier l'instance dans Cloud Console
    • CLUSTER_ZONE : zone dans laquelle le cluster est exécuté.

    Si l'instance est protégée par une clé CMEK, chaque cluster doit se trouver dans la même région que sa clé CMEK. En savoir plus

    Vous devez configurer au moins un cluster pour l'instance à l'aide de l'option --cluster-config. Pour créer une instance comportant plusieurs clusters, répétez l'option --cluster-config pour chaque cluster.

    Pour l'allocation manuelle des nœuds, utilisez l'option cluster-num-nodes dans l'option --cluster-config. Remplacez CLUSTER_NUM_NODES par le nombre de nœuds du cluster. Chaque cluster d'une instance doit comporter un ou plusieurs nœuds. La valeur par défaut est 1. Si vous ne savez pas de combien de nœuds vous avez besoin, utilisez la valeur par défaut. Vous pourrez ajouter des nœuds ultérieurement. En savoir plus

    Pour l'autoscaling, fournissez les trois options autoscaling- dans l'option --cluster-config et n'utilisez pas cluster-num-nodes. Consultez la section Autoscaling pour savoir comment choisir les valeurs de vos paramètres d'autoscaling. Remplacez les options suivantes dans l'option cluster-config :

    • AUTOSCALING_MIN_NODES : nombre minimal de nœuds pour le cluster.
    • AUTOSCALING_MAX_NODES : nombre maximal de nœuds pour le cluster.
    • AUTOSCALING_CPU_TARGET : utilisation du processeur pour le cluster. Cette valeur doit être comprise entre 10 et 80.

    La commande accepte les options facultatives suivantes :

    • --cluster-storage-type=CLUSTER_STORAGE_TYPE : type de stockage à utiliser pour l'instance. La valeur par défaut est SSD. Dans la plupart des cas, la valeur par défaut est la plus appropriée. Ce choix est définitif. En savoir plus

    • --kms-key=KMS_KEY : clé CMEK du cluster. Vous pouvez uniquement ajouter des clusters utilisant des clés CMEK aux instances déjà protégées de la sorte. En savoir plus

    • --project=PROJECT : projet de création du cluster s'il diffère du projet actuel.

  2. Vérifiez les paramètres de réplication dans le profil d'application par défaut pour vérifier qu'ils sont adaptés à votre cas d'utilisation de la réplication. Vous devrez peut-être mettre à jour le profil d'application par défaut ou créer des profils d'application personnalisés.

cbt

  1. Commencez par créer une instance à cluster unique. Utilisez la commande createinstance pour créer une instance :

    cbt createinstance INSTANCE_ID DISPLAY_NAME CLUSTER_ID CLUSTER_ZONE \
    CLUSTER_NUM_NODES CLUSTER_STORAGE_TYPE

    Indiquez les éléments suivants :

    • INSTANCE_ID : identifiant permanent de l'instance
    • DISPLAY_NAME : nom lisible permettant d'identifier l'instance dans Cloud Console.
    • CLUSTER_ID : identifiant permanent du cluster.
    • CLUSTER_ZONE : zone dans laquelle le cluster est exécuté.
    • CLUSTER_NUM_NODES : nombre de nœuds du cluster. Chaque cluster d'une instance doit comporter un ou plusieurs nœuds. Si vous ne savez pas de combien de nœuds vous avez besoin, utilisez la valeur par défaut. Vous pourrez ajouter des nœuds ultérieurement. En savoir plus
    • CLUSTER_STORAGE_TYPE : type de stockage à utiliser pour le cluster. Chaque cluster d'une instance doit utiliser le même type de stockage. Accepte les valeurs SSD et HDD. Dans la plupart des cas, il est préférable de choisir SSD. Ce choix est définitif. En savoir plus

  2. Pour activer la réplication, utilisez la commande createcluster afin d'ajouter un cluster :

    
cbt -instance=INSTANCE_ID createcluster CLUSTER_ID ZONE NUM_NODES STORAGE_TYPE

    Indiquez les éléments suivants :

    • INSTANCE_ID : identifiant permanent de l'instance que vous venez de créer.
    • CLUSTER_ID : identifiant permanent du cluster.

    • ZONE : zone dans laquelle le cluster est exécuté.

      Chaque zone d'une région ne peut contenir qu'un seul cluster. Par exemple, si une instance dispose d'un cluster dans la région us-east1-b, vous pouvez ajouter un cluster dans une autre zone de la même région, telle que us-east1-c, ou dans une zone située dans une région distincte. Par exemple, europe-west2-a.

    • NUM_NODES : nombre de nœuds du cluster. Chaque cluster d'une instance doit comporter un ou plusieurs nœuds.

      Dans de nombreux cas, chaque cluster d'une instance doit avoir le même nombre de nœuds, mais il existe des exceptions. En savoir plus sur les nœuds et la réplication

    • STORAGE_TYPE : type de stockage à utiliser pour le cluster. Chaque cluster d'une instance doit utiliser le même type de stockage. Accepte les valeurs SSD et HDD.

  3. (Facultatif) Vérifiez les paramètres de réplication dans le profil d'application par défaut pour vérifier qu'ils sont bien adaptés à votre cas d'utilisation de la réplication. Vous devrez peut-être mettre à jour le profil d'application par défaut ou créer des profils d'application personnalisés.

Étape suivante