home

The home for ideas and exploration. Mainly documentation, videos and discussion.

Resources

Documentation

• Background
• Evaluating
  • Locally
  • on Tanzu Application Service

Community talks

• The Secret Lives of Java Apps: Stories Told at Runtime
  • delivered @ Seattle Java Users Group (May 21, 2024)

Pre-built artifacts

• .jar files

  • cf-archivist
  • cf-butler
  • cf-hoover
  • cf-hoover-ui
  • spring-boot-starter-runtime-meta-data

• Container images on Docker Hub

Prerequisites

Required

• CF API endpoint and admin credentials to a Cloud Foundry foundation (e.g., Tanzu Application Service)

Optional

• Operations Manager admin credentials
• VMware Tanzu Network API token

Toolset

• gh
• git
• cf
• docker (make sure you have the compose plugin)
• http
• jq
• pack
• sdk

How to

On Tanzu Application Service

You'll need to author two configuration files named secrets.cf-butler.{foundation}.json and secrets.cf-archivist.{foundation}.json and place them in the /tmp/config directory. Crib from the samples in footprints/tas/config.

• Install
• Uninstall
• Expose curated set of Spring Boot Actuator endpoints
• Set Java artifacts fetch mode on a cf-butler instance
• Update Spring Cloud Config Server instance mirror backing cf-hoover instance
• Switch backend to MySQL

With Docker Compose

You'll need to author two configuration files named butler.env and archivist.env underneath footprints/local/docker/config. Crib from the *.sample files.

• Build container images
• Startup
• Shutdown
• Show logs for a service
• Status

Work with available endpoints

This is not an exhaustive list. Refer to respective service documentation for more details.

• Trigger fresh collection on cf-butler
  • on TAS: http POST {cf-butler-route}/collect
  • w/ Docker Compose: http POST :8080/collect
• Trigger cache refresh on cf-hoover-ui
  • on TAS: http POST {cf-hoover-ui-route}/cache/refresh
  • w/ Docker Compose: http POST :8083/cache/refresh
• Trigger cache refresh on cf-archivist
  • on TAS: http POST {cf-archivist-route}/cache/refresh
  • w/ Docker Compose: http POST :8081:/cache/refresh