From 87896a7d79ecfe06d2538e719061d6e75e1d7952 Mon Sep 17 00:00:00 2001 From: Micah Anderson Date: Tue, 21 Nov 2017 10:05:14 -0500 Subject: Docs: Update docs to prepare for 0.10.0 release Fixes: #8427, #8812 --- docs/en/tutorials/quick-start/guide/commands.html | 0 docs/en/tutorials/quick-start/index.html | 58 ++++++++++++++++++++--- docs/en/tutorials/quick-start/platform.html | 0 3 files changed, 51 insertions(+), 7 deletions(-) create mode 100644 docs/en/tutorials/quick-start/guide/commands.html create mode 100644 docs/en/tutorials/quick-start/platform.html (limited to 'docs/en/tutorials/quick-start') diff --git a/docs/en/tutorials/quick-start/guide/commands.html b/docs/en/tutorials/quick-start/guide/commands.html new file mode 100644 index 00000000..e69de29b diff --git a/docs/en/tutorials/quick-start/index.html b/docs/en/tutorials/quick-start/index.html index 27b21238..ae617e1b 100644 --- a/docs/en/tutorials/quick-start/index.html +++ b/docs/en/tutorials/quick-start/index.html @@ -122,6 +122,9 @@ Quick Start Tutorial - LEAP Platform Documentation
  • Install pre-requisites
  • +
  • + The platform recipes +
  • Install the LEAP command-line utility
  • @@ -139,6 +142,9 @@ Quick Start Tutorial - LEAP Platform Documentation
  • Option B: Add a local node
  • +
  • + Option C: Add a virtual machine in the cloud +
  • @@ -197,7 +203,7 @@ Quick Start Tutorial - LEAP Platform Documentation
    1. A local Vagrant virtual machine: a Vagrant machine can only be useful for testing.
    2. -
    3. A real or paravirtualized server: The server must have Debian Jessie installed, and you must be able to SSH into the machine as root. Paravirtualization includes KVM, Xen, OpenStack, Amazon, but not VirtualBox or OpenVZ.
    4. +
    5. A real or paravirtualized server: The server must have Debian Jessie installed, and you must be able to SSH into the machine as root. Paravirtualization includes KVM, Xen, OpenStack, Amazon, but not VirtualBox or OpenVZ. Proxmox has an known issue when changing the resolver
  • @@ -214,15 +220,20 @@ Quick Start Tutorial - LEAP Platform Documentation

    Prepare your workstation

    -

    In order to be able to manage your servers, you need to install the leap command on your workstation:

    +

    In order to be able to manage your servers, you need to setup the LEAP Platform on your desktop. This consists of three parts: the platform recipes, the leap command, and your provider instance. We will go over these step-by-step below, you can find more details in the platform introduction.

    Install pre-requisites

    Install core prerequisites on your workstation.

    -

    Debian & Ubuntu

    +

    Debian Unstable (sid)

    + +
    workstation$ sudo apt-get install git rsync openssh-client openssl zlib1g-dev
    +
    + +

    Other Debian & Ubuntu

    -
    workstation$ sudo apt-get install git ruby ruby-dev rsync openssh-client openssl rake make bzip2
    +
    workstation$ sudo apt-get install git ruby ruby-dev rsync openssh-client openssl rake make bzip2 zlib1g-dev
     

    Mac OS

    @@ -231,9 +242,38 @@ Quick Start Tutorial - LEAP Platform Documentation workstation$ ruby-install ruby
    +

    The platform recipes

    + +

    The LEAP platform recipes are a set modules designed to work together to provide you everything you need to manage your provider. You typically do not need to modify these, but do need them available for deploying your provider.

    + +

    To obtain the platform recipes, simply clone the git repository, and then check out the most recent stable release branch:

    + +
    workstation$ git clone -b version/0.9.x https://leap.se/git/leap_platform
    +
    + +

    If you want to get the latest development branch (Beware: it could be unstable !) you could simply use the master branch instead by:

    + +
    workstation$ git clone https://leap.se/git/leap_platform
    +
    +

    Install the LEAP command-line utility

    -

    Install the leap command system-wide:

    +

    The leap command line tool is what you use to manage everything about your provider.

    + +

    Keep these rules in mind:

    + + + + +

    If on Debian Unstable (sid), simply do this:

    + +
    workstation$ sudo apt install leap-cli
    +
    + +

    Otherwise, you will need to do this:

    workstation$ sudo gem install leap_cli
     
    @@ -340,14 +380,18 @@ workstation$ leap cert csr

    Option B: Add a local node

    -

    Create a node, with the services “webapp” and “couchdb”, and then start the local virtual machine:

    +

    Create a node, with the services “webapp”, “soledad” and “couchdb”, and then start the local virtual machine:

    -
    workstation$ leap node add --local wildebeest services:webapp,couchdb
    +
    workstation$ leap node add --local wildebeest services:webapp,couchdb,soledad
     workstation$ leap local start wildebeest
     

    It will take a while to download the Virtualbox base box and create the virtual machine.

    +

    Option C: Add a virtual machine in the cloud

    + +

    In order to create a provider using the cloud, please follow this instructions.

    +

    Deploy your provider

    Initialize the node

    diff --git a/docs/en/tutorials/quick-start/platform.html b/docs/en/tutorials/quick-start/platform.html new file mode 100644 index 00000000..e69de29b -- cgit v1.2.3