From 3d768dda2bb803adb1536a0247adc1729478879a Mon Sep 17 00:00:00 2001 From: Cristina Pauna Date: Wed, 10 Aug 2016 17:57:42 +0300 Subject: docs: Add code-block markup Add bash code-block markup for: - instalation instruction guides - build instruction guides Change-Id: If7a0f4cfc17e8cabe5d5ff59a7b2fe80ca0bb66b Signed-off-by: Cristina Pauna Signed-off-by: cristinapauna --- docs/build-instruction.rst | 43 +++++++++++++++++++++++++-------------- docs/installation-instruction.rst | 25 ++++++++++++++++++----- 2 files changed, 48 insertions(+), 20 deletions(-) (limited to 'docs') diff --git a/docs/build-instruction.rst b/docs/build-instruction.rst index ae73a0359..7e381500b 100644 --- a/docs/build-instruction.rst +++ b/docs/build-instruction.rst @@ -51,9 +51,12 @@ On the host, the following packages must be installed: - An x86_64 host (Bare-metal or VM) with Ubuntu 14.04 LTS installed - - A kernel equal- or later than 3.19 (Vivid) (simply available through sudo apt-get install linux-generic-lts-vivid) - - **Note:** Builds on Wily (Ubuntu 15.x) are currently not supported + - A kernel equal- or later than 3.19 (Vivid), simply available through + +.. code-block:: bash + + $ sudo apt-get install linux-generic-lts-vivid - docker - see https://docs.docker.com/installation/ubuntulinux/ for installation notes for Ubuntu 14.04. Note: use the latest version from @@ -74,7 +77,9 @@ Setting up the Docker build container ------------------------------------- After having installed Docker, add yourself to the docker group: -$ sudo usermod -a -G docker [userid] +.. code-block:: bash + + $ sudo usermod -a -G docker [userid] Also make sure to define relevant DNS servers part of the global DNS chain in your configuration file. @@ -82,11 +87,13 @@ Uncomment, and modify the values appropriately. For example: - +.. code-block:: bash + + DOCKER_OPTS=" --dns=8.8.8.8 --dns=8.8.8.4" Then restart docker: -.. code-block:: console +.. code-block:: bash $ sudo service docker restart @@ -148,7 +155,9 @@ for it to be able to pull the base Ubuntu 14.04 image from the Docker registry before invoking make! In Ubuntu this is done by adding a line like: -export http_proxy="http://10.0.0.1:8888/" +.. code-block:: bash + + export http_proxy="http://10.0.0.1:8888/" to /etc/default/docker and restarting the Docker daemon. @@ -159,19 +168,23 @@ The build system will make use the following environment variables that needs to be exported to subshells by using export (bash) or setenv (csh/tcsh). -| http_proxy (or HTTP_PROXY) -| https_proxy (or HTTP_PROXY) -| no_proxy (or NO_PROXY) -| RSYNC_PROXY -| RSYNC_CONNECT_PROG +.. code-block:: bash + + http_proxy (or HTTP_PROXY) + https_proxy (or HTTP_PROXY) + no_proxy (or NO_PROXY) + RSYNC_PROXY + RSYNC_CONNECT_PROG As an example, these are the settings that were put in the user's .bashrc when verifying the proxy build functionality: -| export RSYNC_PROXY=10.0.0.1:8888 -| export http_proxy=http://10.0.0.1:8888 -| export https_proxy=http://10.0.0.1:8888 -| export no_proxy=localhost,127.0.0.1,.consultron.com,.sock +.. code-block:: bash + + export RSYNC_PROXY=10.0.0.1:8888 + export http_proxy=http://10.0.0.1:8888 + export https_proxy=http://10.0.0.1:8888 + export no_proxy=localhost,127.0.0.1,.consultron.com,.sock Using a ssh proxy for the rsync connection ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/docs/installation-instruction.rst b/docs/installation-instruction.rst index a9c62a962..fea90af0d 100644 --- a/docs/installation-instruction.rst +++ b/docs/installation-instruction.rst @@ -51,16 +51,22 @@ Building the ISO image Alternatively, you may build the Fuel .iso from source by cloning the opnfv/fuel git repository. To retrieve the repository for the Colorado release use the following command: -$ git clone https://gerrit.opnfv.org/gerrit/fuel +.. code-block:: bash + + $ git clone https://gerrit.opnfv.org/gerrit/fuel Check-out the Colorado release tag to set the HEAD to the baseline required to replicate the Colorado release: -$ git checkout colorado.1.0 +.. code-block:: bash + + $ git checkout colorado.1.0 Go to the fuel directory and build the .iso: -$ cd fuel/build; make all +.. code-block:: bash + + $ cd fuel/build; make all For more information on how to build, please see *Reference: 14* @@ -301,8 +307,17 @@ Install additional Plugins/Features on the FUEL node #. Select wanted plugins/features from the /opt/opnfv/ directory. -#. Install the wanted plugin with the command "fuel plugins --install /opt/opnfv/-..rpm" - Expected output: "Plugin ....... was successfully installed." (see figure below) +#. Install the wanted plugin with the command + + .. code-block:: bash + + $ fuel plugins --install /opt/opnfv/-..rpm + + Expected output (see figure below): + + .. code-block:: bash + + Plugin ....... was successfully installed. .. figure:: img/plugin_install.png -- cgit 1.2.3-korg