generate

Documentation

Index

• Constants
• func Config(t machine.Type, in *Input) (c *v1alpha1.Config, err error)
• func NewAdminCertificateAndKey(crt, key []byte, loopback string) (p *x509.PEMEncodedCertificateAndKey, err error)
• func NewEtcdCA() (ca *x509.CertificateAuthority, err error)
• func NewKubernetesCA() (ca *x509.CertificateAuthority, err error)
• func NewTalosCA() (ca *x509.CertificateAuthority, err error)
• func Talosconfig(in *Input, opts ...GenOption) (*config.Config, error)
• type Certs
• type GenOption
  • func WithAdditionalSubjectAltNames(sans []string) GenOption
  • func WithDNSDomain(dnsDomain string) GenOption
  • func WithDebug(enable bool) GenOption
  • func WithEndpointList(endpoints []string) GenOption
  • func WithInstallDisk(disk string) GenOption
  • func WithInstallImage(imageRef string) GenOption
  • func WithNetworkConfig(network *v1alpha1.NetworkConfig) GenOption
  • func WithRegistryMirror(host string, endpoints ...string) GenOption
• type GenOptions
  • func DefaultGenOptions() GenOptions
• type Input
  • func NewInput(clustername string, endpoint string, kubernetesVersion string, ...) (input *Input, err error)
  • func (i *Input) GetAPIServerEndpoint(port string) string
  • func (i *Input) GetAPIServerSANs() []string
  • func (i *Input) GetControlPlaneEndpoint() string
• type Secrets
• type TrustdInfo

Constants

const DefaultIPv4PodNet = "10.244.0.0/16"

DefaultIPv4PodNet is the network to be used for kubernetes Pods when using IPv4-based master nodes

const DefaultIPv4ServiceNet = "10.96.0.0/12"

DefaultIPv4ServiceNet is the network to be used for kubernetes Services when using IPv4-based master nodes

const DefaultIPv6PodNet = "fc00:db8:10::/56"

DefaultIPv6PodNet is the network to be used for kubernetes Pods when using IPv6-based master nodes

const DefaultIPv6ServiceNet = "fc00:db8:20::/112"

DefaultIPv6ServiceNet is the network to be used for kubernetes Services when using IPv6-based master nodes

Functions

func Config

func Config(t machine.Type, in *Input) (c *v1alpha1.Config, err error)

Config returns the talos config for a given node type. nolint: gocyclo

func NewAdminCertificateAndKey

func NewAdminCertificateAndKey(crt, key []byte, loopback string) (p *x509.PEMEncodedCertificateAndKey, err error)

NewAdminCertificateAndKey generates the admin Talos certifiate and key.

func NewEtcdCA

func NewEtcdCA() (ca *x509.CertificateAuthority, err error)

NewEtcdCA generates a CA for the Etcd PKI.

func NewKubernetesCA

func NewKubernetesCA() (ca *x509.CertificateAuthority, err error)

NewKubernetesCA generates a CA for the Kubernetes PKI.

func NewTalosCA

func NewTalosCA() (ca *x509.CertificateAuthority, err error)

NewTalosCA generates a CA for the Talos PKI.

func Talosconfig

func Talosconfig(in *Input, opts ...GenOption) (*config.Config, error)

Talosconfig returns the talos admin Talos config.

Types

type Certs

type Certs struct {
	Admin *x509.PEMEncodedCertificateAndKey
	Etcd  *x509.PEMEncodedCertificateAndKey
	K8s   *x509.PEMEncodedCertificateAndKey
	OS    *x509.PEMEncodedCertificateAndKey
}

Certs holds the base64 encoded keys and certificates.

type GenOption

type GenOption func(o *GenOptions) error

GenOption controls generate options specific to input generation.

func WithAdditionalSubjectAltNames

func WithAdditionalSubjectAltNames(sans []string) GenOption

WithAdditionalSubjectAltNames specifies additional SANs.

func WithDNSDomain

func WithDNSDomain(dnsDomain string) GenOption

WithDNSDomain specifies domain name to use in Talos cluster.

func WithDebug

func WithDebug(enable bool) GenOption

WithDebug enables verbose logging to console for all services.

func WithEndpointList

func WithEndpointList(endpoints []string) GenOption

WithEndpointList specifies endpoints to use when acessing Talos cluster.

func WithInstallDisk

func WithInstallDisk(disk string) GenOption

WithInstallDisk specifies install disk to use in Talos cluster.

func WithInstallImage

func WithInstallImage(imageRef string) GenOption

WithInstallImage specifies install container image to use in Talos cluster.

func WithNetworkConfig

func WithNetworkConfig(network *v1alpha1.NetworkConfig) GenOption

WithNetworkConfig allows to pass network config to be used.

func WithRegistryMirror

func WithRegistryMirror(host string, endpoints ...string) GenOption

WithRegistryMirror configures registry mirror endpoint(s).

type GenOptions

type GenOptions struct {
	EndpointList              []string
	InstallDisk               string
	InstallImage              string
	AdditionalSubjectAltNames []string
	NetworkConfig             *v1alpha1.NetworkConfig
	RegistryMirrors           map[string]machine.RegistryMirrorConfig
	DNSDomain                 string
	Debug                     bool
}

GenOptions describes generate parameters.

func DefaultGenOptions

func DefaultGenOptions() GenOptions

DefaultGenOptions returns default options.

type Input

type Input struct {
	Certs *Certs

	// ControlplaneEndpoint is the canonical address of the kubernetes control
	// plane.  It can be a DNS name, the IP address of a load balancer, or
	// (default) the IP address of the first master node.  It is NOT
	// multi-valued.  It may optionally specify the port.
	ControlPlaneEndpoint string

	AdditionalSubjectAltNames []string
	AdditionalMachineCertSANs []string

	ClusterName       string
	ServiceDomain     string
	PodNet            []string
	ServiceNet        []string
	KubernetesVersion string
	Secrets           *Secrets
	TrustdInfo        *TrustdInfo

	ExternalEtcd bool

	InstallDisk  string
	InstallImage string

	NetworkConfig *v1alpha1.NetworkConfig

	RegistryMirrors map[string]machine.RegistryMirrorConfig

	Debug bool
}

Input holds info about certs, ips, and node type.

nolint: maligned

func NewInput

func NewInput(clustername string, endpoint string, kubernetesVersion string, opts ...GenOption) (input *Input, err error)

NewInput generates the sensitive data required to generate all config types. nolint: dupl,gocyclo

func (*Input) GetAPIServerEndpoint

func (i *Input) GetAPIServerEndpoint(port string) string

GetAPIServerEndpoint returns the formatted host:port of the API server endpoint

func (*Input) GetAPIServerSANs

func (i *Input) GetAPIServerSANs() []string

GetAPIServerSANs returns the formatted list of Subject Alt Name addresses for the API Server

func (*Input) GetControlPlaneEndpoint

func (i *Input) GetControlPlaneEndpoint() string

GetControlPlaneEndpoint returns the formatted host:port of the canonical controlplane address, defaulting to the first master IP

type Secrets

type Secrets struct {
	BootstrapToken         string
	AESCBCEncryptionSecret string
}

Secrets holds the senesitve kubeadm data.

type TrustdInfo

type TrustdInfo struct {
	Token string
}

TrustdInfo holds the trustd credentials.