Documentation ¶
Index ¶
- Constants
- func BuildHardwareYAML(path string, opts *BMCOptions) ([]byte, error)
- func CreateOrStdout(path string) (*os.File, error)
- func LabelsMatchSelector(selector v1alpha1.HardwareSelector, labels Labels) bool
- func MarshalCatalogue(c *Catalogue) ([]byte, error)
- func ParseYAMLCatalogue(catalogue *Catalogue, r io.Reader) error
- func ParseYAMLCatalogueFromFile(catalogue *Catalogue, filename string) error
- func RegisterDefaultAssertions(validator *DefaultMachineValidator)
- func RegisterDefaultNormalizations(n *Normalizer)
- func Translate(reader MachineReader, writer MachineWriter, validator MachineValidator) error
- func TranslateAll(reader MachineReader, writer MachineWriter, validator MachineValidator) error
- type BMCCatalogueWriter
- type BMCOptions
- type CSVReader
- type Catalogue
- func (c *Catalogue) AllBMCs() []*v1alpha1.Machine
- func (c *Catalogue) AllHardware() []*tinkv1alpha1.Hardware
- func (c *Catalogue) AllSecrets() []*corev1.Secret
- func (c *Catalogue) IndexBMCs(index string, fn KeyExtractorFunc)
- func (c *Catalogue) IndexHardware(index string, fn KeyExtractorFunc)
- func (c *Catalogue) IndexSecret(index string, fn KeyExtractorFunc)
- func (c *Catalogue) InsertBMC(bmc *v1alpha1.Machine) error
- func (c *Catalogue) InsertHardware(hardware *tinkv1alpha1.Hardware) error
- func (c *Catalogue) InsertSecret(secret *corev1.Secret) error
- func (c *Catalogue) LookupBMC(index, key string) ([]*v1alpha1.Machine, error)
- func (c *Catalogue) LookupHardware(index, key string) ([]*tinkv1alpha1.Hardware, error)
- func (c *Catalogue) LookupSecret(index, key string) ([]*corev1.Secret, error)
- func (c *Catalogue) RemoveHardwares(hardware []tinkv1alpha1.Hardware) error
- func (c *Catalogue) TotalBMCs() int
- func (c *Catalogue) TotalHardware() int
- func (c *Catalogue) TotalSecrets() int
- type CatalogueOption
- type DefaultMachineValidator
- type ErrDiskNotFound
- type ErrIncorrectType
- type ErrUnknownIndex
- type ExperimentalOpts
- type FieldIndexer
- type HMACOpts
- type HardwareCatalogueWriter
- type Indexer
- type KeyExtractorFunc
- type KubeReader
- type Labels
- type Machine
- type MachineAssertion
- type MachineReader
- type MachineValidator
- type MachineWriter
- type Nameservers
- type Normalizer
- type NormalizerFunc
- type RPCOpts
- type RequestOpts
- type SecretCatalogueWriter
- type SignatureOpts
- type TinkerbellManifestYAML
Constants ¶
const BMCNameIndex = ".ObjectMeta.Name"
const HardwareBMCRefIndex = ".Spec.BmcRef"
const HardwareIDIndex = ".Spec.Metadata.Instance.ID"
const LabelsSeparator = "|"
LabelSSeparator is used to separate key value label pairs.
const NameserversSeparator = "|"
NameserversSeparator is used to unmarshal Nameservers.
const OwnerNameLabel string = "v1alpha1.tinkerbell.org/ownerName"
OwnerNameLabel is the label set by CAPT to mark a hardware as part of a cluster.
const SecretNameIndex = ".ObjectMeta.Name"
Variables ¶
This section is empty.
Functions ¶
func BuildHardwareYAML ¶ added in v0.15.0
func BuildHardwareYAML(path string, opts *BMCOptions) ([]byte, error)
BuildHardwareYAML builds a hardware yaml from the csv at the provided path.
func CreateOrStdout ¶ added in v0.9.2
CreateOrStdout will create path and return an *os.File if path is not empty. If path is empty os.Stdout is returned.
func LabelsMatchSelector ¶ added in v0.9.2
func LabelsMatchSelector(selector v1alpha1.HardwareSelector, labels Labels) bool
LabelsMatchSelector ensures all selector key-value pairs can be found in labels. If selector is empty true is always returned.
func MarshalCatalogue ¶ added in v0.9.2
MarshalCatalogue marshals c into YAML that can be submitted to a Kubernetes cluster.
func ParseYAMLCatalogue ¶ added in v0.9.0
ParseYAMLCatalogue parses a YAML document, r, that represents a set of Kubernetes manifests. Manifests parsed include CAPT Hardware, PBnJ BMCs and associated Core API Secret.
func ParseYAMLCatalogueFromFile ¶ added in v0.9.0
ParseYAMLCatalogueFromFile parses filename, a YAML document, using ParseYamlCatalogue.
func RegisterDefaultAssertions ¶ added in v0.9.1
func RegisterDefaultAssertions(validator *DefaultMachineValidator)
RegisterDefaultAssertions applies a set of default assertions to validator. The default assertions include UniqueHostnames and UniqueIDs.
func RegisterDefaultNormalizations ¶ added in v0.9.2
func RegisterDefaultNormalizations(n *Normalizer)
RegisterDefaultNormalizations registers a set of default normalizations on n.
func Translate ¶
func Translate(reader MachineReader, writer MachineWriter, validator MachineValidator) error
Translate reads 1 entry from reader and writes it to writer. When reader returns io.EOF Translate returns io.EOF to the caller.
func TranslateAll ¶
func TranslateAll(reader MachineReader, writer MachineWriter, validator MachineValidator) error
TranslateAll reads entries 1 at a time from reader and writes them to writer. When reader returns io.EOF, TranslateAll returns nil. Failure to return io.EOF from reader will result in an infinite loop.
Types ¶
type BMCCatalogueWriter ¶ added in v0.9.2
type BMCCatalogueWriter struct {
// contains filtered or unexported fields
}
BMCCatalogueWriter converts Machine instances to Tinkerbell Machine and inserts them in a catalogue.
func NewBMCCatalogueWriter ¶ added in v0.9.2
func NewBMCCatalogueWriter(catalogue *Catalogue) *BMCCatalogueWriter
NewBMCCatalogueWriter creates a new BMCCatalogueWriter instance.
func (*BMCCatalogueWriter) Write ¶ added in v0.9.2
func (w *BMCCatalogueWriter) Write(m Machine) error
Write converts m to a Tinkerbell Machine and inserts it into w's Catalogue.
type BMCOptions ¶ added in v0.18.0
type BMCOptions struct { // RPC are the options for the Rufio RPC provider. RPC *RPCOpts `csv:"-"` }
BMCOptions are the options used to configure the Rufio providers. Right now we only support the RPC provider.
type CSVReader ¶ added in v0.9.1
type CSVReader struct { // BMCOptions used in a Machine that do not have a corresponding column in the CSV. BMCOptions *BMCOptions // contains filtered or unexported fields }
CSVReader reads a CSV file and provides Machine instances. It satisfies the MachineReader interface. The ID field of the Machine is optional in the CSV. If unspecified, CSVReader will generate a UUID and apply it to the machine.
func NewCSVReader ¶ added in v0.9.1
func NewCSVReader(r io.Reader, opts *BMCOptions) (CSVReader, error)
NewCSVReader returns a new CSVReader instance that consumes csv data from r. r should return io.EOF when no more records are available.
type Catalogue ¶ added in v0.9.0
type Catalogue struct {
// contains filtered or unexported fields
}
Catalogue represents a catalogue of Tinkerbell hardware manifests to be used with Tinkerbells Kubefied back-end.
func NewCatalogue ¶ added in v0.9.0
func NewCatalogue(opts ...CatalogueOption) *Catalogue
NewCatalogue creates a new Catalogue instance.
func (*Catalogue) AllBMCs ¶ added in v0.9.0
AllBMCs retrieves a copy of the catalogued BMC instances.
func (*Catalogue) AllHardware ¶ added in v0.9.0
func (c *Catalogue) AllHardware() []*tinkv1alpha1.Hardware
AllHardware retrieves a copy of the catalogued Hardware instances.
func (*Catalogue) AllSecrets ¶ added in v0.9.0
AllSecrets retrieves a copy of the catalogued Secret instances.
func (*Catalogue) IndexBMCs ¶ added in v0.9.0
func (c *Catalogue) IndexBMCs(index string, fn KeyExtractorFunc)
IndexBMCs indexes BMC instances on index by extracfting the key using fn.
func (*Catalogue) IndexHardware ¶ added in v0.9.0
func (c *Catalogue) IndexHardware(index string, fn KeyExtractorFunc)
IndexHardware indexes Hardware instances on index by extracfting the key using fn.
func (*Catalogue) IndexSecret ¶ added in v0.9.0
func (c *Catalogue) IndexSecret(index string, fn KeyExtractorFunc)
IndexSecret indexes Secret instances on index by extracfting the key using fn.
func (*Catalogue) InsertBMC ¶ added in v0.9.0
InsertBMC inserts BMCs into the catalogue. If any indexes exist, the BMC is indexed.
func (*Catalogue) InsertHardware ¶ added in v0.9.0
func (c *Catalogue) InsertHardware(hardware *tinkv1alpha1.Hardware) error
InsertHardware inserts Hardware into the catalogue. If any indexes exist, the hardware is indexed.
func (*Catalogue) InsertSecret ¶ added in v0.9.0
InsertSecret inserts Secrets into the catalogue. If any indexes exist, the Secret is indexed.
func (*Catalogue) LookupBMC ¶ added in v0.9.0
LookupBMC retrieves BMC instances on index with a key of key. Multiple BMCs _may_ have the same key hence it can return multiple BMCs.
func (*Catalogue) LookupHardware ¶ added in v0.9.0
func (c *Catalogue) LookupHardware(index, key string) ([]*tinkv1alpha1.Hardware, error)
LookupHardware retrieves Hardware instances on index with a key of key. Multiple hardware _may_ have the same key hence it can return multiple Hardware.
func (*Catalogue) LookupSecret ¶ added in v0.9.0
LookupSecret retrieves Secret instances on index with a key of key. Multiple Secrets _may_ have the same key hence it can return multiple Secrets.
func (*Catalogue) RemoveHardwares ¶ added in v0.12.0
func (c *Catalogue) RemoveHardwares(hardware []tinkv1alpha1.Hardware) error
RemoveHardwares removes a slice of hardwares from the catalogue.
func (*Catalogue) TotalBMCs ¶ added in v0.9.0
TotalBMCs returns the total BMCs registered in the catalogue.
func (*Catalogue) TotalHardware ¶ added in v0.9.0
TotalHardware returns the total hardware registered in the catalogue.
func (*Catalogue) TotalSecrets ¶ added in v0.9.0
TotalSecrets returns the total Secrets registered in the catalogue.
type CatalogueOption ¶ added in v0.9.0
type CatalogueOption func(*Catalogue)
CatalogueOption defines an option to be applied in Catalogue instantiation.
func WithBMCNameIndex ¶ added in v0.9.0
func WithBMCNameIndex() CatalogueOption
WithBMCNameIndex creates a BMC index using BMCNameIndex on .ObjectMeta.Name.
func WithHardwareBMCRefIndex ¶ added in v0.9.0
func WithHardwareBMCRefIndex() CatalogueOption
WithHardwareBMCRefIndex creates a Hardware index using HardwareBMCRefIndex on .Spec.BmcRef.
func WithHardwareIDIndex ¶ added in v0.9.0
func WithHardwareIDIndex() CatalogueOption
WithHardwareIDIndex creates a Hardware index using HardwareIDIndex on .Spec.Metadata.Instance.ID values.
func WithSecretNameIndex ¶ added in v0.9.0
func WithSecretNameIndex() CatalogueOption
WithSecretNameIndex creates a Secret index using SecretNameIndex on Secret.ObjectMeta.Name.
type DefaultMachineValidator ¶
type DefaultMachineValidator struct {
// contains filtered or unexported fields
}
DefaultMachineValidator validated Machine instances.
func NewDefaultMachineValidator ¶
func NewDefaultMachineValidator() *DefaultMachineValidator
NewDefaultMachineValidator creates a machineValidator instance with default assertions registered.
func (*DefaultMachineValidator) Register ¶
func (mv *DefaultMachineValidator) Register(v ...MachineAssertion)
Register registers v MachineAssertions with m.
func (*DefaultMachineValidator) Validate ¶
func (mv *DefaultMachineValidator) Validate(machine Machine) error
Validate validates machine by executing its Validate() method and passing it to all registered MachineAssertions.
type ErrDiskNotFound ¶ added in v0.9.2
type ErrDiskNotFound struct { // A unique identifier for the selector, preferrably something useful to an end-user. SelectorID string }
ErrDiskNotFound indicates a disk was not found for a given selector.
func (ErrDiskNotFound) Error ¶ added in v0.9.2
func (e ErrDiskNotFound) Error() string
func (ErrDiskNotFound) Is ¶ added in v0.9.2
func (ErrDiskNotFound) Is(t error) bool
type ErrIncorrectType ¶ added in v0.9.0
ErrIncorrectType indicates an incorrect type was used with a FieldIndexer.
func (ErrIncorrectType) Error ¶ added in v0.9.0
func (e ErrIncorrectType) Error() string
type ErrUnknownIndex ¶ added in v0.9.0
type ErrUnknownIndex struct {
Field string
}
func (ErrUnknownIndex) Error ¶ added in v0.9.0
func (e ErrUnknownIndex) Error() string
type ExperimentalOpts ¶ added in v0.18.0
type ExperimentalOpts struct { // CustomRequestPayload must be in json. CustomRequestPayload string `csv:"-"` // DotPath is the path to the json object where the bmclib RequestPayload{} struct will be embedded. For example: object.data.body DotPath string `csv:"-"` }
ExperimentalOpts are the experimental options used in the Rufio RPC provider.
type FieldIndexer ¶ added in v0.9.0
type FieldIndexer struct {
// contains filtered or unexported fields
}
FieldIndexer indexes collection of objects for a single type against one of its fields. FieldIndexer is not thread safe.
func NewFieldIndexer ¶ added in v0.9.0
func NewFieldIndexer(object interface{}) *FieldIndexer
NewFieldIndexer creates a new FieldIndexer instance. object is the object to be indexed and will be checked during Insert() calls. NewFieldIndexer will panic if object is nil.
func (*FieldIndexer) IndexField ¶ added in v0.9.0
func (i *FieldIndexer) IndexField(field string, fn KeyExtractorFunc)
IndexField registers a new index with i. field is the index name and should represent a path to the field such as `.Spec.ID`. fn is used to extract the lookup key on Insert() from the object to be inserted.
func (*FieldIndexer) Insert ¶ added in v0.9.0
func (i *FieldIndexer) Insert(v interface{}) error
Insert inserts v into i on all indexed fields registered with IndexField. If v is not of the expected type defined by NewFieldIndexer() ErrIncorrectType is returned. Multiple objects with the same index value may be inserted.
func (*FieldIndexer) Lookup ¶ added in v0.9.0
func (i *FieldIndexer) Lookup(field string, key string) ([]interface{}, error)
Lookup uses the index associated with field to find and return all objects associated with key. If field has no associated index created by IndexField ErrUnknownIndex is returned.
func (*FieldIndexer) Remove ¶ added in v0.9.0
func (i *FieldIndexer) Remove(v interface{}) error
Remove removes v from all indexes if present. If v is not present Remove is a no-op. If v is of an incorrect type ErrUnknownType is returned.
type HMACOpts ¶ added in v0.18.0
type HMACOpts struct { // PrefixSigDisabled determines whether the algorithm will be prefixed to the signature. Example: sha256=abc123 PrefixSigDisabled bool `csv:"-"` // Secrets used for signing. Secrets []string `csv:"-"` }
HMACOpts are the options used to create a HMAC signature.
type HardwareCatalogueWriter ¶ added in v0.9.2
type HardwareCatalogueWriter struct {
// contains filtered or unexported fields
}
HardwareCatalogueWriter converts Machine instances to Tinkerbell Hardware and inserts them in a catalogue.
func NewHardwareCatalogueWriter ¶ added in v0.9.2
func NewHardwareCatalogueWriter(catalogue *Catalogue) *HardwareCatalogueWriter
NewHardwareCatalogueWriter creates a new HardwareCatalogueWriter instance.
func (*HardwareCatalogueWriter) Write ¶ added in v0.9.2
func (w *HardwareCatalogueWriter) Write(m Machine) error
Write converts m to a Tinkerbell Hardware and inserts it into w's Catalogue.
type Indexer ¶ added in v0.9.0
type Indexer interface { // Lookup retrieves objects associated with the index => value pair. Lookup(index, value string) ([]interface{}, error) // Insert inserts v int the index. Insert(v interface{}) error // IndexField associated index with fn such that Lookup may be used to retrieve objects. IndexField(index string, fn KeyExtractorFunc) // Remove deletes v from the index. Remove(v interface{}) error }
Indexer provides indexing behavior for objects.
type KeyExtractorFunc ¶ added in v0.9.0
type KeyExtractorFunc func(object interface{}) string
KeyExtractorFunc returns a key from object that can be used to look up the object.
type KubeReader ¶ added in v0.15.0
type KubeReader struct {
// contains filtered or unexported fields
}
KubeReader reads the tinkerbell hardware objects from the cluster. It holds the objects in a catalogue.
func NewKubeReader ¶ added in v0.15.0
func NewKubeReader(client client.Client) *KubeReader
NewKubeReader returns a new instance of KubeReader. Defines a new Catalogue for each KubeReader instance.
func (*KubeReader) GetCatalogue ¶ added in v0.15.0
func (kr *KubeReader) GetCatalogue() *Catalogue
GetCatalogue returns the KubeReader catalogue.
func (*KubeReader) LoadHardware ¶ added in v0.15.0
func (kr *KubeReader) LoadHardware(ctx context.Context) error
LoadHardware fetches the unprovisioned tinkerbell hardware objects and inserts in to KubeReader catalogue.
func (*KubeReader) LoadRufioMachines ¶ added in v0.15.0
func (kr *KubeReader) LoadRufioMachines(ctx context.Context) error
LoadRufioMachines fetches rufio machine objects from the cluster and inserts into KubeReader catalogue.
type Labels ¶ added in v0.9.1
Labels defines a lebsl set. It satisfies https://pkg.go.dev/k8s.io/apimachinery/pkg/labels#Labels.
func (Labels) Get ¶ added in v0.9.1
See https://pkg.go.dev/k8s.io/apimachinery/pkg/labels#Labels
func (*Labels) MarshalCSV ¶ added in v0.9.2
func (*Labels) UnmarshalCSV ¶ added in v0.9.1
type Machine ¶
type Machine struct { Hostname string `csv:"hostname"` IPAddress string `csv:"ip_address"` Netmask string `csv:"netmask"` Gateway string `csv:"gateway"` Nameservers Nameservers `csv:"nameservers"` MACAddress string `csv:"mac"` // Disk used to populate the default workflow actions. // Currently needs to be the same for all hardware residing in the same group where a group // is either: control plane hardware, external etcd hard, or the definable worker node groups. Disk string `csv:"disk"` // Labels to be applied to the Hardware resource. Labels Labels `csv:"labels"` BMCIPAddress string `csv:"bmc_ip, omitempty"` BMCUsername string `csv:"bmc_username, omitempty"` BMCPassword string `csv:"bmc_password, omitempty"` VLANID string `csv:"vlan_id, omitempty"` // BMCOptions are the options used for Rufio providers. BMCOptions *BMCOptions `csv:"-"` }
Machine is a machine configuration with optional BMC interface configuration.
func LowercaseMACAddress ¶ added in v0.9.2
LowercaseMACAddress ensures m's MACAddress field has lower chase characters.
type MachineAssertion ¶
MachineAssertion defines a condition that Machine must meet.
func StaticMachineAssertions ¶ added in v0.9.1
func StaticMachineAssertions() MachineAssertion
StaticMachineAssertions defines all static data assertions performed on a Machine.
func UniqueBMCIPAddress ¶ added in v0.9.1
func UniqueBMCIPAddress() MachineAssertion
UniqueBMCIPAddress asserts a given Machine instance has a unique BMCIPAddress field relative to previously seen Machine instances. If there is no BMC configuration as defined by machine.HasBMC() the check is a noop. It is not thread safe. It has a 1 time use.
func UniqueHostnames ¶
func UniqueHostnames() MachineAssertion
UniqueHostnames asserts a given Machine instance has a unique Hostname field relative to previously seen Machine instances. It is not thread safe. It has a 1 time use.
func UniqueIPAddress ¶ added in v0.9.1
func UniqueIPAddress() MachineAssertion
UniqueIPAddress asserts a given Machine instance has a unique IPAddress field relative to previously seen Machine instances. It is not thread safe. It has a 1 time use.
func UniqueMACAddress ¶ added in v0.9.1
func UniqueMACAddress() MachineAssertion
UniqueMACAddress asserts a given Machine instance has a unique MACAddress field relative to previously seen Machine instances. It is not thread safe. It has a 1 time use.
type MachineReader ¶
MachineReader reads single Machine configuration at a time. When there are no more Machine entries to be read, Read() returns io.EOF.
func NewNormalizedCSVReaderFromFile ¶ added in v0.9.2
func NewNormalizedCSVReaderFromFile(path string, opts *BMCOptions) (MachineReader, error)
NewNormalizedCSVReaderFromFile creates a MachineReader instance backed by a CSVReader reading from path that applies default normalizations to machines.
type MachineValidator ¶
MachineValidator validates an instance of Machine.
type MachineWriter ¶
MachineWriter writes Machine entries.
func MultiMachineWriter ¶
func MultiMachineWriter(writers ...MachineWriter) MachineWriter
MultiMachineWriter combines writers into a single MachineWriter instance. Passing no writers effectively creates a noop MachineWriter.
func NewMachineCatalogueWriter ¶ added in v0.9.2
func NewMachineCatalogueWriter(catalogue *Catalogue) MachineWriter
NewMachineCatalogueWriter creates a MachineWriter instance that writes Machine instances to catalogue including its Machine and Secret data.
type Nameservers ¶
type Nameservers []string
Nameservers is a custom type that can unmarshal a CSV representation of nameservers.
func (*Nameservers) MarshalCSV ¶
func (n *Nameservers) MarshalCSV() (string, error)
MarshalCSV marshalls Nameservers into a string list of nameservers separated by NameserversSeparator.
func (*Nameservers) String ¶
func (n *Nameservers) String() string
func (*Nameservers) UnmarshalCSV ¶
func (n *Nameservers) UnmarshalCSV(s string) error
UnmarshalCSV unmarshalls s where is is a list of nameservers separated by NameserversSeparator.
type Normalizer ¶ added in v0.9.2
type Normalizer struct {
// contains filtered or unexported fields
}
Normalizer is a decorator for a MachineReader that applies a set of normalization funcs to machines.
func NewNormalizer ¶ added in v0.9.2
func NewNormalizer(r MachineReader) *Normalizer
NewNormalizer creates a Normalizer instance that decorates r's Read(). A set of default normalization functions are pre-registered.
func NewRawNormalizer ¶ added in v0.9.2
func NewRawNormalizer(r MachineReader) *Normalizer
NewRawNormalizer returns a Normalizer with default normalizations registered by RegisterDefaultNormalizations.
func (Normalizer) Read ¶ added in v0.9.2
func (n Normalizer) Read() (Machine, error)
Read reads an Machine from the decorated MachineReader, applies all normalization funcs and returns the machine. If the decorated MachineReader errors, it is returned.
func (*Normalizer) Register ¶ added in v0.9.2
func (n *Normalizer) Register(fn NormalizerFunc)
Register fn to n such that fn is run over each machine read from the wrapped MachineReader.
type NormalizerFunc ¶ added in v0.9.2
NormalizerFunc applies a normalization transformation to the Machine.
type RPCOpts ¶ added in v0.18.0
type RPCOpts struct { // ConsumerURL is the URL where an rpc consumer/listener is running // and to which we will send and receive all notifications. ConsumerURL string `csv:"-"` // Request is the options used to create the rpc HTTP request. Request RequestOpts `csv:"-"` // Signature is the options used for adding an HMAC signature to an HTTP request. Signature SignatureOpts `csv:"-"` // HMAC is the options used to create a HMAC signature. HMAC HMACOpts `csv:"-"` // Experimental options. Experimental ExperimentalOpts `csv:"-"` }
RPCOpts are the options used for the Rufio RPC provider.
type RequestOpts ¶ added in v0.18.0
type RequestOpts struct { // HTTPContentType is the content type to use for the rpc request notification. HTTPContentType string `csv:"-"` // HTTPMethod is the HTTP method to use for the rpc request notification. HTTPMethod string `csv:"-"` // StaticHeaders are predefined headers that will be added to every request. StaticHeaders http.Header `csv:"-"` // TimestampFormat is the time format for the timestamp header. TimestampFormat string `csv:"-"` // TimestampHeader is the header name that should contain the timestamp. Example: X-BMCLIB-Timestamp TimestampHeader string `csv:"-"` }
RequestOpts are the options used to create the rpc HTTP request.
type SecretCatalogueWriter ¶ added in v0.9.2
type SecretCatalogueWriter struct {
// contains filtered or unexported fields
}
SecretCatalogueWriter converts Machine instances to Tinkerbell BaseboardManagement and inserts them in a catalogue.
func NewSecretCatalogueWriter ¶ added in v0.9.2
func NewSecretCatalogueWriter(catalogue *Catalogue) *SecretCatalogueWriter
NewSecretCatalogueWriter creates a new SecretCatalogueWriter instance.
func (*SecretCatalogueWriter) Write ¶ added in v0.9.2
func (w *SecretCatalogueWriter) Write(m Machine) error
Write converts m to a Tinkerbell BaseboardManagement and inserts it into w's Catalogue.
type SignatureOpts ¶ added in v0.18.0
type SignatureOpts struct { // HeaderName is the header name that should contain the signature(s). Example: X-BMCLIB-Signature HeaderName string `csv:"-"` // AppendAlgoToHeaderDisabled decides whether to append the algorithm to the signature header or not. // Example: X-BMCLIB-Signature becomes X-BMCLIB-Signature-256 // When set to true, a header will be added for each algorithm. Example: X-BMCLIB-Signature-256 and X-BMCLIB-Signature-512 AppendAlgoToHeaderDisabled bool `csv:"-"` // IncludedPayloadHeaders are headers whose values will be included in the signature payload. Example: X-BMCLIB-My-Custom-Header // All headers will be deduplicated. IncludedPayloadHeaders []string `csv:"-"` }
SignatureOpts are the options used for adding an HMAC signature to an HTTP request.
type TinkerbellManifestYAML ¶ added in v0.9.1
type TinkerbellManifestYAML struct {
// contains filtered or unexported fields
}
TinkerbellManifestYAML is a MachineWriter that writes Tinkerbell manifests to a destination.
func NewTinkerbellManifestYAML ¶ added in v0.9.1
func NewTinkerbellManifestYAML(w io.Writer) *TinkerbellManifestYAML
NewTinkerbellManifestYAML creates a TinkerbellManifestYAML instance that writes its manifests to w.
func (*TinkerbellManifestYAML) Write ¶ added in v0.9.1
func (yw *TinkerbellManifestYAML) Write(m Machine) error
Write m as a set of Kubernetes manifests for use with Cluster API Tinkerbell Provider. This includes writing a Hardware, BMC and Secret (for the BMC).