![]() |
Website: http://lattice.cf Mailing List: Google Groups |
Lattice is an open source project for running containerized workloads on a cluster. Lattice bundles up http load-balancing, a cluster scheduler, log aggregation/streaming and health management into an easy-to-deploy and easy-to-use package.
Lattice is based on a number of open source Cloud Foundry components:
- Diego schedules and monitors containerized workloads
- Doppler aggregates and streams application logs
- Gorouter provides http load-balancing
A local deployment of Lattice can be launched with Vagrant.
A scalable cluster deployment of Lattice can be launched with Terraform. We currently support AWS, DigitalOcean, and Google Cloud
The Lattice CLI ltc
provides a command line interface for launching docker-based applications.
More complex workloads can be constructed and submitted directly to Lattice's Receptor API which is fully documented here.
Make sure you have Vagrant installed, then:
git clone git@github.com:cloudfoundry-incubator/lattice.git
cd lattice
git checkout <VERSION>
vagrant up
This spins up a virtual environment that is accessible at 192.168.11.11
. Here, VERSION
refers to the tagged version you wish to deploy. These tagged versions are known to be stable.
Use the Lattice CLI to target Lattice:
ltc target 192.168.11.11.xip.io
You can do this with either VMware Fusion or VirtualBox:
Virtualbox:
vagrant up --provider virtualbox
VMware Fusion:
vagrant up --provider vmware_fusion
If you are trying to run both the VirtualBox and VMWare providers on the same machine, you'll need to run them on different private networks (subnets) that do not conflict.
Set the System IP to an address that does not conflict with the host networking configuration by passing the LATTICE_SYSTEM_IP environment variable to the vagrant up command:
LATTICE_SYSTEM_IP=192.168.80.100 vagrant up
ltc target 192.168.80.100.xip.io
Currently, Lattice does not support updating via provision. So to update, you have to destroy the box and bring it back up:
vagrant destroy --force
git pull
vagrant up
- xip.io is sometimes flaky, resulting in no such host errors.
- The alternative that we have found is to use dnsmasq configured to resolve all xip.io addresses to 192.168.11.11.
- This also requires creating a /etc/resolvers/io file that points to 127.0.0.1. See further instructions [here] (http://passingcuriosity.com/2013/dnsmasq-dev-osx/).
By default, vagrant up
will fetch the latest Lattice binary tarball. To use a particular tarball:
VAGRANT_LATTICE_TAR_PATH=/path/to/lattice.tgz vagrant up
This repository contains several Terraform templates to help you deploy on your choice of IaaS. To deploy Lattice in this way you will need:
- Terraform >= 0.3.7 installed on your machine
- Credentials for your choice of IaaS
Here are some step-by-step instructions for deploying a Lattice cluster via Terraform:
- Visit the Lattice GitHub Releases page
- Select the Lattice version you wish to deploy and download the Terraform example file for your target platform. The filename will be
lattice.<platform>.tf
- Create an empty folder and place the
lattice.<platform>.tf
file in that folder. - Update the
lattice.<platform>.tf
by filling in the values for the variables. Instructions for each supported platform are here:
- Run the following commands in the folder containing the
lattice.<platform>.tf
file
terraform get -update
terraform apply
This will deploy the cluster.
Upon success, terraform will print the Lattice target:
Outputs:
lattice_target = x.x.x.x.xip.io
lattice_username = xxxxxxxx
lattice_password = xxxxxxxx
which you can use with the Lattice CLI to ltc target x.x.x.x.xip.io
.
Terraform will generate a terraform.tfstate
file. This file describes the cluster that was built - keep it around in order to modify/tear down the cluster.
To destroy the cluster go to the folder containing the terraform.tfstate
file and run:
terraform destroy
In the spirit of free software, everyone is encouraged to help improve this project.
Here are some ways you can contribute:
- by using alpha, beta, and prerelease versions
- by reporting bugs
- by suggesting new features
- by writing or editing documentation
- by writing specifications
- by writing code (no patch is too small: fix typos, add comments, clean up inconsistent whitespace)
- by refactoring code
- by closing issues
- by reviewing patches
Also see the Development Readme
Development work should be done on the develop branch. As a general rule, only CI should commit to master.
We use the GitHub issue tracker to track bugs and features. Before submitting a bug report or feature request, check to make sure it hasn't already been submitted. You can indicate support for an existing issue by voting it up. When submitting a bug report, please include a Gist that includes a stack trace and any details that may be necessary to reproduce the bug including the Lattice version.
- Propose a change by opening an issue.
- Fork the project.
- Create a topic branch.
- Implement your feature or bug fix.
- Commit and push your changes.
- Submit a pull request.
See LICENSE for details. Copyright (c) 2015 Pivotal Software, Inc.