/procfile

A buildpack for translating a Procfile into Process Types

Primary LanguageGoApache License 2.0Apache-2.0

gcr.io/paketo-buildpacks/procfile

The Procfile Buildpack is a Cloud Native Buildpack that turns the contents of a Procfile into process types.

Behavior

This buildpack will participate if one or all of the following conditions are met:

  • The application contains a Procfile
  • A Binding exists with type Procfile and secret containing a Procfile

The buildpack will do the following:

  • Contribute the process types from one or both Procfile files to the image.
    • If process types are identified from both Binding and file, the contents are merged into a single Procfile. Commands from the Binding take precedence if there are duplicate types.
    • If the application's stack is io.paketo.stacks.tiny the contents of the Procfile must be single command with zero or more space delimited arguments. Argument values containing whitespace should be quoted. The resulting process will be executed directly and will not be parsed by the shell.
    • If the application's stack is not io.paketo.stacks.tiny the contents of Procfile will be executed as a shell script.

Bindings

The buildpack optionally accepts the following bindings:

Key Value Description
Procfile List of<process-type>: <command> entries The entries from this Binding will be merged with those from the application's Procfile, if both are present. The commands from this Binding take precedence over the application's Procfile if there are duplicate process-types.

License

This buildpack is released under version 2.0 of the Apache License.