All Known Implementing Classes:
AbstractBuildLog

public interface BuildLog
Callback interface used to provide Builder output logging.
Since:
2.3.0
Author:
Phillip Webb, Scott Frederick, Andrey Shlykov, Rafael Ceccone
See Also:
  • Method Details

    • start

      void start(BuildRequest request)
      Log that a build is starting.
      Parameters:
      request - the build request
    • pullingImage

      Consumer<TotalProgressEvent> pullingImage(ImageReference imageReference, org.springframework.boot.buildpack.platform.build.ImageType imageType)
      Log that an image is being pulled.
      Parameters:
      imageReference - the image reference
      imageType - the image type
      Returns:
      a consumer for progress update events
    • pulledImage

      void pulledImage(Image image, org.springframework.boot.buildpack.platform.build.ImageType imageType)
      Log that an image has been pulled.
      Parameters:
      image - the image that was pulled
      imageType - the image type that was pulled
    • pushingImage

      Consumer<TotalProgressEvent> pushingImage(ImageReference imageReference)
      Log that an image is being pushed.
      Parameters:
      imageReference - the image reference
      Returns:
      a consumer for progress update events
    • pushedImage

      void pushedImage(ImageReference imageReference)
      Log that an image has been pushed.
      Parameters:
      imageReference - the image reference
    • executingLifecycle

      void executingLifecycle(BuildRequest request, org.springframework.boot.buildpack.platform.build.LifecycleVersion version, VolumeName buildCacheVolume)
      Log that the lifecycle is executing.
      Parameters:
      request - the build request
      version - the lifecycle version
      buildCacheVolume - the name of the build cache volume in use
    • runningPhase

      Consumer<LogUpdateEvent> runningPhase(BuildRequest request, String name)
      Log that a specific phase is running.
      Parameters:
      request - the build request
      name - the name of the phase
      Returns:
      a consumer for log updates
    • skippingPhase

      void skippingPhase(String name, String reason)
      Log that a specific phase is being skipped.
      Parameters:
      name - the name of the phase
      reason - the reason the phase is skipped
    • executedLifecycle

      void executedLifecycle(BuildRequest request)
      Log that the lifecycle has executed.
      Parameters:
      request - the build request
    • taggedImage

      void taggedImage(ImageReference tag)
      Log that a tag has been created.
      Parameters:
      tag - the tag reference
    • toSystemOut

      static BuildLog toSystemOut()
      Factory method that returns a BuildLog the outputs to System.out.
      Returns:
      a build log instance that logs to system out
    • to

      static BuildLog to(PrintStream out)
      Factory method that returns a BuildLog the outputs to a given PrintStream.
      Parameters:
      out - the print stream used to output the log
      Returns:
      a build log instance that logs to the given print stream