For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/fr/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/fr/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/fr/guides/public-cloud/data-analytics/analytics/database-operator.md.

Installer l'opérateur Kubernetes pour les services Analytics

Voir en Markdown

Découvrez comment installer et utiliser l'opérateur de base de données Kubernetes

Objectif

L'opérateur de base de données Kubernetes vous permet d'autoriser automatiquement l'IP de votre cluster Kubernetes sur votre service OVHcloud Analytics.

Ce guide explique comment installer et utiliser l'opérateur de base de données afin d'autoriser l'IP Kubernetes sur votre service.

Prérequis

Récupérer les informations de vos tokens API OVHcloud

Pour générer votre API OVHcloud, suivez notre tutoriel Premiers pas avec les API OVHcloud.

Plus précisément, vous devez générer ces identifiants via la avec les droits suivants :

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

En pratique

L'opérateur de base de données Kubernetes est stocké sous la forme d'un chart Helm sur Docker Hub, un registre OCI.

Valeurs Helm

La première étape consiste à créer un fichier values.yaml.

Remplacez les XXXX par les identifiants récupérés précédemment.

Notez que la valeur de la région est ovh-eu, ovh-ca ou ovh-us.

ovhCredentials:
  applicationKey: XXXX
  applicationSecret: XXXX
  consumerKey: XXXX
  region: ovh-eu # ovh-eu, ovh-ca or ovh-us

namespace: ovhcloud # Your Kubernetes namespace

Installation

Utilisez le gestionnaire de paquets Kubernetes helm ainsi que le fichier de valeurs que vous avez créé pour installer l'opérateur.

helm install -f values.yaml public-cloud-databases-operator oci://registry-1.docker.io/ovhcom/public-cloud-databases-operator --version 0.1.1

Cette commande crée l'opérateur, les CRD et les objets secret.

Vous pouvez trouver la dernière version du chart Helm sur DockerHub.

Vous pouvez vérifier que l'opérateur est correctement installé en contrôlant les Pods dans le nouveau namespace Kubernetes :

kubectl get deploy -n ovhcloud
NAME                              READY   UP-TO-DATE   AVAILABLE   AGE
public-cloud-databases-operator   1/1     1            1           60m

Ainsi que le secret contenant vos identifiants OVHcloud, qui doit être correctement créé :

kubectl get secret ovh-credentials -n ovhcloud
NAME              TYPE     DATA   AGE
ovh-credentials   Opaque   4      60m

Créer des ressources personnalisées

Créez un objet de ressource personnalisée :

apiVersion: cloud.ovh.net/v1alpha1
kind: Database
metadata:
  name: myanalyticsservice
  namespace: ovhcloud
spec:
  projectId: XXXX # ID of your Public Cloud project ID
  serviceId: XXX # ID of your Analytics service

Ou avec un sélecteur de label pour cibler vos nœuds en fonction d'un label :

apiVersion: cloud.ovh.net/v1alpha1
kind: Database
metadata:
  name: myanalyticsservice
  namespace: ovhcloud
spec:
  projectId: XXXX # ID of your Public Cloud project ID
  serviceId: XXX #ID of your Analytics service
  labelSelector:
    matchLabels:
      LABELNAME: LABELVALUE

Le champ serviceId est facultatif. S'il n'est pas défini, l'opérateur sera exécuté sur l'ensemble des services de votre projet.

Appliquez-le au cluster :

kubectl apply -f cr.yaml

Vous pouvez vérifier qu'il a bien été créé à l'aide de cette commande :

kubectl kubectl -n ovhcloud get database
NAME                              AGE
public-cloud-databases-operator   59m

Labels des nœuds

Vous pouvez utiliser l'étiquetage Kubernetes afin de sélectionner les nœuds spécifiques sur lesquels vous souhaitez que l'opérateur soit exécuté.

La CR créée et le nœud doivent porter le même label et la même valeur.

kubectl label nodes NODENAME1 NODENAME2 ... LABELNAME=LABELVALUE

Aller plus loin

Nous voulons vos retours !

Nous serions ravis de répondre à vos questions et apprécions tout retour que vous pourriez nous faire.

Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur ce lien pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services.

Vous êtes sur Discord ? Rejoignez notre chaîne via https://discord.gg/ovhcloud et interagissez directement avec l’équipe qui développe notre service Analytics !

Rejoignez notre communauté d'utilisateurs.

Cette page vous a-t-elle aidé ?