From 080e5722b33e9dc196f03f318c329b2863c8f84c Mon Sep 17 00:00:00 2001 From: John Wilkins Date: Tue, 28 Aug 2012 10:55:04 -0700 Subject: [PATCH] doc: added internal hyperlink targets. Signed-off-by: John Wilkins --- doc/install/chef.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/doc/install/chef.rst b/doc/install/chef.rst index 6b137feb9760a..26eba673c69f5 100644 --- a/doc/install/chef.rst +++ b/doc/install/chef.rst @@ -11,6 +11,8 @@ Chef defines three types of entities: See `Chef Architecture Introduction`_ for details. +.. _createuser: + Create a ``chef`` User ---------------------- The ``chef-client`` command requires the proper privileges to install and manage @@ -34,6 +36,8 @@ need to add the following to the ``/etc/sudoers`` file:: .. important:: Do not change the file permissions on ``/etc/sudoers``. Use a suitable tool such as ``visudo``. +.. _genkeys: + Generate SSH Keys for Chef Clients ---------------------------------- Chef's ``knife`` tool can run ``ssh``. To streamline deployments, we @@ -66,6 +70,8 @@ logging in as ``chef`` when no username is specified. :: Hostname myserver02.fqdn-or-ip-address.com User chef +.. _installruby: + Installing Ruby --------------- Chef requires you to install Ruby. Use the version applicable to your current @@ -74,6 +80,8 @@ Linux distribution and install Ruby on all of your hosts. :: sudo apt-get update sudo apt-get install ruby +.. _installchefserver: + Installing Chef and Chef Server on a Server ------------------------------------------- If you plan on hosting your `Chef Server at Opscode`_ you may skip this step, @@ -125,6 +133,7 @@ The Chef web UI will prompt you to enter the username and password. Once you have entered the temporary password, the Chef web UI will prompt you to enter a new password. +.. _installchef: Install Chef on all Remaining Hosts ----------------------------------- @@ -156,6 +165,7 @@ For example:: http://fqdn-or-ip-address.com:4000 +.. _configknife: Configuring Knife ----------------- @@ -209,6 +219,7 @@ default value so that it points to the ``.chef`` directory. *Please enter the path to a chef repository (or leave blank):* Leave the entry field blank and press **Enter**. +.. _addcbpath: Add a Cookbook Path ------------------- @@ -224,6 +235,8 @@ Then create the path if it doesn't already exist. :: This is where you will store local copies of cookbooks before uploading them to the Chef server. +.. _cpvalpem: + Copy ``validation.pem`` to Nodes -------------------------------- Copy the ``/etc/chef/validation.pem`` file from your Chef server to @@ -233,6 +246,8 @@ execute it. :: sudo cat /etc/chef/validation.pem | ssh {nodename} "exec sudo tee /etc/chef/validation.pem >/dev/null" +.. _runchefcli: + Run ``chef-client`` on each Chef Node ------------------------------------- Run the ``chef-client`` on each Chef Node so that the nodes @@ -241,6 +256,8 @@ register with the Chef server. :: ssh chef-node sudo chef-client +.. _verifynodes: + Verify Nodes ------------ Verify that you have setup all the hosts you want to use as -- 2.39.5