This project is no longer being maintained. For an alternative, please see https://github.com/rancher/fleet, especially agent self-registration.
If you have interest in maintaining this, or a use case for it, please open an issue.
Server, agent, mooctl functionality is not guaranteed. This was heavily a work-in-progress at time of maintenance cessation.
Moo
Moo is a tool to auto-register Kubernetes (or k3s) clusters with a Rancher instance.
The driving force for this project was not wanting to interact with a k3s node after deployment, but still have it register in Kubernetes.
Usage
Standalone
NAME:
moo - Auto-registration agent for Rancher imported clusters
USAGE:
agent [global options] command [command options] [arguments...]
COMMANDS:
help, h Shows a list of commands or help for one command
GLOBAL OPTIONS:
--kubeconfig value kubeconfig if running outside of cluster (default: "/Users/ebauman/.config/k3d/moo/kubeconfig.yaml") [$KUBECONFIG]
--namespace value namespace used in registration check (default: "cattle-system") [$CATTLE_NAMESPACE]
--deployment value name of deployment used in registration check (default: "cattle-cluster-agent") [$CATTLE_DEPLOYMENT]
--daemonset value name of daemonset used in registration check (default: "cattle-node-agent") [$CATTLE_DAEMONSET]
--rancher-url value url of rancher instance [$RANCHER_URL]
--rancher-access-key value access key for rancher [$RANCHER_ACCESS_KEY]
--rancher-secret-key value secret key for rancher [$RANCHER_SECRET_KEY]
--cluster-name value name of this cluster when registering with rancher [$MOO_CLUSTER_NAME]
--rancher-insecure use an insecure connection to rancher (default: false) [$RANCHER_INSECURE]
--rancher-cacerts value path to cacerts file used when connecting to rancher [$RANCHER_CA_CERTS]
--loglevel value log level (trace, debug, info, warning, error, fatal, panic) (default: "info") [$LOGLEVEL]
--use-existing-cluster if cluster already exists in rancher, use it and import this node (default: false) [$MOO_USE_EXISTING]
--help, -h show help (default: false)
Kubernetes Cluster
Check out kubernetes.yaml for a manifest to deploy moo-agent into your cluster.
If you're using k3s, this manifest can be placed in /var/lib/rancher/k3s/server/manifests which will auto-deploy
the moo-agent Job upon server installation.
Building
cd agent/
go build
Contributing
Please file issues for enhancements, upgrades, bugs, etc.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent