ansible

Documentation

Index

• Constants
• Variables
• func ContainerEngineOptions() []string
• func ContainerEnginePreflight(containerEngine string) error
• func CreateInventoryFile(dir string, inventoryContents string) error
• func CreateNavigatorRunLogFile(dir string, outputContents string) error
• func CreateNavigatorSettingsFile(dir string, settingsContents string) error
• func CreatePlaybookFile(dir string, playbookContents string) error
• func CreateRunDir(dir string) error
• func CreateRunSSHPrivateKeysDir(dir string) error
• func CreateSSHPrivateKeys(dir string, keys []SSHPrivateKey, settings *NavigatorSettings, ...) error
• func DirectoryPreflight(dir string) error
• func ExecNavigatorRunCommand(command *exec.Cmd) (string, error)
• func GenerateNavigatorRunCommand(ctx context.Context, workingDirectory string, ansibleNavigatorBinary string, ...) *exec.Cmd
• func GenerateNavigatorSettings(settings *NavigatorSettings) (string, error)
• func NavigatorPath() (string, error)
• func NavigatorPreflight(binary string) error
• func PullPolicyOptions() []string
• func QueryPlaybookArtifact(dir string, queries map[string]ArtifactQuery) error
• func RemoveRunDir(dir string) error
• type ArtifactQuery
• type NavigatorSettings
• type RunOptions
• type SSHPrivateKey

Constants

const NavigatorProgram = "ansible-navigator"

Variables

var (
	ErrDirectory           = errors.New("directory is not valid")
	ErrContainerEnginePath = errors.New("container engine (podman or docker) must exist in PATH")
	ErrContainerEngine     = errors.New("container engine is not running or usable")
	ErrNavigatorPath       = fmt.Errorf("%s does not exist in PATH", NavigatorProgram)
	ErrNavigator           = fmt.Errorf("%s is not functional", NavigatorProgram)
)

Functions

func ContainerEngineOptions

func ContainerEngineOptions() []string

func ContainerEnginePreflight

func ContainerEnginePreflight(containerEngine string) error

func CreateInventoryFile

func CreateInventoryFile(dir string, inventoryContents string) error

func CreateNavigatorRunLogFile

func CreateNavigatorRunLogFile(dir string, outputContents string) error

func CreateNavigatorSettingsFile

func CreateNavigatorSettingsFile(dir string, settingsContents string) error

func CreatePlaybookFile

func CreatePlaybookFile(dir string, playbookContents string) error

func CreateRunDir

func CreateRunDir(dir string) error

func CreateRunSSHPrivateKeysDir

func CreateRunSSHPrivateKeysDir(dir string) error

func CreateSSHPrivateKeys

func CreateSSHPrivateKeys(dir string, keys []SSHPrivateKey, settings *NavigatorSettings, opts *RunOptions) error

func DirectoryPreflight

func DirectoryPreflight(dir string) error

func ExecNavigatorRunCommand

func ExecNavigatorRunCommand(command *exec.Cmd) (string, error)

func GenerateNavigatorRunCommand

func GenerateNavigatorRunCommand(ctx context.Context, workingDirectory string, ansibleNavigatorBinary string, runDir string, opts *RunOptions) *exec.Cmd

func GenerateNavigatorSettings

func GenerateNavigatorSettings(settings *NavigatorSettings) (string, error)

func NavigatorPath

func NavigatorPath() (string, error)

func NavigatorPreflight

func NavigatorPreflight(binary string) error

TODO include output in error TODO require a min version

func PullPolicyOptions

func PullPolicyOptions() []string

func QueryPlaybookArtifact

func QueryPlaybookArtifact(dir string, queries map[string]ArtifactQuery) error

func RemoveRunDir

func RemoveRunDir(dir string) error

Types

type ArtifactQuery

type ArtifactQuery struct {
	JSONPath string
	Result   string
}

type NavigatorSettings

type NavigatorSettings struct {
	ContainerEngine          string
	EnvironmentVariablesPass []string
	EnvironmentVariablesSet  map[string]string
	Image                    string
	PullArguments            []string
	PullPolicy               string
	VolumeMounts             map[string]string
}

type RunOptions

type RunOptions struct {
	ForceHandlers bool
	Limit         []string
	Tags          []string
	PrivateKey    []string
}

type SSHPrivateKey

type SSHPrivateKey struct {
	Name string
	Data string
}