README
¶
Fresnel CLI
The Fresnel CLI runs on a trusted machine that is authorized to build boot media for an operating system installer. It's primary purpose is to prepare storage media (USB or Removable Disk) that will install an operating system.
Subcommands
Subcommands are required in order to operate the CLI. A list of available subcommands is available by using the help subcommand.
cli.exe help
A list of command line flags is available for each sub-command by calling help with that subcommand as the parameter.
cli.exe help write
Available Subcommands
Commonly used sub-commands are listed here. A full list is available through the help subcommand.
List
The list sub-command outputs the storage devices that are suitable for provisioning your operating system installer. See parameters for a list of the defaults used when determining what a suitable device is.
Usage
cli.exe list
Common Flags
--show_fixed [bool]
Default = [False]
Includes fixed disks when searching for suitable devices.
Example
cli.exe list --show_fixed
--minimum
[int] Default = 2 GB
The minimum size (in Gigabytes) of storage to search for.
Example
cli.exe list --minimum=8
--maximum
[int] Default = 0 (no maximum)
The maximum size (in Gigabytes) of storage to search for.
Example
cli.exe list --maximum=64
Write
The write subcommand writes an operating system installer to storage media. The list of available operating system installers is configured by modifying the config package and its deafults.go file.
Usage Examples
cli.exe write -distro=windows -track=stable 1
cli write -distro=linux -track=stable sda
Common Flags
--distro [string]
Default = [None]
The distribution you wish to provision onto the selected media. The options for this value are configured by adding an entry in the map for distributions in defaults.go. A distribution is generally defined as the operating system you wish to install (e.g. windows or linux). It can represent any collection of related images that you wish to make avaialble.
--track [string]
Default = [None]
The track indicates the specific installer within a distribution to provision onto the selected media. For example, you may have a stable, testing and unstable versions of Windows that you wish to make available.
Examples
cli.exe write --distro=windows -track=stable 1
cli write --distro=linux -track=unstable sda
Important Behaviors
Specific behaviors are automatically triggered by configuring fields for your distribution within config.go. For example, seeds are automatically retrieved when the write command is running if a seedServer and seedFile is added to the distribution configuration. For more information on these, see the documentation for config.
Documentation
¶
Overview ¶
main is the entry point for the image writer. It implements image writing functionality for installers to compatible devices through subcommands.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
commands
|
|
|
list
Package list defines the list subcommand to display the devices available that qualify for provisioning with an installer.
|
Package list defines the list subcommand to display the devices available that qualify for provisioning with an installer. |
|
write
Package write implements the write subcommand for provisioning an installer.
|
Package write implements the write subcommand for provisioning an installer. |
|
Package config parses flags and returns a configuration for imaging a usb
|
Package config parses flags and returns a configuration for imaging a usb |
|
Package console provides simple utilities to print human-readable messages to the console.
|
Package console provides simple utilities to print human-readable messages to the console. |
|
Package installer provides a uniform, cross-platform implementation for handling OS installer provisioning for supported target platforms.
|
Package installer provides a uniform, cross-platform implementation for handling OS installer provisioning for supported target platforms. |