yochu

README

Yochu

yochu provisions already running CoreOS hosts with Docker, etcd, fleet,rkt, kubectl and iptables.

Host operating systems are provisioned with giantswarm/mayu on bare metal clusters.

Getting Yochu

Download the latest release: https://github.com/giantswarm/yochu/releases/latest

Clone the git repository: https://github.com/giantswarm/yochu.git

Running Yochu

Place the following unit file in your cloud-config, replacing your subnet and docker subnets:

[Unit]
Description=Giant Swarm Yochu
Wants=network-online.target
After=network-online.target
Before=multi-user.target
[Service]
Type=oneshot
ExecStartPre=/usr/bin/mkdir -p /home/core/bin
ExecStartPre=/usr/bin/wget --no-verbose https://downloads.giantswarm.io/yochu/0.20.0/yochu -O /home/core/bin/yochu
ExecStartPre=/usr/bin/chmod +x /home/core/bin/yochu
ExecStart=/home/core/bin/yochu setup -v -d --start-daemons=true --subnet=<your subnet> --docker-subnet=<your docker subnet> --http-endpoint=https://downloads.giantswarm.io --fleet-version=v0.11.5-gs-grpc-1 --etcd-version=v2.1.0-gs-1
RemainAfterExit=yes
[Install]
WantedBy=multi-user.target

Further Steps

Check more detailed documentation: docs

Check code documentation: godoc

Our custom binaries can be found at:

• etcd: https://downloads.giantswarm.io/etcd/v2.1.0-gs-1/etcd
• etcdctl: https://downloads.giantswarm.io/etcd/v2.1.0-gs-1/etcdctl
• fleet: https://downloads.giantswarm.io/fleet/v0.11.5-gs-grpc-1/fleetd
• fleetctl: https://downloads.giantswarm.io/fleet/v0.11.5-gs-grpc-1/fleetctl
• rkt: https://downloads.giantswarm.io/rkt/v1.1.0/rkt
• kubectl: https://downloads.giantswarm.io/k8s/v1.1.8/kubectl

Contact

• Mailing list: giantswarm
• IRC: #giantswarm on freenode.org
• Bugs: issues

Contributing & Reporting Bugs

See CONTRIBUTING for details on submitting patches, the contribution workflow as well as reporting bugs.

License

Yochu is under the Apache 2.0 license. See the LICENSE file for details.

Origin of the Name

yochu (ようちゅう[幼虫] pronounced "yo-choo") is Japanese for larva or chrysalis.