Installation de l'agent hôte sur Oracle Container Engine for Kubernetes (OKE)

La méthode recommandée pour installer l'agent est via le graphique Helm . Pour effectuer une installation manuelle, suivez les étapes de l'installation standard d' Kubernetes.

Lors de la création d'un cluster Kubernetes sur Oracle Container Engine for Kubernetes (OKE), il est possible d'installer Helm; pour plus d'informations sur l'utilisation de HelmTiller (Helm) Enabled sur OKE, consultez la documentation OKE intitulée « Création d'un cluster Kubernetes ».

Comparez la version d'Helm qui est installée dans le cluster avec la version installée sur votre poste de travail.

helm version

Si la version d'Helm installée dans le cluster Kubernetes nouvellement créé est antérieure à la version d'Helm installée sur votre poste de travail, mettez-le à jour avec la commande suivante :

helm init --upgrade

Copiez le graphique « Instana » ( helm ) sur votre poste de travail.

git clone https://github.com/instana/helm-charts

Désignez le répertoire cloné comme répertoire de travail.

cd helm-charts/stable/instana_agent

Cliquez sur « Paramètres » dans la barre latérale de l'interface utilisateur d' Instana. Sélectionnez « Installer l'agent », puis notez la clé d'agent unique et le point de terminaison de l'agent indiqués dans le panneau de l' Docker. A présent, éditez le fichier values.yaml en ajoutant les valeurs suivantes :

image:
  name: icr.io/instana/agent
  tag: latest
  pullPolicy: IfNotPresent

rbac:
  create: true

instana:
  zone: Oracle-OKE
  leaderElectorPort: 42655
  agent:
    key: <your unique key here>
    name: instana-agent
    endpoint:
      host: <regional endpoint here>
      port: 443

## Annotations to be added to pods
podAnnotations: {}

Pour finir, procédez à l'installation à l'aide de la commande « helm » :

helm install --name instana-agent --namespace instana-agent .

Une fois l'agent hôte installé, vous pouvez vérifier son état dans l'interface utilisateur d' Instana ou directement sur l'hôte. Pour plus d'informations, voir Vérification du statut de l'agent hôte.

Les types d'application suivants doivent d'abord accéder à l'agent :

• Node.js
• Go
• Ruby
• Python
• .NET Core

Les applications développées pour ces environnements d'exécution doivent savoir sur quelle adresse IP l'agent hôte est à l'écoute sur le même nœud Kubernetes. Étant donné que l'agent écoutera automatiquement sur l'adresse IP de l'hôte, utilisez l'extrait de code d' API descendante suivant pour transmettre l'adresse IP de l'agent hôte, via une variable d'environnement, au pod de l'application :

spec:
  containers:
      env:
        - name: INSTANA_AGENT_HOST
          valueFrom:
            fieldRef:
              fieldPath: status.hostIP

Si l'installation de l'agent échoue au début, vous pouvez consulter les messages de journal et les conseils d'identification et de résolution des problèmes. Si cette section consacrée au dépannage ne répond pas à vos questions, veuillez contacter l'équipe d'assistance de IBM Instana en lui fournissant des détails sur votre expérience, afin que nous puissions vous aider et mettre à jour notre documentation en conséquence.

Pour obtenir des informations générales sur le traitement des incidents liés à tous les agents hôte, voir Gestion des agents hôte / Traitement des incidents.