mirror of
https://github.com/siderolabs/talos.git
synced 2025-10-06 13:11:12 +02:00
49307d554d
This is a rewrite of machined. It addresses some of the limitations and
complexity in the implementation. This introduces the idea of a
controller. A controller is responsible for managing the runtime, the
sequencer, and a new state type introduced in this PR.
A few highlights are:
- no more event bus
- functional approach to tasks (no more types defined for each task)
- the task function definition now offers a lot more context, like
access to raw API requests, the current sequence, a logger, the new
state interface, and the runtime interface.
- no more panics to handle reboots
- additional initialize and reboot sequences
- graceful gRPC server shutdown on critical errors
- config is now stored at install time to avoid having to download it at
install time and at boot time
- upgrades now use the local config instead of downloading it
- the upgrade API's preserve option takes precedence over the config's
install force option
Additionally, this pulls various packes in under machined to make the
code easier to navigate.
Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
46 lines
1.4 KiB
Go
46 lines
1.4 KiB
Go
// This Source Code Form is subject to the terms of the Mozilla Public
|
|
// License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
// file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
|
|
// Package cluster provides functions to access, check and inspect Talos clusters.
|
|
package cluster
|
|
|
|
import (
|
|
"context"
|
|
"io"
|
|
|
|
"k8s.io/client-go/kubernetes"
|
|
|
|
"github.com/talos-systems/talos/internal/app/machined/pkg/runtime"
|
|
"github.com/talos-systems/talos/pkg/client"
|
|
)
|
|
|
|
// ClientProvider builds Talos client by endpoint.
|
|
//
|
|
// Client instance should be cached and closed when Close() is called.
|
|
type ClientProvider interface {
|
|
// Client returns Talos client instance for default (if no endpoints are given) or
|
|
// specific endpoint.
|
|
Client(endpoints ...string) (*client.Client, error)
|
|
// Close client connections.
|
|
Close() error
|
|
}
|
|
|
|
// K8sProvider builds Kubernetes client to access Talos cluster.
|
|
type K8sProvider interface {
|
|
K8sClient(ctx context.Context) (*kubernetes.Clientset, error)
|
|
}
|
|
|
|
// CrashDumper captures Talos cluster state to the specified writer for debugging.
|
|
type CrashDumper interface {
|
|
CrashDump(ctx context.Context, out io.Writer)
|
|
}
|
|
|
|
// Info describes the Talos cluster.
|
|
type Info interface {
|
|
// Nodes returns list of all node endpoints (IPs).
|
|
Nodes() []string
|
|
// NodesByType return list of node endpoints by type.
|
|
NodesByType(runtime.MachineType) []string
|
|
}
|