Créez votre propre fichier manifeste

Vous pouvez créer votre propre fichier manifeste à l'aide de Helm pour couvrir tous vos besoins, comme par exemple définir le proxy que vous souhaitez utiliser. Pour comprendre toute la puissance de Helm, nous vous recommandons de lire comment installer l’intégration Kubernetes à l’aide de Helm avant de parcourir ce document.

Compatibilité et exigences

• Assurez-vous que Helm correspond à votre version d’intégration Kubernetes. Par exemple, la version 3 de l’intégration Kubernetes nécessite Helm version 3.
• Un compte New Relic. Vous n'en avez pas ? Inscrivez-vous gratuitement ! Aucune carte de crédit requise.
• Votre New Relic clé de licence.
• Le nom de votre cluster Kubernetes.
  • Si vous avez besoin d’un nom d’affichage pour votre cluster, vous pouvez utiliser la sortie de la commande suivante :
    bash

    Copier

    $
    kubectl config current-context

Création de modèles d'intégration de Kubernetes avec Helm

1. Ajoutez le référentiel de cartes New Relic Helm en exécutant :

   bash

   Copier

   $
   helm repo add newrelic https://helm-charts.newrelic.com

2. Créez un fichier nommé values-newrelic.yaml, qui sera utilisé pour définir votre configuration, qui suit cette structure :

   Important

   Consultez notre documentation d'installation de Helm pour savoir comment le configurer.

   global:
     licenseKey: _YOUR_NEW_RELIC_LICENSE_KEY_
     cluster: _K8S_CLUSTER_NAME_
   
   newrelic-prometheus-agent:
     # Automatically scrape prometheus metrics for annotated services in the cluster
     enabled: true
   nri-metadata-injection:
     # Deploy our webhook to link APM and Kubernetes entities
     enabled: true
   nri-kube-events:
     # Report Kubernetes events
     enabled: true
   newrelic-logging:
     # Report logs for containers running in the cluster
     enabled: true
   kube-state-metrics:
     # Deploy kube-state-metrics in the cluster.
     # Set this to true unless it is already deployed.
     enabled: true

   Copier

3. Assurez-vous que tout est correctement configuré dans le graphique en exécutant la commande suivante. Notez que nous spécifions --dry-run et --debug, donc rien n'est installé à cette étape :

   bash

   Copier

   $
   helm upgrade --install newrelic newrelic/nri-bundle \
   >
   --namespace newrelic --create-namespace \
   >
   -f values-newrelic.yaml \
   >
   --dry-run \
   >
   --debug

   Veuillez noter et modifier les valeurs suivantes :

   Veuillez noter et ajuster les indicateurs suivants :

   • global.licenseKey=YOUR_NEW_RELIC_LICENSE_KEY: Doit être défini sur une valeur clé de licencevalide pour votre compte.

   • global.cluster=K8S_CLUSTER_NAME: Utilisé pour identifier le cluster dans l'interface utilisateur de New Relic, il doit donc s'agir d'une valeur descriptive non utilisée par un autre cluster Kubernetes configuré dans votre compte New Relic.

   • kube-state-metrics.enabled=true: Définissez ceci sur true pour installer automatiquement Kube State Métriques (KSM). Ceci est nécessaire pour que notre intégration fonctionne. Vous pouvez définir ceci sur false si KSM est déjà présent dans votre cluster, même s'il se trouve sur un espace de nommage différent.

   • newrelic-prometheus-agent.enabled=true: Définissez ceci pour déployer notre agent Prometheus , qui collecte automatiquement les données du point de terminaison Prometheus présent dans le cluster.

   • nri-metadata-injection.enabled=true: Définissez ceci pour installer notre webhook minimal, qui ajoute des variables d'environnement qui, à leur tour, permettent de lier les applications instrumentées avec New Relic APM à Kubernetes.

   Conseil

   Nos graphiques Kubernetes disposent d'un ensemble complet d'indicateurs et de paramètres que vous pouvez modifier pour mieux répondre à vos besoins spécifiques. Vérifiez comment configurer l'intégration ci-dessous pour voir ce que vous pouvez modifier.

4. Modélisez l'intégration Kubernetes en exécutant :

   bash

   Copier

   $
   helm template newrelic newrelic/nri-bundle \
   >
   --namespace newrelic --create-namespace \
   >
   -f values-newrelic.yaml > templated-nri-bundle.yaml

5. Appliquez le manifeste généré en exécutant :

   bash

   Copier

   $
   kubectl -n newrelic apply -f templated-nri-bundle.yaml

Mise à niveau à l'aide de Manifest

1. Mettez à jour le référentiel de graphiques local en exécutant :

   bash

   Copier

   $
   helm repo update

2. Créez un modèle du fichier en exécutant :

   bash

   Copier

   $
   helm template newrelic newrelic/nri-bundle \
   >
   --namespace newrelic --create-namespace \
   >
   -f values-newrelic.yaml > new-templated-nri-bundle.yaml

3. Désinstallez la version précédente de l'intégration Kubernetes, qui utilise le manifeste précédent, et appliquez la nouvelle en exécutant :

   bash

   Copier

   $
   kubectl -n newrelic delete -f templated-nri-bundle.yaml
   $
   kubectl -n newrelic apply -f new-templated-nri-bundle.yaml

Désinstaller l'intégration Kubernetes

Pour désinstaller l’intégration Kubernetes à l’aide de Helm, exécutez :

$
kubectl -n newrelic delete -f templated-nri-bundle.yaml