A custom Kubernetes controller that provides seamless integration with the UpCloud API, allowing you to manage UpCloud Virtual Machines directly through kubectl.
- View and monitor UpCloud VMs using standard Kubernetes tooling
- Prometheus metrics integration for monitoring sync status
- Configurable sync interval
- Detailed logging with multiple verbosity levels
git submodule update --recursivemake install runSyncing interval can be configured by --sync-interval parameter when the controller is started. By default, VMs are being synced every 15 seconds.
Number of currently syncing UpCloud VMs are available via Prometheus interface (metric name: virtual_machine_syncing_vms).
- Unit testing
- Kubernetes events
- Enable metrics protection
V=1- we want always see itV=2- a bit more verbosityV=3- we are debugging the controller, loads of big structures shall we logged
The logging itself is controller by -zap-log-level argument, e.g. -zap-log-level=3 gives you plenty of information on state changes.
UpCloud API credentials are set in os.Environ
- Creating Machine API Key isn't straight-forward
- Creating a sub-user
- Create subaccount
- is grayed out without any explanation unless free trial is started (shall indicate what's wrong)
- Create subaccount
- Having
UpCloudLtdas a github org name makes a path like this/go/pkg/mod/github.com/!up!cloud!ltd. Those!make life a bit worse. Try to cd to this directory. And do it again.
- https://sdk.operatorframework.io/docs/building-operators/golang/quickstart/
- https://github.com/UpCloudLtd/upcloud-go-api
- https://developers.upcloud.com/1.3/
- https://upcloud.com/resources/tutorials/getting-started-upcloud-api
- https://upcloud.com/docs/getting-started/free-trial/
- https://github.com/kubernetes/community/blob/master/contributors/devel/sig-instrumentation/logging.md#what-method-to-use
- https://book.kubebuilder.io/
- https://go.dev/doc/modules/gomod-ref
Licensed under the Mozilla Public License 2.0 (MPL-2.0). See LICENCE for details and legal TL;DR.