From 9d9d81f71100877020e89ac35fe9724df17c1fbc Mon Sep 17 00:00:00 2001 From: Scott Lowe Date: Thu, 23 Feb 2017 17:08:46 -0700 Subject: [PATCH] Add technology-specific README files Add README.md files for specific technology areas (Ansible, CentOS Atomic Host, Consul, CoreOS, Debian, Docker, and etcd). Signed-off-by: Scott Lowe --- ansible/README.md | 7 +++++++ centos-atomic/README.md | 7 +++++++ consul/README.md | 9 +++++++++ coreos/README.md | 7 +++++++ debian/README.md | 7 +++++++ docker/README.md | 23 +++++++++++++++++++++++ etcd/README.md | 7 +++++++ 7 files changed, 67 insertions(+) create mode 100644 ansible/README.md create mode 100644 centos-atomic/README.md create mode 100644 consul/README.md create mode 100644 coreos/README.md create mode 100644 debian/README.md create mode 100644 docker/README.md create mode 100644 etcd/README.md diff --git a/ansible/README.md b/ansible/README.md new file mode 100644 index 0000000..b050a72 --- /dev/null +++ b/ansible/README.md @@ -0,0 +1,7 @@ +# Learning Tools: Ansible + +This folder contains tools, resources, and examples to help with learning how to use Ansible in a variety of environments and for a variety of use cases. + +## Contents + +**ansible-aws**: This set of files shows how to use Ansible to both provision infrastructure on AWS as well as how to decommission (tear down) that same infrastructure. diff --git a/centos-atomic/README.md b/centos-atomic/README.md new file mode 100644 index 0000000..5d8a010 --- /dev/null +++ b/centos-atomic/README.md @@ -0,0 +1,7 @@ +# Learning Tools: CentOS Atomic Host + +Everything in this folder is focused around CentOS Atomic Host. + +## Contents + +**docker-tcp**: This folder is about customizing the behavior and configuration of the Docker Engine daemon on CentOS Atomic Host, but without modifying the built-in systemd unit file(s). diff --git a/consul/README.md b/consul/README.md new file mode 100644 index 0000000..c82557d --- /dev/null +++ b/consul/README.md @@ -0,0 +1,9 @@ +# Learning Tools: Consul Distributed Key-Value Store + +The contents of this folder and its subfolders are centered around the installation or configuration of the Consul distributed key-value store. + +## Contents + +**consul-ansible**: In this folder you'll find a `Vagrantfile` and supporting documents to run a Consul cluster under Vagrant on your local laptop. The provisioning is handled via Ansible (pre-2.0) installed on the Vagrant host. + +**consul**: In this folder you'll find a `Vagrantfile` and supporting documents to run a Consul cluster under Vagrant on your local laptop. The provisioning is handled via shell scripts. diff --git a/coreos/README.md b/coreos/README.md new file mode 100644 index 0000000..741f586 --- /dev/null +++ b/coreos/README.md @@ -0,0 +1,7 @@ +# Learning Tools: CoreOS Linux + +Here you'll find Vagrant environments and other resources for learning more about CoreOS. + +## Contents + +**cloudinit-toolbox**: This folder contains files for using cloud-init to customize the CoreOS toolbox. This learning environment can be used with local Vagrant VMs, with OpenStack instances, or with AWS instances. diff --git a/debian/README.md b/debian/README.md new file mode 100644 index 0000000..86200dd --- /dev/null +++ b/debian/README.md @@ -0,0 +1,7 @@ +# Learning Tools: Debian GNU/Linux + +Here you'll find Vagrant environments and other resources for learning more about CoreOS. + +## Contents + +**debian-generic**: This folder has a Vagrant environment for spinning up a generic, 64-bit Debian 8.0 ("Jessie") VM. Note there's nothing special here---just a plain, generic Debian VM. No custom provisioning is provided in this environment. diff --git a/docker/README.md b/docker/README.md new file mode 100644 index 0000000..9abd1e7 --- /dev/null +++ b/docker/README.md @@ -0,0 +1,23 @@ +# Learning Tools: Docker + +Here you'll find a collection of tools and resources for learning about (or experimenting with) Docker and Docker containers. + +## Contents + +**containerd-runc**: _This is a placeholder for future work._ + +**ipvlan-l2**: This folder has files to create a learning environment for using ipvlan interfaces with Docker containers. + +**ipvlan-l3**: This folder has files to create a learning environment for using ipvlan L3 interfaces with Docker containers. + +**ipvs**: Use this learning environment to experiment with using IPVS/LVS for load balancing Docker containers. + +**macvlan**: This folder has files to create a learning environment for using macvlan interfaces with Docker containers. + +**swarm-consul**: This folder contains a `Vagrantfile` and supporting files to run a Consul-backed Docker Swarm cluster under Vagrant on your local system. The provisioning is handled via shell scripts. + +**swarm-etcd**: In this folder is a `Vagrantfile` and supporting files for turning up an etcd 2.0-backed Docker Swarm cluster. The provisioning is handled via shell scripts. + +**swarm-etcd2-photon:** This folder contains a Vagrant environment and associated support files to turn up an etcd-backed Docker Swarm cluster where the Docker Engine instances are running on VMware Photon. Provisioning is handled by Ansible 2.x. + +**swarm-ha**: This folder holds a `Vagrantfile`, supporting files, and instructions for turning up a Consul-backed Docker Swarm cluster with multiple Swarm managers for high availability. The provisioning is handled via shell scripts. diff --git a/etcd/README.md b/etcd/README.md new file mode 100644 index 0000000..d224c80 --- /dev/null +++ b/etcd/README.md @@ -0,0 +1,7 @@ +# Learning Tools: etcd Distributed Key-Value Store + +In this folder are environments, tools, resources, and the like for learning more about etcd, the distributed key-value store. + +## Contents + +**etcd-2.0**: Use the `Vagrantfile` and other files in this directory to turn up an etcd 2.0.9 cluster running on Ubuntu 14.04. The provisioning is handled via shell scripts.