Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pdxjohnny/coreos-vagrant
The Vagrant setup I'm using for a CoreOS cluster
https://github.com/pdxjohnny/coreos-vagrant
Last synced: about 1 month ago
JSON representation
The Vagrant setup I'm using for a CoreOS cluster
- Host: GitHub
- URL: https://github.com/pdxjohnny/coreos-vagrant
- Owner: pdxjohnny
- License: apache-2.0
- Created: 2015-04-25T01:35:31.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2015-04-25T03:19:56.000Z (over 9 years ago)
- Last Synced: 2024-03-16T06:51:33.490Z (8 months ago)
- Language: Ruby
- Size: 227 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# CoreOS Vagrant
This repo provides a template Vagrantfile to create a CoreOS virtual machine using the VirtualBox software hypervisor.
After setup is complete you will have a single CoreOS virtual machine running on your local machine.
## Streamlined setup
1) Install dependencies
* [VirtualBox][virtualbox] 4.3.10 or greater.
* [Vagrant][vagrant] 1.6 or greater.
2) Clone this project and get it running!
```
git clone https://github.com/coreos/coreos-vagrant/
cd coreos-vagrant
```
3) Startup and SSH
There are two "providers" for Vagrant with slightly different instructions.
Follow one of the following two options:
**VirtualBox Provider**
The VirtualBox provider is the default Vagrant provider. Use this if you are unsure.
```
vagrant up
vagrant ssh
```
**VMware Provider**
The VMware provider is a commercial addon from Hashicorp that offers better stability and speed.
If you use this provider follow these instructions.
VMware Fusion:
```
vagrant up --provider vmware_fusion
vagrant ssh
```
VMware Workstation:
```
vagrant up --provider vmware_workstation
vagrant ssh
```
``vagrant up`` triggers vagrant to download the CoreOS image (if necessary) and (re)launch the instance
``vagrant ssh`` connects you to the virtual machine.
Configuration is stored in the directory so you can always return to this machine by executing vagrant ssh from the directory where the Vagrantfile was located.
4) Get started [using CoreOS][using-coreos]
[virtualbox]: https://www.virtualbox.org/
[vagrant]: https://www.vagrantup.com/downloads.html
[using-coreos]: http://coreos.com/docs/using-coreos/
#### Shared Folder Setup
There is optional shared folder setup.
You can try it out by adding a section to your Vagrantfile like this.
```
config.vm.network "private_network", ip: "172.17.8.150"
config.vm.synced_folder ".", "/home/core/share", id: "core", :nfs => true, :mount_options => ['nolock,vers=3,udp']
```
After a 'vagrant reload' you will be prompted for your local machine password.
#### Provisioning with user-data
The Vagrantfile will provision your CoreOS VM(s) with [coreos-cloudinit][coreos-cloudinit] if a `user-data` file is found in the project directory.
coreos-cloudinit simplifies the provisioning process through the use of a script or cloud-config document.
To get started, copy `user-data.sample` to `user-data` and make any necessary modifications.
Check out the [coreos-cloudinit documentation][coreos-cloudinit] to learn about the available features.
[coreos-cloudinit]: https://github.com/coreos/coreos-cloudinit
#### Configuration
The Vagrantfile will parse a `config.rb` file containing a set of options used to configure your CoreOS cluster.
See `config.rb.sample` for more information.
## Cluster Setup
Launching a CoreOS cluster on Vagrant is as simple as configuring `$num_instances` in a `config.rb` file to 3 (or more!) and running `vagrant up`.
Make sure you provide a fresh discovery URL in your `user-data` if you wish to bootstrap etcd in your cluster.
## New Box Versions
CoreOS is a rolling release distribution and versions that are out of date will automatically update.
If you want to start from the most up to date version you will need to make sure that you have the latest box file of CoreOS.
Simply remove the old box file and vagrant will download the latest one the next time you `vagrant up`.
```
vagrant box remove coreos --provider vmware_fusion
vagrant box remove coreos --provider vmware_workstation
vagrant box remove coreos --provider virtualbox
```
## Docker Forwarding
By setting the `$expose_docker_tcp` configuration value you can forward a local TCP port to docker on
each CoreOS machine that you launch. The first machine will be available on the port that you specify
and each additional machine will increment the port by 1.
Follow the [Enable Remote API instructions][coreos-enabling-port-forwarding] to get the CoreOS VM setup to work with port forwarding.
[coreos-enabling-port-forwarding]: https://coreos.com/docs/launching-containers/building/customizing-docker/#enable-the-remote-api-on-a-new-socket
Then you can then use the `docker` command from your local shell by setting `DOCKER_HOST`:
export DOCKER_HOST=tcp://localhost:2375