New Relic NGINX integration buildpack for VMware Tanzu

Construa o pacote de construção

1. Clone o repositório buildpack em seu sistema:
   bash

   Copiar

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

2. Mude o diretório para o buildpack clonado.
3. Obtenha o arquivo .envrc no diretório buildpack:
   bash

   Copiar

   $
   source .envrc

4. Instale Bosh CLI e gerador de blocos:
   bash

   Copiar

   $
   ./scripts/setup.sh

5. Para construir o buildpack, você tem duas opções:

• Construa apenas o buildpack:

  bash

  Copiar

  $
  make clean
  $
  make package

  Os seguintes buildpacks serão gerados:

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

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

    OU

• Construa o buildpack criando um bloco:

  bash

  Copiar

  $
  make clean
  $
  make all

  O seguinte bloco será gerado:

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

implantar o Cloud Foundry

1. Faça upload do buildpack no Cloud Foundry e, opcionalmente, especifique-o por nome usando a CLI do CF:

   bash

   Copiar

   $
   cf create-buildpack newrelic_nginx_buildpack [BUILDPACK_ZIP_FILE_PATH] 99

2. Crie uma pasta chamada example e baixe o arquivo example.tar.gz :

   bash

   Copiar

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

   Sobre o diretório de exemplo

   O diretório example contém vários artefatos necessários para o buildpack. Abaixo está uma descrição de cada artefato e documentação relacionada para referência:

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

   Copiar

   Descrições de artefatos:

   • buildpack.yml:

     • Contém configuração para o buildpack.
     • Ação necessária: atualize as informações da versão do NGINX para garantir a compatibilidade com a versão mais recente do buildpack do NGINX.

   • manifest.yml:

     • Define a configuração e os metadados relacionados ao aplicativo.

     • Ação necessária: Atualize este arquivo com as informações corretas do aplicativo e certifique-se de que a ordem do buildpack esteja especificada corretamente. Isso é crucial para a implantação adequada do seu aplicativo.

     • New Relic chave de licença: Esta integração requer uma chave de licença. Você pode configurá-lo no arquivo manifest.yml usando a variável de ambiente NEW_RELIC_LICENSE_KEY: <ingest_key_value>. Alternativamente, a chave de licença pode ser obtida no corretor de serviços New Relic vinculando o aplicativo.

     • Porta de status: com base na configuração do NGINX, as informações da porta de status são necessárias. O valor da porta padrão é 8080, que pode ser definido usando a variável de ambiente STATUS_PORT: 8080.

       • Nota: Variáveis ambientais adicionais podem ser definidas de acordo com suas necessidades.

     • O nginx_buildpack deve ser instalado antes de newrelic_nginx_buildpack.

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

       • Consulte as páginas a seguir para referência:

         • Use vários buildpacks
         • Documentação do nginx_buildpack

   • mime.types:

     • Especifica os tipos MIME exigidos pelo buildpack NGINX.
     • Nota: Exigido pelo buildpack NGINX para servir diferentes tipos de arquivos com tipos MIME apropriados.

   • nginx.conf:

     • Um arquivo de configuração de modelo primário para NGINX.
     • Observação: exigido pelo buildpack NGINX para configurar como o NGINX atende o aplicativo. Certifique-se de que location /nginx_status em nginx.conf corresponda a STATUS_URL em nginx-config.yml.

   • nginx-config.yml:

     • Este modelo contém definições de configuração para integração do New Relic NGINX.
     • Ação necessária: consulte a documentação do New Relic NGINX para entender as diversas opções de configuração e ajustar as configurações conforme necessário.
     • Nota: Certifique-se de que location /nginx_status em nginx.conf corresponda a STATUS_URL em nginx-config.yml.

   • public:

     • Contém arquivos estáticos que o NGINX servirá.
     • Observação: o arquivo index.html é crucial como arquivo padrão servido pelo NGINX.

   Notas Adicionais:

   • Certifique-se de que todos os arquivos de configuração estejam atualizados de acordo com a documentação e os requisitos de versão mais recentes.
   • A configuração adequada é essencial para a funcionalidade correta do buildpack e do aplicativo que ele atende.

3. Envie o aplicativo por push usando o comando cf push usando o manifest.yml:

   bash

   Copiar

   $
   cf push

(Opcional) Vincule seu aplicativo ao New Relic Broker Service

Para integrar seu aplicativo ao New Relic Broker Service, siga estas etapas:

1. Use a CLI do Cloud Foundry para criar uma instância de serviço New Relic:

   bash

   Copiar

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

   Certifique-se de substituir <NEWRELIC_PLAN_NAME> pelo plano New Relic desejado e <YOUR_NEWRELIC_SERVICE_INSTANCE_NAME> por um nome para sua instância de serviço.

2. Vincule seu aplicativo à instância de serviço New Relic usando a CLI do CF:

   bash

   Copiar

   $
   cf bind-service my_app <YOUR_NEWRELIC_SERVICE_INSTANCE_NAME>

   Certifique-se de substituir my_app pelo nome do seu aplicativo e <YOUR_NEWRELIC_SERVICE_INSTANCE_NAME> pelo nome da instância de serviço New Relic que você criou.

3. Especifique a instância do serviço New Relic na seção services do arquivo manifest.yml do seu aplicativo:

   services:
     - <YOUR_NEWRELIC_SERVICE_INSTANCE_NAME>

   Copiar

4. Implante seu aplicativo com o manifesto atualizado:

   bash

   Copiar

   $
   cf push