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/databases/database-operator.md.

Installer l'opérateur Kubernetes pour les bases de données Public Cloud

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 de bases de données Public Cloud OVHcloud.

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

Afin de générer votre API OVHcloud, veuillez suivre 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 forme de chart Helm sur Docker Hub, un registre OCI.

Valeurs Helm

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

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

Notez que la valeur de région est soit ovh-eu, soit ovh-ca, soit 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 et 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éera l'opérateur, les CRD et les objets secrets.

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

Vous pouvez vérifier que l'opérateur est correctement installé en vérifiant 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

Et que le secret contenant vos identifiants OVHcloud est correctement créé :

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

Création de ressources personnalisées

Créez un objet de ressource personnalisée :

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

Ou avec un sélecteur de labels pour choisir précisément vos nœuds en fonction d'un label :

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

Le champ serviceId est facultatif. S'il n'est pas défini, l'opérateur s'exécutera sur tous les services de votre projet.

Appliquez-le au cluster :

kubectl apply -f cr.yaml

Vous pouvez vérifier qu'il a été correctement 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 le labeling Kubernetes afin de sélectionner des nœuds spécifiques sur lesquels vous souhaitez que l'opérateur s'exécute.

La ressource personnalisée créée et le nœud doivent avoir 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 de bases de données !

Cette page vous a-t-elle aidé ?