<commit_before>:layout: homepage

============================
Getting started with Flocker
============================

.. logo::

.. intro-text::

   Flocker lets you run microservices apps with database containers and move them around between servers. It comes in two pieces and you’ll need both.

.. contents::
   :local:

.. tutorial-step::

   Step 1: Installing Flocker CLI & Node
   =====================================

   .. parallel::

      .. mobile-label::

         Local

      .. image:: images/macbook.png
         :class: center-block img-responsive
         :alt: Flocker CLI diagram

      Flocker CLI
      -----------

      +--------------------------------------------------------------------------+
      | Runs on your laptop                                                      |
      +--------------------------------------------------------------------------+
      | Uses application and deployment configuration files                      |
      +--------------------------------------------------------------------------+
      | Deploys containers to a cluster of servers                               |
      +--------------------------------------------------------------------------+

      .. empty-div:: arrow-down center-block hidden-xs hidden-sm

   .. parallel::

      .. mobile-label::

         Live

      .. image:: images/nodes.png
         :class: center-block offset-top img-responsive
         :alt: Flocker Node diagram

      Flocker Node
      ------------

      +--------------------------------------------------------------------------+
      | Runs on each server in a cluster                                         |
      +--------------------------------------------------------------------------+
      | Links, ports and volumes work across hosts                               |
      +--------------------------------------------------------------------------+
      | After deployment, containers can move around                             |
      +--------------------------------------------------------------------------+

      .. empty-div:: arrow-down center-block

   .. parallel::

      Installation
      ------------

      .. mobile-label::

         Local

      .. noscript-content::
      
         OS X
         ^^^^

         Install the flocker-cli client on your Mac (requires Homebrew):

         .. code-block:: console

            you@laptop:~$ brew update && \
              brew tap clusterhq/flocker && \
              brew install flocker-0.3.2
            
      .. noscript-content::

         Ubuntu / Debian
         ^^^^^^^^^^^^^^^

         Install the flocker-cli client on your Linux machine:
         
         .. code-block:: console
         
            you@laptop:~$ sudo apt-get update && apt-get install -y gcc python2.7 python-virtualenv python2.7-dev && \         
              virtualenv flocker-tutorial && \
              flocker-tutorial/bin/pip install --upgrade pip && \
              flocker-tutorial/bin/pip install --quiet https://storage.googleapis.com/archive.clusterhq.com/downloads/flocker/Flocker-0.3.2-py2-none-any.whl

         Fedora 20
         ^^^^^^^^^

         Install the flocker-cli client on your Linux machine:
         
         .. code-block:: console
         
            you@laptop:~$ sudo yum install -y @buildsys-build python python-devel python-virtualenv && \
              virtualenv flocker-tutorial && \
              flocker-tutorial/bin/pip install --upgrade pip && \
              flocker-tutorial/bin/pip install --quiet https://storage.googleapis.com/archive.clusterhq.com/downloads/flocker/Flocker-0.3.2-py2-none-any.whl


      .. tabs::

         OS X
         ^^^^

         Install the flocker-cli client on your Mac (requires Homebrew):

         .. code-block:: console

            you@laptop:~$ brew update && \
              brew tap clusterhq/flocker && \
              brew install flocker-0.3.2

         Ubuntu / Debian
         ^^^^^^^^^^^^^^^

         Install the flocker-cli client on your Linux machine:
         
         .. code-block:: console
         
            you@laptop:~$ sudo apt-get update && apt-get install -y gcc python2.7 python-virtualenv python2.7-dev && \         
              virtualenv flocker-tutorial && \
              flocker-tutorial/bin/pip install --upgrade pip && \
              flocker-tutorial/bin/pip install --quiet https://storage.googleapis.com/archive.clusterhq.com/downloads/flocker/Flocker-0.3.2-py2-none-any.whl

         Fedora 20
         ^^^^^^^^^

         Install the flocker-cli client on your Linux machine:
         
         .. code-block:: console
         
            you@laptop:~$ sudo yum install -y @buildsys-build python python-devel python-virtualenv && \
              virtualenv flocker-tutorial && \
              flocker-tutorial/bin/pip install --upgrade pip && \
              flocker-tutorial/bin/pip install --quiet https://storage.googleapis.com/archive.clusterhq.com/downloads/flocker/Flocker-0.3.2-py2-none-any.whl

      .. empty-div:: arrow-down center-block invisible

   .. parallel::

      Installation
      ------------

      .. mobile-label::

         Live

      .. noscript-content::

         Vagrant
         ^^^^^^^

         Simulate a Flocker cluster with virtual machines on your laptop (requires `Vagrant <http://www.vagrantup.com/downloads>`_, `VirtualBox <https://www.virtualbox.org/wiki/Downloads>`_):<commit_msg>add command to activate virtualenv to linux CLI install commands<commit_after>:layout: homepage

============================
Getting started with Flocker
============================

.. logo::

.. intro-text::

   Flocker lets you run microservices apps with database containers and move them around between servers. It comes in two pieces and you’ll need both.

.. contents::
   :local:

.. tutorial-step::

   Step 1: Installing Flocker CLI & Node
   =====================================

   .. parallel::

      .. mobile-label::

         Local

      .. image:: images/macbook.png
         :class: center-block img-responsive
         :alt: Flocker CLI diagram

      Flocker CLI
      -----------

      +--------------------------------------------------------------------------+
      | Runs on your laptop                                                      |
      +--------------------------------------------------------------------------+
      | Uses application and deployment configuration files                      |
      +--------------------------------------------------------------------------+
      | Deploys containers to a cluster of servers                               |
      +--------------------------------------------------------------------------+

      .. empty-div:: arrow-down center-block hidden-xs hidden-sm

   .. parallel::

      .. mobile-label::

         Live

      .. image:: images/nodes.png
         :class: center-block offset-top img-responsive
         :alt: Flocker Node diagram

      Flocker Node
      ------------

      +--------------------------------------------------------------------------+
      | Runs on each server in a cluster                                         |
      +--------------------------------------------------------------------------+
      | Links, ports and volumes work across hosts                               |
      +--------------------------------------------------------------------------+
      | After deployment, containers can move around                             |
      +--------------------------------------------------------------------------+

      .. empty-div:: arrow-down center-block

   .. parallel::

      Installation
      ------------

      .. mobile-label::

         Local

      .. noscript-content::
      
         OS X
         ^^^^

         Install the flocker-cli client on your Mac (requires Homebrew):

         .. code-block:: console

            you@laptop:~$ brew update && \
              brew tap clusterhq/flocker && \
              brew install flocker-0.3.2
            
      .. noscript-content::

         Ubuntu / Debian
         ^^^^^^^^^^^^^^^

         Install the flocker-cli client on your Linux machine:
         
         .. code-block:: console
         
            you@laptop:~$ sudo apt-get update && apt-get install -y gcc python2.7 python-virtualenv python2.7-dev && \         
              virtualenv flocker-tutorial && \
              flocker-tutorial/bin/pip install --upgrade pip && \
              flocker-tutorial/bin/pip install --quiet https://storage.googleapis.com/archive.clusterhq.com/downloads/flocker/Flocker-0.3.2-py2-none-any.whl && source flocker-tutorial/bin/activate

         Fedora 20
         ^^^^^^^^^

         Install the flocker-cli client on your Linux machine:
         
         .. code-block:: console
         
            you@laptop:~$ sudo yum install -y @buildsys-build python python-devel python-virtualenv && \
              virtualenv flocker-tutorial && \
              flocker-tutorial/bin/pip install --upgrade pip && \
              flocker-tutorial/bin/pip install --quiet https://storage.googleapis.com/archive.clusterhq.com/downloads/flocker/Flocker-0.3.2-py2-none-any.whl && source flocker-tutorial/bin/activate


      .. tabs::

         OS X
         ^^^^

         Install the flocker-cli client on your Mac (requires Homebrew):

         .. code-block:: console

            you@laptop:~$ brew update && \
              brew tap clusterhq/flocker && \
              brew install flocker-0.3.2

         Ubuntu / Debian
         ^^^^^^^^^^^^^^^

         Install the flocker-cli client on your Linux machine:
         
         .. code-block:: console
         
            you@laptop:~$ sudo apt-get update && apt-get install -y gcc python2.7 python-virtualenv python2.7-dev && \         
              virtualenv flocker-tutorial && \
              flocker-tutorial/bin/pip install --upgrade pip && \
              flocker-tutorial/bin/pip install --quiet https://storage.googleapis.com/archive.clusterhq.com/downloads/flocker/Flocker-0.3.2-py2-none-any.whl && source flocker-tutorial/bin/activate

         Fedora 20
         ^^^^^^^^^

         Install the flocker-cli client on your Linux machine:
         
         .. code-block:: console
         
            you@laptop:~$ sudo yum install -y @buildsys-build python python-devel python-virtualenv && \
              virtualenv flocker-tutorial && \
              flocker-tutorial/bin/pip install --upgrade pip && \
              flocker-tutorial/bin/pip install --quiet https://storage.googleapis.com/archive.clusterhq.com/downloads/flocker/Flocker-0.3.2-py2-none-any.whl && source flocker-tutorial/bin/activate

      .. empty-div:: arrow-down center-block invisible

   .. parallel::

      Installation
      ------------

      .. mobile-label::

         Live

      .. noscript-content::

         Vagrant
         ^^^^^^^

         Simulate a Flocker cluster with virtual machines on your laptop (requires `Vagrant <http://www.vagrantup.com/downloads>`_, `VirtualBox <https://www.virtualbox.org/wiki/Downloads>`_):
{'fraction_non_alphanumeric': 0.22623625145309845, 'fraction_numerical': 0.006259501028346597, 'mean_word_length': 1.187793427230047, 'pattern_counts': {'":': 0, '<': 7, '<?xml version=': 0, '>': 7, 'https://': 10, 'lorem ipsum': 0, 'www.': 4, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 18, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '7039060', 'n_tokens_mistral': 2859, 'n_tokens_neox': 2586, 'n_words': 654}