New Relic NGINX integration buildpack for VMware Tanzu

Construye el paquete de compilación

1. Clona el repositorio del paquete de compilación en tu sistema:
   bash

   Copia

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

2. Cambie el directorio al paquete de compilación clonado.
3. Obtenga el archivo .envrc en el directorio del paquete de compilación:
   bash

   Copia

   $
   source .envrc

4. Instale Bosh CLI y Tile Generator:
   bash

   Copia

   $
   ./scripts/setup.sh

5. Para crear el paquete de compilación, tiene dos opciones:

• Solo construye el paquete de compilación:

  bash

  Copia

  $
  make clean
  $
  make package

  Se generarán los siguientes paquetes de compilación:

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

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

    O

• Construya el paquete de compilación creando un mosaico:

  bash

  Copia

  $
  make clean
  $
  make all

  Se generará el siguiente mosaico:

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

desplegar en Cloud Foundry

1. Cargue el paquete de compilación en Cloud Foundry y, opcionalmente, especifíquelo por nombre mediante la CLI de CF:

   bash

   Copia

   $
   cf create-buildpack newrelic_nginx_buildpack [BUILDPACK_ZIP_FILE_PATH] 99

2. Cree una carpeta llamada example y descargue el archivo example.tar.gz :

   bash

   Copia

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

   Acerca del directorio de ejemplo

   El directorio example contiene varios artefactos necesarios para el paquete de compilación. A continuación se muestra una descripción de cada artefacto y la documentación relacionada como referencia:

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

   Copia

   Descripciones de artefactos:

   • buildpack.yml:

     • Contiene la configuración para el paquete de compilación.
     • Acción requerida: actualice la información de la versión de NGINX para garantizar la compatibilidad con la última versión del paquete de compilación de NGINX.

   • manifest.yml:

     • Define la configuración y los metadatos relacionados con la aplicación.

     • Acción requerida: actualice este archivo con la información correcta de la aplicación y cerciorar de que el orden del paquete de compilación esté especificado correctamente. Esto es crucial para el correcto despliegue de su aplicación.

     • New Relic clave de licencia: Esta integración requiere una clave de licencia. Puede configurarlo en el archivo manifest.yml usando la variable de entorno NEW_RELIC_LICENSE_KEY: <ingest_key_value>. Alternativamente, la clave de licencia se puede obtener del corredor de servicios New Relic vinculando la aplicación.

     • Puerto de estado: según su configuración de NGINX, se requiere la información del puerto de estado. El valor del puerto predeterminado es 8080, que se puede configurar mediante la variable de entorno STATUS_PORT: 8080.

       • Nota: Se pueden configurar variables ambientales adicionales según sus requisitos.

     • El nginx_buildpack debe instalar antes newrelic_nginx_buildpack.

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

       • Consulte las siguientes páginas como referencia:

         • Emplee múltiples paquetes de compilación
         • Documentación de nginx_buildpack

   • mime.types:

     • Especifica los tipos MIME requeridos por el paquete de compilación NGINX.
     • Nota: Requerido por el paquete de compilación NGINX para servir diferentes tipos de archivos con tipos MIME apropiados.

   • nginx.conf:

     • Un archivo de configuración de plantilla principal para NGINX.
     • Nota: Requerido por el paquete de compilación NGINX para configurar cómo NGINX sirve la aplicación. Cerciorar de que location /nginx_status en nginx.conf coincida con STATUS_URL en nginx-config.yml.

   • nginx-config.yml:

     • Esta plantilla contiene ajustes de configuración para la integración de New Relic NGINX.
     • Acción requerida: consulte la documentación de New Relic NGINX para comprender las diversas opciones de configuración y ajustar las configuraciones según sea necesario.
     • Nota: Cerciorar de que el location /nginx_status en nginx.conf coincida con el STATUS_URL en nginx-config.yml.

   • public:

     • Contiene archivos estáticos que NGINX servirá.
     • Nota: El archivo index.html es fundamental como archivo predeterminado proporcionado por NGINX.

   Notas adicionales:

   • Cerciorar de que todos los archivos de configuración estén actualizados de acuerdo con la documentación y los requisitos de versión más recientes.
   • La configuración adecuada es esencial para el correcto funcionamiento del paquete de compilación y la aplicación a la que sirve.

3. Empuje la aplicación usando el comando cf push usando el manifest.yml:

   bash

   Copia

   $
   cf push

(Opcional) Vincule su aplicación al servicio New Relic Broker

Para integrar su aplicación con el servicio New Relic Broker, siga estos pasos:

1. Emplee la CLI de Cloud Foundry para crear una instancia de servicio New Relic:

   bash

   Copia

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

   Cerciorar de reemplazar <NEWRELIC_PLAN_NAME> con el plan New Relic deseado y <YOUR_NEWRELIC_SERVICE_INSTANCE_NAME> con un nombre para su instancia de servicio.

2. Vincule su aplicación a la instancia del servicio New Relic usando la CLI de CF:

   bash

   Copia

   $
   cf bind-service my_app <YOUR_NEWRELIC_SERVICE_INSTANCE_NAME>

   Cerciorar de reemplazar my_app con el nombre de su aplicación y <YOUR_NEWRELIC_SERVICE_INSTANCE_NAME> con el nombre de la instancia del servicio New Relic que creó.

3. Especifique la instancia del servicio New Relic en la sección services del archivo manifest.yml de su aplicación:

   services:
     - <YOUR_NEWRELIC_SERVICE_INSTANCE_NAME>

   Copia

4. Despliega tu aplicación con el manifiesto actualizado:

   bash

   Copia

   $
   cf push