Installation manuelle de l'édition personnalisée

Modifier en ligne

Vous pouvez installer manuellement l'édition personnalisée auto-hébergée ( Kubernetes ou Red Hat OpenShift Container Platform ).

Vous devez disposer des droits d'administrateur de cluster pour déployer Custom Edition.

Prérequis

Modifier en ligne

  1. Consultez les exigences relatives à l'opérateur d' Instana. Pour plus d'informations, consultez la page Instana Enterprise operator.

  2. Consultez les conditions requises pour l'installation de l'édition personnalisée auto-hébergée ( Kubernetes ou Red Hat OpenShift Container Platform ) ainsi que les conditions requises en matière d'accès réseau sortant pour les déploiements auto-hébergés d' Instana. Assurez-vous que les conditions requises sont remplies avant d'installer le backend d' Instana.

  3. Configurez les magasins de données requis. Pour plus d'informations, consultez la section « Configuration des magasins de données ».

  4. Assurez-vous que le config.yaml fichier a bien été créé. Ce fichier est nécessaire pour configurer les composants du backend. Pour plus d'informations sur les composants backend, consultez la page Instana backend components.

Procédure d'installation

Modifier en ligne

  1. Installez le kubectl plug-in. Pour plus d'informations, consultez la section Installation du plug-in kubectl Instana.

  2. Installez et configurez l'opérateur d'entreprise d' Instana s dans votre cluster Kubernetes ou Red Hat OpenShift :

    1. Créer des secrets d' TLS s pour le webhook d'admission. Sélectionnez l'une des options suivantes :

    2. Créer des secrets de récupération d'images. Pour plus d'informations, consultez la section Création de secrets de récupération d'images.

      Remarque : si vous ne disposez pas de votre propre registre Docker qui fait office de miroir pour « artifact-public.instana.io » et que vous n'avez pas besoin de secrets de récupération d'images, créez un secret de récupération d'images.

    3. Créez et configurez le fichier de paramètres. Pour plus d'informations, consultez la section « Création et configuration du fichier de valeurs ».

      Remarque : avant d'installer l' Instana Enterprise Operator, vous devez mettre à jour le champ « imagePullSecrets » dans le values fichier.

    4. Installez l'opérateur d'entrepris Instana. Pour plus d'informations, consultez la section « Installation de l'opérateur Enterprise d' Instana ».

    5. Facultatif : utilisez la configuration avancée des opérateurs. Pour plus d'informations, consultez la section « Utilisation de la configuration avancée des opérateurs ».

      Remarque : une fois l' Instana Enterprise Operator installé, vous pouvez le configurer selon vos besoins à l'aide du fichier de paramètres.

  3. Installez les composants du backend d' Instana :

    1. Créer des espaces de noms pour les objets Core et Unit. Pour plus d'informations, consultez la section Création d'espaces de noms.

    2. Créer des secrets de récupération d'images pour les objets Core et Unit. Pour plus d'informations, consultez la section Création de secrets de récupération d'images.

    3. Téléchargez votre fichier de licence. Pour plus d'informations, consultez la section « Téléchargement du fichier de licence ».

    4. Créer des secrets :

      1. Secret instana-tls

      2. Le secret ultime

      3. Le secret de l'unité

    5. Créer un objet Core :

      1. Créer un fichier objet Core avec une configuration de base. Pour plus d'informations, consultez la section « Configuration de base ».

      2. Facultatif : Configurer les ressources CPU/mémoire. Pour plus d'informations, consultez la section Ressources CPU/mémoire.

      3. Configurer l'Agent Acceptor. Pour plus d'informations, consultez la section « Agent Acceptor ».

      4. Configurer le stockage des données Raw. Pour plus d'informations, consultez la section « Stockage des segments bruts ».

      5. Configurer les magasins de données. Pour plus d'informations, consultez la section « Stockages de données ».

      6. Facultatif : Configurer les paramètres par défaut de conservation des données. Pour plus d'informations, consultez la section « Remplacer les paramètres par défaut de conservation des données ».

      7. Appliquez les configurations de l'objet principal. Pour plus d'informations, consultez la section « Application des configurations de base ».

    6. Créez un objet Unit. Pour plus d'informations, consultez la section Création d'une unité.

  4. Configurez des équilibreurs de charge et des serveurs de réplication ( DNS ) pour les services Acceptor et Gateway. Pour plus d'informations, consultez les sections « Configuration des équilibreurs de charge » et « DNS ».

  5. Facultatif : activez les fonctionnalités qui ne sont pas activées par défaut dans les déploiements auto-hébergés. Pour plus d'informations, consultez la section « Activation des fonctionnalités optionnelles pour l'édition personnalisée ».

  6. Facultatif : se conformer aux exigences FIPS. Pour plus d'informations, consultez la section « Conformité aux exigences FIPS ».

Ressources requises : définitions de ressources personnalisées

Modifier en ligne

Les définitions de ressources personnalisées (CRD) sont des extensions de l'API Kubernetes.

Les deux fichiers CRD suivants sont requis lors du déploiement du backend d' Instana. Ils doivent être installés sur le même cluster que le backend d' Instana.

cores.instana.io

Modifier en ligne

Un « Core » désigne l'ensemble des composants communs à une installation d' Instana. Chaque coeur possède un ensemble de bases de données associées, qui sont utilisées par le coeur lui-même et par tous les locataires avec leurs unités de locataire respectives qui sont créées en tant que membres du coeur.

Pour plus d'informations, consultez la documentation de API.

units.instana.io

Modifier en ligne

Les unités représentent des pools de données individuels dans Instana. En interne, Instana comporte des locataires, qui ne sont qu'une construction logique. Chaque titulaire possède à son tour au moins une ou plusieurs unités titulaires. En ce qui concerne la configuration, vous configurez toujours les unités de titulaire à l'aide de la définition de ressource personnalisée d'unité. Un locataire peut représenter un service (par exemple, SRE, Dev, QA) ou tout autre regroupement logique. Au sein d'un locataire, vous pouvez créer des unités individuelles selon les besoins. Les données d'une unité ne sont pas visibles d'une autre unité.

Par exemple, il existe deux services : le commerce électronique et l'intranet.

ecommerce a trois environnements: dev, preprod, prod. Intranet dispose de deux environnements: dev et prod. Dans ce cas, vous pouvez créer un ecommerce de locataire avec les unités de locataire dev, preprod et prod, et un intranet de locataire avec les unités de locataire dev et prod.

Les unités de locataire sont séparées et ne reçoivent des données que des agents qui leur sont associés.

Pour plus d'informations, consultez la documentation d' API.

Conseils

Modifier en ligne

Conseil n° 1

Modifier en ligne

Vous pouvez également consulter la documentation sur l' API e en exécutant la commande « kubectl explain ».

Exécutez la commande « kubectl explain --help » pour obtenir des détails sur son utilisation.

Voir l'exemple suivant :

kubectl explain core.spec.serviceProviderConfig
KIND:     Core
VERSION:  instana.io/v1beta2

RESOURCE: serviceProviderConfig <Object>

DESCRIPTION:
     Service provider configuration for SAML or OIDC.

FIELDS:
   basePath     <string> -required-
     Base URL (defaults to "/auth").

   maxAuthenticationLifetimeSeconds     <integer> -required-
     The maximum authentication lifetime (defaults to 604.800).

   maxIDPMetadataSizeInBytes    <integer> -required-
     The maximum IDP metadata size (defaults to 200.000).

Conseil n° 2

Modifier en ligne

Un bon éditeur, tel que VS Code avec l'extension Kubernetes, permet d'exécuter la commande lorsque les définitions de ressources personnalisées sont installées sur le cluster.

Voir l'exemple suivant :

Code VS