Adding the Sealights java agent into you Pivotal Cloud Foundry / VMWare Tanzu Application Services is done by using the standard java buildpack 4.39 or later.
Complimentary information is detailed in https://github.com/cloudfoundry/java-buildpack/blob/main/docs/framework-sealights_agent.md
Prerequisite: Installing CF Java buildpack
The java-buildpack
is a Cloud Foundry buildpack for running JVM-based applications and configured in one of the following ways:
Option A: In the manifest.yml
of your app, add the cloudfoundry java-buildpack
--- applications: - name: yourApp buildpacks: - https://github.com/cloudfoundry/java-buildpack
Option B: Add the buildpack through the command line
cf push -b https://github.com/cloudfoundry/java-buildpack
If you need to create an offline buildpack without network access you can do so following the instructions here: https://github.com/cloudfoundry/java-buildpack#offline-package
Create your Sealights User-Provided service
Create a Sealights User-Provided Service and configure it with an agent token. This should be done once, before configuring the first application.
Linux | cf cups sealights -p '{"token":"ey…"}' |
Windows | cf cups sealights -p "{\"token\":\"ey…\"}" |
A different name for the user-provided service may be used, but it has to include the word sealights
(lowercase) for the integration to work
The token may later be changed using: cf update-user-provided-service sealights -p ....
Bind your application to your Sealights service
Bind the User-Provided Service with your application using the following command
cf bind-service [app name] sealights
If the build session id, lab id, proxy or other settings need to be configured, you may either:
hard-code them in
manifest.yml
:env: JBP_CONFIG_SEALIGHTS_AGENT: '{lab_id: yourLabId}'
pass them as environment variables for the application via a dedicated command:
cf set-env [my-application] JBP_CONFIG_SEALIGHTS_AGENT '{lab_id: "myLabId", proxy: "http://myproxy.mycompany.int"}'
set up as environment variables via your administrative console:
Available configuration keys are
Name | Description |
---|---|
| Sealights' Build Session ID for the application. Leave blank to use the value embedded in the jar/war artifacts |
| Specify a HTTP proxy used to communicate with the Sealights backend. Required when a corporate network prohibits communication to cloud services. |
| Specify a Sealights Lab ID |
| Enable/disable agent auto-upgrade. Off by default. |
| The version of Auto-reconfiguration to use. Candidate versions can be found in this listing. |