Skip to content

Latest commit

 

History

History
56 lines (38 loc) · 4.63 KB

buildpack-modes.md

File metadata and controls

56 lines (38 loc) · 4.63 KB
Raw

Buildpack Modes

The Java Buildpack has three execution modes as described in the blog post, 'Packaged and Offline Buildpacks'.

  • Easy Mode: Uses the repository at https://download.run.pivotal.io. This does not require any cloning or downloading unless you want to modify the Cloud Foundry provided buildpack. This is the default, and what we recommend to anyone who asks.
  • Expert Mode: Refers to a repository hosted at a different location, possibly on an internal network. The structure of the repository is defined as an HTTP-accessible collection of files. The repository root must contain an index.yml file that is a mapping of concrete versions to absolute URIs. This repository can be created manually or creating a replica for the repository at https://download.run.pivotal.io. This is what we would recommend to any customer that didn’t want to access the Internet. It’s easy to keep applications secure and up-to-date, but requires the expertise to run a web-server and keep it up to date.
  • Offline Mode: Uses only the packaged internal cache. This is what we recommend if you wanted a single, self-contained artifact. The downside is having to package and keep all your dependencies up to date.

Easy Mode

The "Easy Mode" buildpack is included in all Cloud Foundry distributions and used by default. To configure the buildpack, refer to Configuration and Extension.

You can also download specific versions of the buildpack to use with the create-buildpack, and update-buildpack Cloud Foundry CLI commands. To find these, navigate to the Java Buildpack Releases page and download one of the following:

  • java-buildpack-v<VERSION>.zip
  • Source Code (zip)

To add the buildpack to an instance of Cloud Foundry, use the cf create-buildpack java-buildpack java-buildpack-v<VERSION>.zip command. For more details refer to the Cloud Foundry buildpack documentation.

Expert Mode

The "Expert Mode" buildpack is a minor fork of the default Java Buildpack. For details on configuring the buildpack, refer to Configuration and Extension. To configure the buildpack to point at an alternate repository, modify the config/repository.yml file to use a different default_repository_root.

# Repository configuration
---
default_repository_root: https://<ALTERNATE_HOST>

Once the buildpack has been modified, it needs to be packaged and uploaded to the Cloud Foundry instance. In order to package the modified buildpack, refer to Building Packages. To add the buildpack to an instance of Cloud Foundry, use the cf create-buildpack java-buildpack java-buildpack-v<VERSION>.zip command. For more details refer to the Cloud Foundry buildpack documentation.

Replicating the Repository (Optional)

The easiest way to create a fully populated internal repository is to replicate the one found at https://download.run.pivotal.io. The Java Buildpack Dependency Builder contains a replicate script that automates this process. To use the script, issue the following commands from the root directory of a clone of this repository:

$ bundle install
$ bundle exec bin/replicate [--base-uri <BASE-URI> | --host-name <HOST-NAME>] --output <OUTPUT>

For details on using the replicate script refer to Replicating Repository.

Offline Mode

The "Offline Mode" buildpack is a self-contained packaging of either the "Easy Mode" or "Expert Mode" buildpacks.

You can download specific versions of the "Offline Mode" buildpack to use with the create-buildpack and update-buildpack Cloud Foundry CLI commands. To find these, navigate to the Java Buildpack Releases page and download one of the java-buildpack-offline-v<VERSION>.zip file. In order to package a modified "Offline Mode" buildpack, refer to Building Packages. To add the buildpack to an instance of Cloud Foundry, use the cf create-buildpack java-buildpack java-buildpack-offline-v<VERSION>.zip command. For more details refer to the Cloud Foundry buildpack documentation.