The purpose of the simple
coreos_cluster_vmware repo is to provide simple scripts for building a CoreOS cluster using the methodology that Kelsey Hightower gave me insight into using the official VMware CoreOS image.
There is an excellent blog post on CoreOS's blog by Kelsey Hightower about CoreOS on VMware Vspher and VMware vCloud Air that was the inspiration for this post. I simply wanted to automate the process and have a means of showing a working cluster, hence this blog post.
What does this cluster consist of?
Four machines total:
- standalone etcd node. Keep it Simple for development and feel free to create a full cluster in production.
- 3 coreOS nodes that are using the single etcd node
What is in this repo?
In the base directory, there are "templates" for:
vm_tmpl.vmx- The VMX file used by all VMs
etcd_cloud_init_tmpl.yaml- A cloud init file for the etcd VM
node_cloud_init_tmpl.yaml- A cloud init file for the CoreOS VM nodes
get_image.sh- Simple script to fetch the official VMware CoreOS image and un-compress it (bzip)
build_etcd.sh- The script used to build configuration files for and to launch the etcd VM
build_nodes.sh- The script that is used to build configuration files for and to launch all three of the CoreOS node VMs
teardown_nodes.sh- Stops and deletes the files for CoreOS node VMs
teardown_etcd.sh- Stops and deletes the files for the etcd VM
The basic idea is this - - Obtain the official VMware CoreOS image - Produce both a cloud init file and VMX file for a given VM - Create a config drive, using the cloud init file (.iso) - Make a copy of the official VMware CoreOS image for that machine named accordingly - Boot the VM using the generated files
For the etcd VM, this only happens once and requires not cognizance of any other machines. For each CoreOS node VM, they boot the same way but also need to know the IP address of the etcd VM.
Upon launching all CoreOS node VMs, everything should be up and running!
There is a directory in the repo with nothing in it
work_dir. Enter that directory. This is where all the generated files and VMware images will exist.
Determine location of VMware CLI
You will need to find the utility
vmrun. On OSX Yosemite, this location should be
/Applications/VMware Fusion.app/Contents/Library. Set up the $PATH environment variable to have this in your path:
export PATH=$PATH:/Applications/VMware\ Fusion.app/Contents/Library
Get the official VMware CoreOS image
After this script is completed, there should be the image in the expected location
reason:work_dir patg$ ls -l ../coreos_image/*.vmdk total 1036072 -rw-r--r-- 1 patg staff 396820480 Mar 12 12:59 coreos_production_vmware_image.vmdk
Lanch the etcd VM
reason:work_dir patg$ ../bin/build_etcd.sh
Creating hybrid image...
This will lanch the etcd VM.
You can then find out what the IP address of the Virtual Machine is by running the following command:
reason:work_dir patg$ sudo vmrun getGuestIPAddress etcd.vmx 172.16.230.132
Log into the instance. The password that was set from the cloud init data file
etcd_clout_init.yaml results in the VM having a password for both the core and root user of "vmware" (NOTE: this is not for production, obviously!)
reason:work_dir patg$ ssh firstname.lastname@example.org Warning: Permanently added '172.16.230.132' (RSA) to the list of known hosts. email@example.com's password: CoreOS alpha (618.0.0)
Now, verify that etcd is running:
core@etcd ~ $ etcdctl ls --recursive /coreos.com /coreos.com/updateengine /coreos.com/updateengine/rebootlock /coreos.com/updateengine/rebootlock/semaphore
Launch the cluster
Now the cluster can be launched. As the above example shows, the IP address for etcd is 172.16.230.132. This will be the single argument to the next script:
reason:work_dir patg$ ../bin/build_nodes.sh 172.16.230.132
This will result in the same sequence of steps as the etcd server, but 3 times. Once all VMs are launched, you can verify that they are up:
reason:work_dir patg$ sudo vmrun list Total running VMs: 5 /Users/patg/code/coreos-vmware-cluster/work_dir/core_03.vmx /Users/patg/code/coreos-vmware-cluster/work_dir/core_01.vmx /Users/patg/code/coreos-vmware-cluster/work_dir/etcd.vmx /Users/patg/code/coreos-vmware-cluster/work_dir/core_02.vmx
Next, pick one of the nodes to log into:
reason:work_dir patg$ ssh firstname.lastname@example.org Warning: Permanently added '172.16.230.135' (RSA) to the list of known hosts. email@example.com's password: CoreOS alpha (618.0.0)
Test that everything is working by running
fleetctl. The endpoint to the etcd server at 172.16.230.132, running on port 4001 will need to be specified:
core@core_03 ~ $ fleetctl --endpoint=http://172.16.230.132:4001 list-machines MACHINE IP METADATA 11cf48ee... 172.16.230.134 role=node 6b196b24... 172.16.230.133 role=node 8203d85a... 172.16.230.135 role=node
Excellent! A working cluster! Next, create a test service and launch it. In this example, the "hello" service shown on Core OS Quickstart
Once the service is created as a file with the editor of choice, submit it and run it. Additionally, export the environment variable
FLEETCTL_ENDPOINT to make submission not require it explicitely:
core@core_03 ~ $ export FLEETCTL_ENDPOINT=http://172.16.230.132:4001 core@core_03 ~ $ fleetctl submit hello.service core@core_03 ~ $ fleetctl list-unit-files UNIT HASH DSTATE STATE TARGET hello.service 0d1c468 inactive inactive - core@core_03 ~ $ fleetctl start hello Unit hello.service launched on 11cf48ee.../172.16.230.134 core@core_03 ~ $ fleetctl list-units UNIT MACHINE ACTIVE SUB hello.service 11cf48ee.../172.16.230.134 activating start-pre core@core_03 ~ $ fleetctl list-units UNIT MACHINE ACTIVE SUB hello.service 11cf48ee.../172.16.230.134 active running
The cluster is now open for business!
This document has shown how to easily set up a CoreOS cluster, as well as how to do some useful work with the VMware command line tools. For more information, do join the
#coreos IRC channel on Freenode, as well as the documentation on CoreOS's site.
Lastly, many many thanks to Kelsey Hightower for his patience and help with setting this up and answering a slew of questions!