Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 13 Next »

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.

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}'
  • set up as environment variables via your administrative console:

Available configuration keys are

Name

Description

build_session_id

Sealights' Build Session ID for the application. Leave blank to use the value embedded in the jar/war artifacts

proxy

Specify a HTTP proxy used to communicate with the Sealights backend. Required when a corporate network prohibits communication to cloud services.
The default is to have no proxy configured. This does not inherit from http_proxy/https_proxy or http.proxyHost/https.proxyHost, you must set this specifically if a proxy is needed.

lab_id

Specify a Sealights Lab ID

auto_upgrade

Enable/disable agent auto-upgrade. Off by default.

version

The version of Auto-reconfiguration to use. Candidate versions can be found in this listing.
If auto_upgrade is turned on, a different version may be downloaded and used at runtime

  • No labels