Documentation ¶
Overview ¶
Package dockerfile has utilities that complement Docker's official Dockerfile parser.
Index ¶
- func Env(m []KeyValue) (string, error)
- func FindAll(node *parser.Node, cmd string) []int
- func From(image string) (string, error)
- func InsertInstructions(node *parser.Node, pos int, instructions string) error
- func Label(m []KeyValue) (string, error)
- func LastBaseImage(node *parser.Node) string
- func LastExposedPorts(node *parser.Node) []string
- type KeyValue
- type ShellLex
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Env ¶
Env builds an ENV Dockerfile instruction from the mapping m. Keys and values are serialized as JSON strings to ensure compatibility with the Dockerfile parser.
func FindAll ¶
FindAll returns the indices of all children of node such that node.Children[i].Value == cmd. Valid values for cmd are defined in the package github.com/docker/docker/builder/dockerfile/command.
func InsertInstructions ¶
InsertInstructions inserts instructions starting from the pos-th child of node, moving other children as necessary. The instructions should be valid Dockerfile instructions. InsertInstructions mutates node in-place, and the final state of node is equivalent to what parser.Parse would return if the original Dockerfile represented by node contained the instructions at the specified position pos. If the returned error is non-nil, node is guaranteed to be unchanged.
func Label ¶
Label builds a LABEL Dockerfile instruction from the mapping m. Keys and values are serialized as JSON strings to ensure compatibility with the Dockerfile parser.
func LastBaseImage ¶
LastBaseImage takes a Dockerfile root node and returns the base image declared in the last FROM instruction.
func LastExposedPorts ¶
LastExposedPorts takes a Dockerfile root node and returns a list of ports exposed in the last image built by the Dockerfile, i.e., only the EXPOSE instructions after the last FROM instruction are considered.
It also evaluates the following scenarios 1) env variable - evaluate from ENV and ARG with default value 2) port range - adding the lowest port from range
Types ¶
type ShellLex ¶
type ShellLex struct {
// contains filtered or unexported fields
}
ShellLex performs shell word splitting and variable expansion.
ShellLex takes a string and an array of env variables and process all quotes (" and ') as well as $xxx and ${xxx} env variable tokens. Tries to mimic bash shell process. It doesn't support all flavors of ${xx:...} formats but new ones can be added by adding code to the "special ${} format processing" section
func NewShellLex ¶
NewShellLex creates a new ShellLex which uses escapeToken to escape quotes.
func (*ShellLex) ProcessWord ¶
ProcessWord will use the 'env' list of environment variables, and replace any env var references in 'word'.
func (*ShellLex) ProcessWords ¶
ProcessWords will use the 'env' list of environment variables, and replace any env var references in 'word' then it will also return a slice of strings which represents the 'word' split up based on spaces - taking into account quotes. Note that this splitting is done **after** the env var substitutions are done. Note, each one is trimmed to remove leading and trailing spaces (unless they are quoted", but ProcessWord retains spaces between words.