Pack de construction d'intégration New Relic NGINX pour VMware Tanzu

Construire le buildpack

1. Clonez le référentiel buildpack sur votre système :
   bash

   Copier

   $
   git clone https://github.com/newrelic/newrelic-pcf-nginx-buildpack

2. Changer de répertoire vers le buildpack cloné.
3. Sourcez le fichier .envrc dans le répertoire buildpack :
   bash

   Copier

   $
   source .envrc

4. Installer Bosh CLI et Tile Generator :
   bash

   Copier

   $
   ./scripts/setup.sh

5. Pour construire le buildpack, vous avez deux options :

• Construisez uniquement le buildpack :

  bash

  Copier

  $
  make clean
  $
  make package

  Les buildpacks suivants seront générés :

  • build/newrelic_nginx_buildpack-cached-cflinuxfs4-v*.zip

  • build/newrelic_nginx_buildpack-cached-cflinuxfs3-v*.zip

    OU

• Créez le buildpack en créant une tuile :

  bash

  Copier

  $
  make clean
  $
  make all

  La tuile suivante sera générée :

  • product/newrelic-pcf-nginx-buildpack-*.pivotal

Déployer à Cloud Foundry

1. Téléchargez le buildpack sur Cloud Foundry et spécifiez-le éventuellement par son nom à l'aide de la CF CLI :

   bash

   Copier

   $
   cf create-buildpack newrelic_nginx_buildpack [BUILDPACK_ZIP_FILE_PATH] 99

2. Créez un dossier nommé example et téléchargez l'archive example.tar.gz :

   bash

   Copier

   $
   mkdir example
   $
   cd example
   $
   wget https://github.com/newrelic/newrelic-pcf-nginx-buildpack/releases/download/v1.0.1/example.tar.gz

   À propos du répertoire d'exemples

   Le répertoire example contient divers artefacts nécessaires au buildpack. Vous trouverez ci-dessous une description de chaque artefact et la documentation associée pour référence :

   example/
   ├── buildpack.yml
   ├── manifest.yml
   ├── mime.types
   ├── nginx-config.yml
   ├── nginx.conf
   └── public
       └── index.html

   Copier

   Descriptions des artefacts :

   • buildpack.yml:

     • Contient la configuration du buildpack.
     • Action requise : mettez à jour les informations de version NGINX pour garantir la compatibilité avec la dernière version du buildpack NGINX.

   • manifest.yml:

     • Définit la configuration et les métadonnées liées à l'application.

     • Action requise : mettez à jour ce fichier avec les informations d’application correctes et assurez-vous que l’ordre du buildpack est correctement spécifié. Ceci est crucial pour le bon déploiement de votre application.

     • New Relic clé de licence : Cette intégration nécessite une clé de licence. Vous pouvez le définir dans le fichier manifest.yml en utilisant la variable d'environnement NEW_RELIC_LICENSE_KEY: <ingest_key_value>. Alternativement, la clé de licence peut être obtenue auprès du courtier de services New Relic en liant l'application.

     • Port d'état : en fonction de votre configuration NGINX, les informations sur le port d'état sont requises. La valeur du port par défaut est 8080, qui peut être définie à l'aide de la variable d'environnement STATUS_PORT: 8080.

       • Remarque : des variables environnementales supplémentaires peuvent être définies selon vos besoins.

     • Le nginx_buildpack doit être installé avant newrelic_nginx_buildpack.

       • Exemple: cf push my_app -b nginx_buildpack -b newrelic_nginx_buildpack

       • Voir les pages suivantes pour référence :

         • Utiliser plusieurs buildpacks
         • Documentation de nginx_buildpack

   • mime.types:

     • Spécifie les types MIME requis par le buildpack NGINX.
     • Remarque : requis par le buildpack NGINX pour servir différents types de fichiers avec les types MIME appropriés.

   • nginx.conf:

     • Un fichier de configuration de modèle principal pour NGINX.
     • Remarque : requis par le buildpack NGINX pour configurer la manière dont NGINX sert l'application. Assurez-vous que location /nginx_status dans nginx.conf correspond à STATUS_URL dans nginx-config.yml.

   • nginx-config.yml:

     • Ce modèle contient les paramètres de configuration pour l'intégration de New Relic NGINX.
     • Action requise : reportez-vous à la documentation de New Relic NGINX pour comprendre les différentes options de configuration et ajuster les paramètres si nécessaire.
     • Remarque : assurez-vous que le location /nginx_status dans nginx.conf correspond au STATUS_URL dans nginx-config.yml.

   • public:

     • Contient les fichiers statiques que NGINX servira.
     • Remarque : le fichier index.html est essentiel en tant que fichier par défaut servi par NGINX.

   Notes supplémentaires :

   • Assurez-vous que tous les fichiers de configuration sont mis à jour conformément à la documentation la plus récente et aux exigences de version.
   • Une configuration appropriée est essentielle pour le bon fonctionnement du buildpack et de l'application qu'il sert.

3. Poussez l'application à l'aide de la commande cf push en utilisant le manifest.yml:

   bash

   Copier

   $
   cf push

(Facultatif) Liez votre application au service New Relic Broker

Pour intégrer votre application au service New Relic Broker, suivez ces étapes :

1. Utilisez l'interface de ligne de commande Cloud Foundry pour créer une instance de service New Relic :

   bash

   Copier

   $
   cf create-service newrelic <NEWRELIC_PLAN_NAME> <YOUR_NEWRELIC_SERVICE_INSTANCE_NAME>

   Assurez-vous de remplacer <NEWRELIC_PLAN_NAME> par le plan New Relic souhaité et <YOUR_NEWRELIC_SERVICE_INSTANCE_NAME> par un nom pour votre instance de service.

2. Liez votre application à l’instance de service New Relic à l’aide de la CLI CF :

   bash

   Copier

   $
   cf bind-service my_app <YOUR_NEWRELIC_SERVICE_INSTANCE_NAME>

   Assurez-vous de remplacer my_app par le nom de votre application et <YOUR_NEWRELIC_SERVICE_INSTANCE_NAME> par le nom de l'instance de service New Relic que vous avez créée.

3. Spécifiez l'instance de service New Relic dans la section services du fichier manifest.yml de votre application :

   services:
     - <YOUR_NEWRELIC_SERVICE_INSTANCE_NAME>

   Copier

4. déployez votre application avec le manifeste mis à jour :

   bash

   Copier

   $
   cf push