From 8583bf55ef8b7a98184a554793ae2b867b60976f Mon Sep 17 00:00:00 2001 From: katmutua Date: Tue, 6 Oct 2015 12:42:22 +0300 Subject: [PATCH 1/4] Add practical reference for ansible --- docs/scenarios/admin.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/scenarios/admin.rst b/docs/scenarios/admin.rst index 954e1f6..6893032 100644 --- a/docs/scenarios/admin.rst +++ b/docs/scenarios/admin.rst @@ -231,6 +231,8 @@ To run the playbook: The Ansible playbook will ping all of the servers in the :file:`hosts.yml` file. You can also select groups of servers using Ansible. For more information about Ansible, read the `Ansible Docs `_. +`An Ansible tutorial `_ is also +great and detailed introduction to getting started with Ansible. Chef From f8708694403f47e69dab5a280d03a11b3ce33921 Mon Sep 17 00:00:00 2001 From: katmutua Date: Tue, 6 Oct 2015 13:19:36 +0300 Subject: [PATCH 2/4] Include preliminery content on chef --- docs/scenarios/admin.rst | 18 ++++++++++++++---- 1 file changed, 14 insertions(+), 4 deletions(-) diff --git a/docs/scenarios/admin.rst b/docs/scenarios/admin.rst index 6893032..be8ac9b 100644 --- a/docs/scenarios/admin.rst +++ b/docs/scenarios/admin.rst @@ -231,17 +231,27 @@ To run the playbook: The Ansible playbook will ping all of the servers in the :file:`hosts.yml` file. You can also select groups of servers using Ansible. For more information about Ansible, read the `Ansible Docs `_. -`An Ansible tutorial `_ is also +`An Ansible tutorial `_ is also a great and detailed introduction to getting started with Ansible. Chef ---- +`Chef `_ is a systems and cloud infrastructure automation +framework that makes it easy to deploy servers and applications to any physical, +virtual, or cloud location. Chef works by using custom recipes which can simply be defined +as configuration elements which implement your polices. +These custom recipes are usually stored in your Chef server. -.. todo:: Write about Chef +Chef clients run on every server that is part of your infrastructure and these regularly +check with your Chef server to ensure your system is always aligned and represents the +desired state. Since each individual server has its own distinct Chef client, each server +configures itself and this distributed approach makes Chef a scalable automation platform. + +`Getting started with Chef `_ +is a good starting point for Chef Beginners and many community maintained cookbooks that can +serve as a good reference can be found at the `Chef Supermarket `_. - `Chef Documentation - `_ Puppet ------ From c39415e082b8febe22ca642e031515632968c105 Mon Sep 17 00:00:00 2001 From: katmutua Date: Tue, 6 Oct 2015 13:24:53 +0300 Subject: [PATCH 3/4] Make grammar changes to last commit --- docs/scenarios/admin.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/scenarios/admin.rst b/docs/scenarios/admin.rst index be8ac9b..d198ca3 100644 --- a/docs/scenarios/admin.rst +++ b/docs/scenarios/admin.rst @@ -250,7 +250,8 @@ configures itself and this distributed approach makes Chef a scalable automation `Getting started with Chef `_ is a good starting point for Chef Beginners and many community maintained cookbooks that can -serve as a good reference can be found at the `Chef Supermarket `_. +serve as a good reference or tweaked to server your infrustructure connfiguration needs can be +found at the `Chef Supermarket `_. Puppet From 699255b72a82f6807d30eec8e5b43b7be22a2ba2 Mon Sep 17 00:00:00 2001 From: katmutua Date: Tue, 6 Oct 2015 13:24:53 +0300 Subject: [PATCH 4/4] More notes on chef for configuration management --- docs/scenarios/admin.rst | 20 +++++++++++++++----- 1 file changed, 15 insertions(+), 5 deletions(-) diff --git a/docs/scenarios/admin.rst b/docs/scenarios/admin.rst index d198ca3..41ae97d 100644 --- a/docs/scenarios/admin.rst +++ b/docs/scenarios/admin.rst @@ -231,6 +231,7 @@ To run the playbook: The Ansible playbook will ping all of the servers in the :file:`hosts.yml` file. You can also select groups of servers using Ansible. For more information about Ansible, read the `Ansible Docs `_. + `An Ansible tutorial `_ is also a great and detailed introduction to getting started with Ansible. @@ -239,19 +240,28 @@ Chef ---- `Chef `_ is a systems and cloud infrastructure automation framework that makes it easy to deploy servers and applications to any physical, -virtual, or cloud location. Chef works by using custom recipes which can simply be defined -as configuration elements which implement your polices. -These custom recipes are usually stored in your Chef server. +virtual, or cloud location. In case this is your choice for configuration management, +you will primarily use Ruby to write your infrastructure code. Chef clients run on every server that is part of your infrastructure and these regularly check with your Chef server to ensure your system is always aligned and represents the desired state. Since each individual server has its own distinct Chef client, each server configures itself and this distributed approach makes Chef a scalable automation platform. +Chef works by using custom recipes (configuration elements), implemented in cookbooks. Cookbooks, which are basically +packages for infrastructure choices, are usually stored in your Chef server. +Read the `Digital Ocean tutorial series `_ on chef to learn how to create a simple Chef Server. + +To create a simple cookbook the `knife `_ command is used: + +.. code-block:: console + + knife cookbook create cookbook_name + `Getting started with Chef `_ is a good starting point for Chef Beginners and many community maintained cookbooks that can -serve as a good reference or tweaked to server your infrustructure connfiguration needs can be -found at the `Chef Supermarket `_. +serve as a good reference or tweaked to serve your infrustructure configuration needs can be +found on the `Chef Supermarket `_. Puppet