Premiers pas avec les services Analytics

Découvrez comment configurer votre service Analytics managé depuis l'espace client OVHcloud

Objectif

Les services OVHcloud Public Cloud Analytics vous permettent de vous concentrer sur la création et le déploiement de vos applications cloud, pendant qu'OVHcloud prend en charge l'infrastructure analytics et son maintien en conditions opérationnelles.

Ce guide explique comment commander un service Public Cloud Analytics via l'espace client OVHcloud, l'API, la CLI ou Terraform.

Prérequis

Un projet Public Cloud dans votre compte OVHcloud
Accès à l' (méthodes API et Terraform — créez vos identifiants en consultant le guide Premiers pas avec l'API OVHcloud)
Terraform installé (méthode Terraform uniquement — testé avec la version v1.14.6)

Accès à l'espace client OVHcloud

Lien direct :
Pour accéder à vos services : Public Cloud > Sélectionnez votre projet > Analytics

En pratique

Depuis l'espace client OVHcloud

Depuis l'API OVHcloud

Depuis la CLI OVHcloud

Depuis Terraform

Depuis Analytics, vous pouvez accéder à Kafka, Kafka Connect, Kafka MirrorMaker, Dashboards ou OpenSearch.

Cliquez sur Créer votre service d'analytics managé (ou Créer un service si votre projet contient déjà des services Analytics).

Étape 1 : Sélectionner votre moteur et sa version

Vous pouvez renommer votre service (un nom est généré automatiquement par défaut), puis sélectionner le moteur et sa version.

Étape 2 : Sélectionner un datacentre

Choisissez la région géographique du datacentre qui hébergera votre service Analytics.

Étape 3 : Sélectionner une offre

Choisissez une offre. Vous pourrez la faire évoluer après la création.

Consultez la page des capacités du type de service Analytics sélectionné pour obtenir le détail des caractéristiques de chaque offre.

Étape 4 : Sélectionner votre instance

Sélectionnez l'instance. Le nombre de nœuds est déterminé par l'offre choisie précédemment et ne peut pas être modifié dans ce cas.

Consultez la page des capacités du type de service Analytics sélectionné pour obtenir le détail du matériel et de la configuration.

Prenez note des informations tarifaires.

Étape 5 : Dimensionnement

Du stockage additionnel peut être commandé et, selon le moteur, le nombre de nœuds de votre cluster peut être ajusté.

Étape 6 : Configurer vos options

Configurez le réseau et les IPs autorisées.

Connecter un réseau privé (optionnel)

Si vous disposez déjà d'un sous-réseau privé, sélectionnez Réseau privé (vRack) et choisissez-le dans le menu déroulant. Cette option peut ne pas être disponible pour le type de service sélectionné.

Vous pouvez être redirigé pour créer un réseau privé ou un sous-réseau via les liens correspondants. Dans ce cas, vous devrez recommencer la commande du service Analytics.

Pour des instructions détaillées, consultez le guide Configurer vRack pour Public Cloud.

IPs autorisées

Ajoutez les adresses IP ou plages d'adresses autorisées à se connecter à votre service.

Info

Pour des raisons de sécurité, la configuration réseau par défaut bloque toutes les connexions entrantes. Autorisez une adresse IP adaptée pour accéder à votre service Analytics.

Étape 7 : Récapitulatif et confirmation

Le panneau de droite affiche un récapitulatif de votre commande, mis à jour au fur et à mesure de vos sélections. Vérifiez-le, puis cliquez sur Commander pour confirmer.

Pour visualiser l'appel API ou Terraform équivalent avant de commander, cliquez sur Équivalent API et Terraform.

Votre service Analytics se déploie en quelques minutes. Des messages dans l'espace client OVHcloud vous informeront lorsque le service Analytics sera prêt à l'emploi.

Pour configurer votre service après l'installation, consultez le guide Configurer votre instance pour accepter les connexions entrantes correspondant à votre type de service Analytics, disponible dans notre catalogue.

Les options de configuration varient selon le type d'Analytics. Des exemples sont disponibles dans le dépôt public-cloud-databases-examples.

Étape 1 : Rassembler les paramètres requis

Pour créer un service Analytics, spécifiez au minimum :

un moteur et sa version (par exemple opensearch 2.0)
l'offre (par exemple business)
les nœuds du cluster (par exemple 3 nœuds avec 4 cœurs, 15 Gio de mémoire, 100 Gio de disque)

Lister les capacités

L'endpoint capabilities liste les valeurs autorisées pour le moteur, l'offre et le flavor.

GET/cloud/project/{serviceName}/database/capabilities

L'appel retourne un objet listant les moteurs autorisés (avec leurs versions), les offres et les flavors.

Obtenir la disponibilité

L'endpoint availability liste les combinaisons de paramètres valides. Par exemple, une offre OpenSearch Essential autorise les clusters à nœud unique, alors qu'une offre Business autorise de 3 à 8 nœuds. Choisissez la combinaison qui correspond le mieux à vos besoins.

GET/cloud/project/{serviceName}/database/availability

Étape 2 : Créer un service Analytics OpenSearch

Warning

La création d'un cluster entraîne des frais.

POST/cloud/project/{serviceName}/database/opensearch

description : une description lisible du service.
plan : l'offre souhaitée.
version : la version d'OpenSearch.
nodesPattern : indiquez le flavor, la région et le nombre de nœuds.
nodeslist : laissez ce champ vide — utilisez plutôt nodesPattern pour des clusters de même région et même flavor.
ipRestrictions : les plages d'adresses IP autorisées à se connecter.

Info

Pour des raisons de sécurité, la configuration réseau par défaut bloque toutes les connexions entrantes. Autorisez une adresse IP adaptée pour accéder à votre service Analytics.

Pour la mise en réseau privée, indiquez également networkId (identifiant vRack) et subnetId (identifiant du sous-réseau vRack).

L'appel retourne l'objet du cluster. Son status est CREATING. Notez l'id pour l'étape suivante.

Étape 3 : Attendre que votre service Analytics soit prêt

Le cluster met quelques minutes à devenir utilisable. Vérifiez son statut à l'aide de :

GET/cloud/project/{serviceName}/database/opensearch/{clusterId}

Son status passe à READY lorsque le cluster est disponible.

Étape 4 : Réinitialiser le mot de passe de l'utilisateur principal

Listez les utilisateurs de votre cluster pour obtenir l'ID de l'utilisateur admin :

GET/cloud/project/{serviceName}/database/opensearch/{clusterId}/user

Réinitialisez le mot de passe de l'utilisateur admin :

POST/cloud/project/{serviceName}/database/opensearch/{clusterId}/user/{userId}/credentials/reset

Notez le nouveau mot de passe pour vous connecter au cluster.

Warning

Ce mot de passe ne sera plus disponible par la suite : OVHcloud ne stocke pas les mots de passe utilisateur.

Étape 5 : Commencer à utiliser le cluster

Les informations de connexion au cluster sont disponibles dans votre espace client OVHcloud. Vous pouvez maintenant utiliser le cluster.

Info

Toutes les commandes nécessitent soit l'option --cloud-project <projectId>, soit la variable d'environnement OVH_CLOUD_PROJECT_SERVICE, définie avec l'ID de votre projet Public Cloud.

Étape 1 : Rassembler les paramètres requis

Listez les moteurs, offres et flavors de nœuds disponibles :

ovhcloud cloud reference managed-analytics list-engines --cloud-project <projectId>
ovhcloud cloud reference managed-analytics list-plans --cloud-project <projectId>
ovhcloud cloud reference managed-analytics list-node-flavors --cloud-project <projectId>

Étape 2 : Créer un service Analytics OpenSearch

Warning

La création d'un cluster entraîne des frais.

ovhcloud cloud managed-analytics create \
  --cloud-project <projectId> \
  --engine opensearch \
  --version 2.0 \
  --plan business \
  --nodes-pattern.flavor db1-7 \
  --nodes-pattern.region GRA \
  --nodes-pattern.number 3 \
  --description "My OpenSearch cluster" \
  --ip-restrictions "203.0.113.0/24"

Info

Pour des raisons de sécurité, la configuration réseau par défaut bloque toutes les connexions entrantes. Autorisez une adresse IP adaptée pour accéder à votre service Analytics.

Pour la mise en réseau privée, ajoutez --network-id <networkId> et --subnet-id <subnetId>.

Étape 3 : Attendre que votre service Analytics soit prêt

ovhcloud cloud managed-analytics get <clusterId> --cloud-project <projectId>

Son status passe à READY lorsque le cluster est disponible.

Étape 4 : Réinitialiser le mot de passe de l'utilisateur principal

# Lister les utilisateurs et récupérer l'ID de l'utilisateur admin
ovhcloud cloud managed-analytics user list <clusterId> --cloud-project <projectId>

# Réinitialiser le mot de passe de l'utilisateur admin
ovhcloud cloud managed-analytics user credentials-reset <clusterId> <userId> --cloud-project <projectId>

Warning

Ce mot de passe ne sera plus disponible par la suite : OVHcloud ne stocke pas les mots de passe utilisateur.

Étape 5 : Commencer à utiliser le cluster

Les informations de connexion au cluster sont disponibles dans votre espace client OVHcloud. Vous pouvez maintenant utiliser le cluster.

Étape 1 : Rassembler les paramètres requis pour OVHcloud

Le provider Terraform OVHcloud nécessite les identifiants suivants :

une application_key
un application_secret
une consumer_key

Pour les récupérer, suivez le guide Premiers pas avec les API OVHcloud. Générez des identifiants avec les droits suivants :

GET /cloud/project/*/database/*
POST /cloud/project/*/database/*
PUT /cloud/project/*/database/*
DELETE /cloud/project/*/database/*

Le service_name correspond à l'ID de votre projet Public Cloud. Récupérez-le via le bouton Copier dans le presse-papiers dans la section Public Cloud.

Étape 2 : Rassembler les paramètres requis

Pour créer un nouveau cluster OpenSearch, spécifiez au minimum :

le moteur (par exemple opensearch)
la version (par exemple 3.3)
la région (par exemple EU-WEST-PAR)
l'offre (par exemple production)
le flavor (par exemple b3-8)

Étape 3 : Créer les fichiers Terraform

Créez un fichier main.tf :

terraform {
  required_providers {
    ovh = {
      source  = "ovh/ovh"
      version = ">= 2.11.0"
    }
  }
}

provider "ovh" {
  endpoint           = var.ovh.endpoint
  application_key    = var.ovh.application_key
  application_secret = var.ovh.application_secret
  consumer_key       = var.ovh.consumer_key
}

resource "ovh_cloud_project_database" "service" {
  service_name = var.product.project_id
  description  = var.product.name
  engine       = var.product.engine
  version      = var.product.version
  plan         = var.product.plan
  nodes {
    region = var.product.region
  }
  nodes {
    region = var.product.region
  }
  nodes {
    region = var.product.region
  }
  flavor = var.product.flavor
  ip_restrictions {
    ip = var.product.ip
  }
}

resource "ovh_cloud_project_database_opensearch_user" "analyticsuser" {
  service_name = ovh_cloud_project_database.service.service_name
  cluster_id   = ovh_cloud_project_database.service.id
  name         = var.access.name
}

Créez un fichier variables.tf :

variable "ovh" {
  type = map(string)
  default = {
    endpoint           = "ovh-eu"
    application_key    = ""
    application_secret = ""
    consumer_key       = ""
  }
}

variable "product" {
  type = map(string)
  default = {
    project_id = ""
    name       = ""
    engine     = ""
    region     = "EU-WEST-PAR"
    plan       = "production"
    flavor     = "b3-8"
    version    = ""
    ip         = "0.0.0.0/32"
  }
}

variable "access" {
  type = map(string)
  default = {
    name = "johndoe"
  }
}

Utilisez ovh-eu pour l'API OVHcloud Europe, ou ovh-ca pour l'Amérique du Nord.

Créez un fichier secrets.tfvars avec vos valeurs réelles :

ovh = {
  endpoint           = "ovh-eu"
  application_key    = "<application_key>"
  application_secret = "<application_secret>"
  consumer_key       = "<consumer_key>"
}

product = {
  project_id = "<service_name>"
  name       = "opensearch-terraform"
  engine     = "opensearch"
  region     = "EU-WEST-PAR"
  plan       = "production"
  flavor     = "b3-8"
  version    = "3.3"
  ip         = "<ip_range>"
}

access = {
  name = "johndoe"
}

Info

Remplacez <service_name>, <application_key>, <application_secret>, <consumer_key> et <ip_range> par vos valeurs réelles.

Créez un fichier outputs.tf :

output "cluster_uri" {
  value = ovh_cloud_project_database.service.endpoints.0.uri
}

output "user_name" {
  value = ovh_cloud_project_database_opensearch_user.analyticsuser.name
}

output "user_password" {
  value     = ovh_cloud_project_database_opensearch_user.analyticsuser.password
  sensitive = true
}

Étape 4 : Exécuter

terraform init
terraform plan -var-file=secrets.tfvars
terraform apply -var-file=secrets.tfvars -auto-approve

Exportez les identifiants et l'URI :

export PASSWORD=$(terraform output -raw user_password)
export USER=$(terraform output -raw user_name)
export URI=$(terraform output -raw cluster_uri)

Votre cluster OpenSearch est maintenant prêt.

Un exemple pour Kafka est disponible dans le dépôt public-cloud-databases-examples/kafka/terraform.

Aller plus loin

Capacités d'OpenSearch

Premiers pas avec le service Analytics OpenSearch

Configurer vRack pour Public Cloud

Visitez notre chaîne Discord dédiée pour poser vos questions, faire part de vos commentaires et interagir directement avec l'équipe qui développe nos services Analytics.

Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.

Rejoignez notre communauté d'utilisateurs.

Cette page vous a-t-elle aidé ?