add linode vps documentation

docs/cloud/index.md

@@ -17,6 +17,7 @@ The Docnow App has been successfully tested to run on the following Cloud Servic
 
 * [AWS](https://docnow.readthedocs.io/en/latest/cloud/aws/)
 * [Digital Ocean](https://docnow.readthedocs.io/en/latest/cloud/digital-ocean/)
+* [Linode](https://docnow.readthedocs.io/en/latest/cloud/linode)
 * [Scaleway](https://docnow.readthedocs.io/en/latest/cloud/scaleway/)
 
 Looking to use a CSP not listed here? We'd love to work with you to add documentation. Feel free to edit this repository, or reach out to [email protected]

docs/cloud/linode.md

@@ -0,0 +1,184 @@
+## Linode Service Provider
+
+The following is a step-by-step guide to installing DocNow in Linode. The instructions use terminology for macOS. You should be able to follow these instructions without prior experience with Linode or macOS Terminal, but if this is your first time administering an application, fair warning! This may take up to 2 hours to install.
+
+Please follow each step carefully and open an issue on the [Github
+Repository](https://github.com/DocNow/docnow-ansible/issues) if you find
+something missing.
+
+
+***Installing DocNow in Linode will cost money, both for running a server and collecting and storing data. Please remember to turn off your Virtual Private Server (VPS) when you are done to avoid extra charges.***
+
+### 1. Install Ansible
+
+Ansible will be used to configure the Virtual Private Server you will be setting up on [Linode](https://login.linode.com/signup?promo=DOCS32SAFC). This server will host the DocNow App. 
+
+You will need a Programmers Editors like [Microsoft's VSCode](https://code.visualstudio.com) to make edits below
+
+Start by opening the Terminal application on your Mac in `Applications/Utilities` 
+
+Install Homebrew by copying the following into your Terminal: 
+
+``` /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" ```
+
+*This will take a few minutes*
+
+Then copy the following into your Terminal:
+
+```git -C /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core fetch --unshallow```
+
+*This will take a few minutes*
+
+Then install Ansible by copying the following into your Terminal:
+
+``` brew install ansible ```
+
+Now your computer has the tools it needs to interface with Linode. 
+
+### 2. Set up your Linode account
+
+* Follow the Linode instructions to [create a Linode account here](https://www.linode.com/docs/guides/getting-started/)
+
+### Create an SSH Key
+
+To host your Docnow Application on Linode you will need SSH
+(Secure Shell, allows for secure access to remote servers).
+
+SSH uses public and private keys.
+
+* Your public SSH key is what you'll provide Linode in order to authorize access to your server.
+* Your private SSH key remains on your computer and is required to log into your Linode server.
+
+**Creating an SSH keypair**
+
+Open your computer's Terminal:
+
+-   On macOS, this can be found by typing `terminal`' in Spotlight, or under `Applications \> Utilities \> Terminal`.
+
+If you have never created an SSH keypair before, Type the following
+command and hit Enter:
+
+```bash
+ssh-keygen -f ~/.ssh/docnow_id_rsa
+```
+
+This will save your Linode keys under a hidden directory name
+`/Users/[macOSusername]/.ssh` which is the default location of your ssh keys.
+You can list the contents of the directory by running the following:
+
+```bash
+ls -alt ~/.ssh/
+```
+
+If this your first time you will see the `docnow_id_rsa`
+private key and it's public pair of `docnow_id_rsa.pub]`
+
+If you already have keys you will also see `id_rsa` private
+key and `id_rsa.pub` public pair.
+
+You'll then be prompted to enter the file where you want to save the
+key. If you've never created an SSH key before on this computer, hit
+Enter without typing anything to save it to the default location.
+
+```bash
+Generating public/private rsa key pair.
+Enter file in which to save the key
+(/Users/[macOSusername]/.ssh/docnow_id_rsa):
+```
+
+After hitting enter, you'll be prompted for an optional passphrase which
+encrypts the private SSH key. (This is an added security to protect your
+keys, should you ever lose your computer.)
+
+We strongly recommend setting a passphrase. Keep in mind forgetting this
+passphrase will at least temporarily lock you out of your Linode
+server.
+
+```bash
+Enter passphrase (empty for no passphrase):
+Enter same passphrase again:
+```
+
+⚠️Note: Nothing will appear in the terminal as you enter your
+passphrase. This is intentional. You're still typing though.
+
+You now have a public and private key that you'll use to authenticate
+with the server you'll create. The screen output will look like
+this:
+
+```bash
+Your identification has been saved in
+/Users/[macOSusername]/.ssh/docnow_id_rsa.
+Your public key has been saved in
+/Users/[macOSusername]/.ssh/docnow_id_rsa.pub.
+
+The key fingerprint is:
+
+a9:49:EX:AM:PL:E3:3e:a9:de:4e:77:11:58:b6:90:26 [macOSusername]@mac-mini
+
+The key's randomart image is:
++--[ RSA 2048]----+
+\| ..o \|
+\| E o= . \|
+\| o. o \|
+\| .. \|
+\| ..S \|
+\| o o. \|
+\| =o.+. \|
+\| . =++.. \|
+\| o=++. \|
++-----------------+
+```
+
+**Obtaining your public SSH key**
+
+After generating an SSH keypair, run the following command in your
+terminal to display your public key:
+
+
+
+
+### 3. Create your Virtual Private Server
+
+* Create your Linode [Virtual Private Server](https://cloud.linode.com/linodes)
+  * Choose a Distribution: Select Ubuntu 18.04 LTS
+  * Region: (any region is OK)
+  * Linode Plan: Select "Shared CPU/ Linode 4GB"
+  * SSH Keys: Select: "Add an SSH Key" Label: Docnow SSH Public Key: "contents of ```cat ~/.ssh docnow_id_rsa.pub``` Add Key
+  * Create the Linode and take note of the resulting IP address (for this example we will use 1.2.2.4) of your Virtual Private Server
+  * Open your Terminal Application 
+  * Connect to your Virtual Private Server with the following command using the key you created above 
+
+```ssh -i ~/.ssh/docnow_id_rsa root@[yourIPaddresshere]```
+
+If you have permissions issues, run the following in Terminal:
+
+```chmod 0400 ~/.ssh/docnow_id_rsa```
+
+```exit```
+
+You will see:
+
+```
+The authenticity of host '[yourIPaddress] [yourIPaddress]' cannot be established.
+ED25519 key fingerprint is SHA256:MtFD6zgLJkyr6Ju8nmzwNqwvqy+rayVVnp1NW97DW0s.
+This key is not known by any other names
+Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
+Warning: Permanently added '[yourIPaddress]' (ED25519) to the list of known hosts.
+Welcome to Ubuntu 18.04.1 LTS (GNU/Linux 4.15.0-1021-Linode x86_64)
+```
+
+### 4. Launch your application
+
+* Download and unzip the [docnow-ansible](https://github.com/docnow/docnow-ansible) zip file or, if you are a GitHub user, clone the repository to a location on your computer. 
+* Move the docnow-ansible folder to your Documents folder
+* Modify the `hosts.example` to have the IP address from the steps above. 
+* rename the file  `hosts.example` file to `hosts`
+
+Run the following commands in Terminal: 
+
+``` cd /Users/[macOSusername]/Documents/docnow-ansible-main```
+
+```ansible-playbook -i hosts playbooks/linode_ubuntu_deploy.yml```
+
+When it completes if you point your browser to the IP in the example thus far http://1.2.2.4 you will see the configuration page for your docnow application

mkdocs.yml

@@ -27,6 +27,7 @@ nav:
     - Overview: cloud/index.md
     - AWS: cloud/aws.md
     - Digital Ocean: cloud/digital-ocean.md
+    - Linode: cloud/linode.md
     - Scaleway: cloud/scaleway.md
   - Troubleshooting: troubleshooting.md
   - API: api.md