Documentation
¶
Overview ¶
Package types contains all the types used by UDS.
Package types contains all the types used by UDS.
Package types contains all the types used by UDS.
Index ¶
- type Action
- type BundleChartOverrides
- type BundleChartValue
- type BundleChartValueFile
- type BundleChartVariable
- type BundleCommonOptions
- type BundleConfig
- type BundleCreateOptions
- type BundleDeployOptions
- type BundleInspectOptions
- type BundlePublishOptions
- type BundlePullOptions
- type BundleRemoveOptions
- type BundleVariableExport
- type BundleVariableImport
- type InputParameter
- type Package
- type PathMap
- type Task
- type TaskReference
- type TasksFile
- type UDSBuildData
- type UDSBundle
- type UDSMetadata
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Action ¶
type Action struct {
*zarfTypes.ZarfComponentAction `yaml:",inline"`
TaskReference string `json:"task,omitempty" jsonschema:"description=The task to run, mutually exclusive with cmd and wait"`
With map[string]string `json:"with,omitempty" jsonschema:"description=Input parameters to pass to the task,type=object"`
}
Action is a Zarf action inside a Task
type BundleChartOverrides ¶
type BundleChartOverrides struct {
Values []BundleChartValue `json:"values,omitempty" jsonschema:"description=List of Helm chart values to set statically"`
Variables []BundleChartVariable `json:"variables,omitempty" jsonschema:"description=List of Helm chart variables to set via UDS variables"`
}
BundleChartOverrides represents a Helm chart override to set via UDS variables
type BundleChartValue ¶
type BundleChartValue struct {
Path string `` /* 127-byte string literal not displayed */
Value interface{} `json:"value" jsonschema:"name=The value to set"`
}
BundleChartValue represents a Helm chart value to path mapping to set via UDS variables
type BundleChartValueFile ¶
type BundleChartValueFile struct {
Path string `` /* 135-byte string literal not displayed */
File string `json:"file" jsonschema:"name=The path to the values file to add to the Helm chart"`
}
BundleChartValueFile - EXPERIMENTAL - represents a Helm chart value file to override
type BundleChartVariable ¶
type BundleChartVariable struct {
Path string `` /* 127-byte string literal not displayed */
Name string `json:"name" jsonschema:"name=Name of the variable to set"`
Description string `json:"description,omitempty" jsonschema:"name=Description of the variable"`
Default interface{} `json:"default,omitempty" jsonschema:"name=The default value to set"`
}
BundleChartVariable - EXPERIMENTAL - represents a Helm chart variable and its path
type BundleCommonOptions ¶
type BundleCommonOptions struct {
Confirm bool `json:"confirm" jsonschema:"description=Verify that Zarf should perform an action"`
Insecure bool `json:"insecure" jsonschema:"description=Allow insecure connections for remote packages"`
CachePath string `json:"cachePath" jsonschema:"description=Path to use to cache images and git repos on package create"`
TempDirectory string `` /* 157-byte string literal not displayed */
OCIConcurrency int `jsonschema:"description=Number of concurrent layer operations to perform when interacting with a remote package"`
NoTea bool `json:"useTea" jsonschema:"description=Don't use BubbleTea TUI"`
}
BundleCommonOptions tracks the user-defined preferences used across commands.
type BundleConfig ¶
type BundleConfig struct {
CreateOpts BundleCreateOptions
DeployOpts BundleDeployOptions
PublishOpts BundlePublishOptions
PullOpts BundlePullOptions
InspectOpts BundleInspectOptions
RemoveOpts BundleRemoveOptions
}
BundleConfig is the main struct that the bundler uses to hold high-level options.
type BundleCreateOptions ¶
type BundleCreateOptions struct {
SourceDirectory string
Output string
SigningKeyPath string
SigningKeyPassword string
BundleFile string
}
BundleCreateOptions is the options for the bundler.Create() function
type BundleDeployOptions ¶
type BundleDeployOptions struct {
Resume bool
Source string
Packages []string
PublicKeyPath string
SetVariables map[string]string `` /* 154-byte string literal not displayed */
// Variables and SharedVariables are read in from uds-config.yaml
Variables map[string]map[string]interface{} `yaml:"variables,omitempty"`
ZarfPackageNameMap map[string]string `yaml:"-" json:"-"`
}
BundleDeployOptions is the options for the bundler.Deploy() function
type BundleInspectOptions ¶
type BundleInspectOptions struct {
PublicKeyPath string
Source string
IncludeSBOM bool
ExtractSBOM bool
}
BundleInspectOptions is the options for the bundler.Inspect() function
type BundlePublishOptions ¶
BundlePublishOptions is the options for the bundle.Publish() function
type BundlePullOptions ¶
BundlePullOptions is the options for the bundler.Pull() function
type BundleRemoveOptions ¶
BundleRemoveOptions is the options for the bundler.Remove() function
type BundleVariableExport ¶
type BundleVariableExport struct {
Name string `json:"name" jsonschema:"name=Name of the variable"`
Description string `json:"description,omitempty" jsonschema:"name=Description of the variable"`
}
BundleVariableExport represents variables in the bundle
type BundleVariableImport ¶
type BundleVariableImport struct {
Name string `json:"name" jsonschema:"name=Name of the variable"`
Package string `json:"package" jsonschema:"name=Name of the Zarf package to get the variable from"`
Description string `json:"description,omitempty" jsonschema:"name=Description of the variable"`
}
BundleVariableImport represents variables in the bundle
type InputParameter ¶
type InputParameter struct {
Description string `json:"description" jsonschema:"description=Description of the parameter,required"`
DeprecatedMessage string `json:"deprecatedMessage,omitempty" jsonschema:"description=Message to display when the parameter is deprecated"`
Required bool `json:"required,omitempty" jsonschema:"description=Whether the parameter is required,default=true"`
Default string `json:"default,omitempty" jsonschema:"description=Default value for the parameter"`
}
InputParameter represents a single input parameter for a task, to be used w/ `with`
type Package ¶
type Package struct {
Name string `json:"name" jsonschema:"name=Name of the Zarf package"`
Repository string `json:"repository,omitempty" jsonschema:"description=The repository to import the package from"`
Path string `json:"path,omitempty" jsonschema:"description=The local path to import the package from"`
Ref string `json:"ref" jsonschema:"description=Ref (tag) of the Zarf package"`
OptionalComponents []string `` /* 158-byte string literal not displayed */
PublicKey string `json:"publicKey,omitempty" jsonschema:"description=The public key to use to verify the package"`
Imports []BundleVariableImport `json:"imports,omitempty" jsonschema:"description=List of Zarf variables to import from another Zarf package"`
Exports []BundleVariableExport `json:"exports,omitempty" jsonschema:"description=List of Zarf variables to export from the Zarf package"`
Overrides map[string]map[string]BundleChartOverrides `` /* 129-byte string literal not displayed */
}
Package represents a Zarf package in a UDS bundle
type PathMap ¶
PathMap is a map of either absolute paths to relative paths or relative paths to absolute paths used to map filenames during local bundle tarball creation
type Task ¶
type Task struct {
Name string `json:"name" jsonschema:"description=Name of the task"`
Description string `json:"description,omitempty" jsonschema:"description=Description of the task"`
Files []zarfTypes.ZarfFile `json:"files,omitempty" jsonschema:"description=Files or folders to download or copy"`
Actions []Action `json:"actions,omitempty" jsonschema:"description=Actions to take when running the task"`
Inputs map[string]InputParameter `json:"inputs,omitempty" jsonschema:"description=Input parameters for the task"`
EnvPath string `json:"envPath,omitempty" jsonschema:"description=Path to file containing environment variables"`
}
Task represents a single task
type TaskReference ¶
type TaskReference struct {
Name string `json:"name" jsonschema:"description=Name of the task to run"`
}
TaskReference references the name of a task
type TasksFile ¶
type TasksFile struct {
Includes []map[string]string `json:"includes,omitempty" jsonschema:"description=List of local task files to include"`
Variables []zarfTypes.ZarfPackageVariable `json:"variables,omitempty" jsonschema:"description=Definitions and default values for variables used in run.yaml"`
Tasks []Task `json:"tasks" jsonschema:"description=The list of tasks that can be run"`
}
TasksFile represents the contents of a tasks file
type UDSBuildData ¶
type UDSBuildData struct {
Terminal string `json:"terminal" jsonschema:"description=The machine name that created this package"`
User string `json:"user" jsonschema:"description=The username who created this package"`
Architecture string `json:"architecture" jsonschema:"description=The architecture this package was created on"`
Timestamp string `json:"timestamp" jsonschema:"description=The timestamp when this package was created"`
Version string `json:"version" jsonschema:"description=The version of Zarf used to build this package"`
}
UDSBuildData is written during the bundle.Create() operation to track details of the created package.
type UDSBundle ¶
type UDSBundle struct {
Kind string `json:"kind" jsonschema:"description=The kind of UDS package,enum=UDSBundle"`
Metadata UDSMetadata `json:"metadata" jsonschema:"description=UDSBundle metadata"`
Build UDSBuildData `json:"build,omitempty" jsonschema:"description=Generated bundle build data"`
Packages []Package `json:"packages" jsonschema:"description=List of Zarf packages"`
}
UDSBundle is the top-level structure of a UDS bundle
type UDSMetadata ¶
type UDSMetadata struct {
Name string `json:"name" jsonschema:"description=Name to identify this Zarf package,pattern=^[a-z0-9\\-]+$"`
Description string `json:"description,omitempty" jsonschema:"description=Additional information about this package"`
Version string `json:"version,omitempty" jsonschema:"description=Generic string set by a package author to track the package version"`
URL string `json:"url,omitempty" jsonschema:"description=Link to package information when online"`
Uncompressed bool `json:"uncompressed,omitempty" jsonschema:"description=Disable compression of this package"`
Architecture string `` /* 131-byte string literal not displayed */
Authors string `` /* 209-byte string literal not displayed */
Documentation string `json:"documentation,omitempty" jsonschema:"description=Link to package documentation when online"`
Source string `json:"source,omitempty" jsonschema:"description=Link to package source code when online"`
Vendor string `json:"vendor,omitempty" jsonschema_description:"Name of the distributing entity, organization or individual."`
AggregateChecksum string `` /* 151-byte string literal not displayed */
}
UDSMetadata lists information about the current UDS Bundle.