Comment ajouter l'agent Java APM Insight dans Kubernetes via InitContainers ?

Ajout d'un agent APM Insight Java dans Kubernetes via InitContainers

Étape 1 :
Créez un secret pour la clé de licence Site24x7 dans l'espace de noms de votre application.
NotesVous pouvez obtenir la clé de licence sur votre compte Site24x7 en accédant à Administration > Développeur > Clé de l'appareil.
      Exemple :
  1. kubectl create secret generic app-secret --from-literal=s247licensekey='your_s247_license_key' -n petclinic
            Remplacez secret-application, votre_clé_de_licence_s247, et l'espace de nom (petclinic) par les valeurs correctes.

Étape 2 :
Créez un volume vide qui sera utilisé pour copier les fichiers de l'agent durant le processus InitContainers.

      Exemple :
  1. volumes:
  2.    - name: s247agent

Étape 3 :
Incluez la commande InitContainers suivante dans votre fichier YAML de graphique helm/déploiement.
  1. initContainers:
  2.       - name: agent-copy
  3.         image: site24x7/apminsight-javaagent:latest
  4.         imagePullPolicy: IfNotPresent
  5.         command: ['cp', '-r', '/opt/site24x7/.', '/home/apm']
  6.         volumeMounts:
  7.         - name: s247agent
  8.           mountPath: /home/apm

Étape 4 :
Montez le volume créé à l'étape 2 dans votre conteneur d'application.
      
      Exemple :
  1. containers:
  2.       - name: petclinic
  3.         image: petclinic:latest
  4.         imagePullPolicy: IfNotPresent
  5.         ports:
  6.         - containerPort: 8080
  7.        volumeMounts:
  8.         - name: s247agent
  9.           mountPath: /home/apm

Étape 5 :
Ajoutez les variables de l'environnement suivant aux conteneurs d'application.
      
      Variable d'environnement 1 :
      Nom: S247_LICENSE_KEY 
      Valeur: s247licensekey from the secret added in step 1
      
      Environment variable 2:
      Nom: JAVA_TOOL_OPTIONS 
      Valeur: "-javaagent:[mount/path]/apminsight-javaagent.jar -Dapminsight.application.name=[DesiredMonitorName]"

Notes
À cette étape, nous configurons les arguments que l'application (processus Java) utilisera durant le démarrage et l'agent qui rapporte les données au nom de moniteur spécifié.

      Exemple :
  1. env:
  2.         - name: JAVA_TOOL_OPTIONS
  3.           value: -javaagent:/home/apm/apminsight-javaagent.jar -Dapminsight.application.name=petclinic-k8s
  4.         - name: S247_LICENSE_KEY
  5.           valueFrom:
  6.             secretKeyRef:
  7.               name: petclinic-secrets
  8.               key: s247_license_key
      
      Exemple de fichier de déploiement YAML pour référence :
  1. apiVersion: v1
  2. kind: Namespace
  3. metadata:
  4.   name: petclinic

  6. ---
  7. apiVersion: v1
  8. kind: Secret
  9. metadata:
  10.   name: petclinic-secrets
  11.   namespace: petclinic
  12. type: Opaque
  13. data:
  14.   s247_license_key: OGQ3NTg0YmIxNWE1YTIzYjhmN35rfed2M1M2U3N2ExOTVhNzM1YWYyMg==

  16. ---
  17. apiVersion: apps/v1
  18. kind: Deployment
  19. metadata:
  20.   namespace: petclinic
  21.   name: petclinic-deployment
  22.   labels:
  23.     app: petclinic
  24. spec:
  25.   replicas: 2
  26.   selector:
  27.     matchLabels:
  28.       app: petclinic
  29.   template:
  30.     metadata:
  31.       labels:
  32.         app: petclinic
  33.     spec:
  34.       containers:
  35.       - name: petclinic
  36.         image: petclinic:latest
  37.         imagePullPolicy: IfNotPresent
  38.         ports:
  39.         - containerPort: 8080
  40.         env:
  41.         - name: JAVA_TOOL_OPTIONS
  42.           value: -javaagent:/home/apm/apminsight-javaagent.jar -Dapminsight.application.name=petclinic-k8s
  43.         - name: S247_LICENSE_KEY
  44.           valueFrom:
  45.             secretKeyRef:
  46.               name: petclinic-secrets
  47.               key: s247_license_key
  48.         volumeMounts:
  49.         - name: s247agent
  50.           mountPath: /home/apm
  51.       initContainers:
  52.       - name: agent-copy-init
  53.         image: site24x7/apminsight-javaagent:latest
  54.         imagePullPolicy: IfNotPresent
  55.         command: ['cp', '-r', '/opt/site24x7/.', '/home/apm']
  56.         volumeMounts:
  57.         - name: s247agent
  58.           mountPath: /home/apm
  59.       volumes:
  60.       - name: s247agent

  62. ---
  63. apiVersion: v1
  64. kind: Service
  65. metadata:
  66.   namespace: petclinic
  67.   name: petclinic-service
  68. spec:
  69.   type: NodePort
  70.   selector:
  71.     app: petclinic
  72.   ports:
  73.     - protocol: TCP
  74.       port: 8080
  75.       targetPort: 8080
  76.       nodePort: 30200