Initial commit for new Digital Ocean Deployment Docs

docs/3.x.x/guides/deployment.md

@@ -2,15 +2,15 @@
 
 Strapi gives you many possible deployment options for your project or application. Strapi can be deployed on traditional hosting servers or services such as Heroku, AWS, Azure and others. The following documentation covers how to develop locally with Strapi and deploy Strapi with various hosting options.
 
-
-
 (Deploying **databases** along with Strapi is covered in the [Databases Guide](/3.x.x/guides/databases.html).)
 
 **Table of contents:**
 
 - [Configuration](#configuration)
+- [Digital Ocean](#digital-ocean)
 - [Heroku](#heroku)
 - [Docker](#docker)
+
 ---
 
 ## Configuration
@@ -20,6 +20,7 @@ Strapi gives you many possible deployment options for your project or applicatio
 Update the `production` settings with the IP and domain name where the project will be running.
 
 **Path —** `./config/environments/production/server.json`.
+
 ```js
 {
   "host": "domain.io", // IP or domain
@@ -39,6 +40,7 @@ database (`./config/environments/production/database.json`) is set properly.
 If you are passing a number of configuration item values via environment variables which is always encouraged for production environment to keep application stateless, checkout the section for [Dynamic Configuration](../configurations/configurations.md#dynamic-configurations). Here is a hint on how to do it for production, for the configuration mentioned above:
 
 **Path —** `./config/environments/production/server.json`.
+
 ```js
 {
   "host": "${process.env.APP_HOST || '127.0.0.1'}"
@@ -83,9 +85,38 @@ We highly recommend to use [pm2](https://github.com/Unitech/pm2/) to manage your
 
 If you want to host the administration on another server than the API, [please take a look at this dedicated section](../advanced/customize-admin.md#deployment).
 
+## Digital Ocean
+
+This is a step-by-step guide for deploying a Strapi project to [Digital Ocean](https://www.digitalocean.com/). Databases can be used locally on the server or hosted externally as a service.
+
+### Digital Ocean Install Requirements
+
+- You must have a [Digital Ocean account](https://cloud.digitalocean.com/registrations/new) before doing these steps.
+
+### Create a Droplet
+
+Digital Ocean calls a virtual private server, a **Droplet**. You need to create a new `Droplet` to host your Strapi project.
+
+1. Log in to your [Digital Ocean account](https://cloud.digitalocean.com/login).
+2. `Create a Droplet` by clicking on `New Droplet`. Choose these options:
+
+- Ubuntu 18.04 x64
+- STARTER `Standard`
+- Pricing: \$5/mo _(Scroll to the left)_
+- Choose a datacenter region nearest your audience, for example, `Frankfurt`.
+- Select additional options:`[x] IPv6`
+- Add your SSH key **NOTE:** We recommend adding your SSH key
+  - Copy to your clipboard, your existing SSH public key with `pbcopy < ~/.ssh/id_rsa.pub`.
+  - Click on `New SSH Key` and paste in your `SSH Key`. Name this key and Save.
+    Additional instructions on creating and using SSH Keys can be found [here](https://www.digitalocean.com/docs/droplets/how-to/add-ssh-keys/create-with-openssh/).
+- `Choose a hostname` or leave as-is.
+- Click the green `Create` button.
+
+You may continue after **Digital Ocean** has finished created your **Droplet** as indicated by the progress bar.
+
 ## Heroku
 
-This is a step-by-step guide for deploying a Strapi project on [Heroku](https://www.heroku.com/). Databases that work well with Strapi and Heroku are provided instructions on how to get started.
+This is a step-by-step guide for deploying a Strapi project to [Heroku](https://www.heroku.com/). Databases that work well with Strapi and Heroku are provided instructions on how to get started.
 
 ### Heroku Install Requirements
 
@@ -108,6 +139,7 @@ Also available via Homebrew:
 ```bash
 brew tap heroku/brew && brew install heroku
 ```
+
 :::
 
 ::: tab "Ubuntu"
@@ -116,6 +148,7 @@ Run the following from your terminal:
 ```bash
 sudo snap install --classic heroku
 ```
+
 :::
 
 ::: tab "Windows"
@@ -200,6 +233,7 @@ If you have a Heroku project app already created. You would use the following st
 ```bash
 heroku git:remote -a your-heroku-app-name
 ```
+
 :::
 
 Your local development environment is now set-up and configured to work with Heroku. You have a new Strapi project and a new Heroku app ready to be configured to work with a database and with each other.
@@ -238,7 +272,7 @@ heroku config
 
 This should print something like this: `DATABASE_URL: postgres://ebitxebvixeeqd:dc59b16dedb3a1eef84d4999sb4baf@ec2-50-37-231-192.compute-2.amazonaws.com: 5432/d516fp1u21ph7b`.
 
-(This url is read like so: *postgres:// **USERNAME** : **PASSWORD** @ **HOST** : **PORT** : **DATABASE_NAME***)
+(This url is read like so: \*postgres:// **USERNAME** : **PASSWORD** @ **HOST** : **PORT** : **DATABASE_NAME\***)
 
 ##### 3. Set environment variables
 
@@ -286,6 +320,7 @@ Replace the contents of `database.json` with the following:
 Unless you originally installed Strapi with PostgreSQL, you need to install the [pg](https://www.npmjs.com/package/pg) node module.
 
 `Path: ./my-project/`
+
 ```bash
 npm install pg --save
 ```
@@ -302,7 +337,6 @@ Please follow these steps the **deploy a Strapi app with MongoDB on Heroku**.
 
 You must have completed the [steps to use Strapi with MongoDB Atlas in production](/3.x.x/guides/databases.html#install-on-atlas-mongodb-atlas).
 
-
 ##### 1. Set environment variables
 
 When you [set-up your MongoDB Atlas database](/3.x.x/guides/databases.html#install-on-atlas-mongodb-atlas) you created and noted the five key/value pairs that correspond to your **MongoDB Atlas** database. These five keys are: `DATABASE_NAME`, `DATABASE_USERNAME`, `DATABASE_PASSWORD`, `DATABASE PORT`, and `DATABASE_HOST`.
@@ -316,6 +350,7 @@ heroku config:set DATABASE_HOST="stapi-mongo-heroku-shard-00-00-fty6c.mongodb.ne
 heroku config:set DATABASE_PORT=
 heroku config:set DATABASE_NAME=strapi-mongo-heroku
 ```
+
 **Note:** Please replace these above values with the your actual values.
 
 ##### 2. Update your database config file

docs/package-lock.json

@@ -4220,7 +4220,8 @@
         },
         "ansi-regex": {
           "version": "2.1.1",
-          "bundled": true
+          "bundled": true,
+          "optional": true
         },
         "aproba": {
           "version": "1.2.0",
@@ -4238,11 +4239,13 @@
         },
         "balanced-match": {
           "version": "1.0.0",
-          "bundled": true
+          "bundled": true,
+          "optional": true
         },
         "brace-expansion": {
           "version": "1.1.11",
           "bundled": true,
+          "optional": true,
           "requires": {
             "balanced-match": "^1.0.0",
             "concat-map": "0.0.1"
@@ -4255,15 +4258,18 @@
         },
         "code-point-at": {
           "version": "1.1.0",
-          "bundled": true
+          "bundled": true,
+          "optional": true
         },
         "concat-map": {
           "version": "0.0.1",
-          "bundled": true
+          "bundled": true,
+          "optional": true
         },
         "console-control-strings": {
           "version": "1.1.0",
-          "bundled": true
+          "bundled": true,
+          "optional": true
         },
         "core-util-is": {
           "version": "1.0.2",
@@ -4366,7 +4372,8 @@
         },
         "inherits": {
           "version": "2.0.3",
-          "bundled": true
+          "bundled": true,
+          "optional": true
         },
         "ini": {
           "version": "1.3.5",
@@ -4376,6 +4383,7 @@
         "is-fullwidth-code-point": {
           "version": "1.0.0",
           "bundled": true,
+          "optional": true,
           "requires": {
             "number-is-nan": "^1.0.0"
           }
@@ -4388,17 +4396,20 @@
         "minimatch": {
           "version": "3.0.4",
           "bundled": true,
+          "optional": true,
           "requires": {
             "brace-expansion": "^1.1.7"
           }
         },
         "minimist": {
           "version": "0.0.8",
-          "bundled": true
+          "bundled": true,
+          "optional": true
         },
         "minipass": {
           "version": "2.3.5",
           "bundled": true,
+          "optional": true,
           "requires": {
             "safe-buffer": "^5.1.2",
             "yallist": "^3.0.0"
@@ -4415,6 +4426,7 @@
         "mkdirp": {
           "version": "0.5.1",
           "bundled": true,
+          "optional": true,
           "requires": {
             "minimist": "0.0.8"
           }
@@ -4487,7 +4499,8 @@
         },
         "number-is-nan": {
           "version": "1.0.1",
-          "bundled": true
+          "bundled": true,
+          "optional": true
         },
         "object-assign": {
           "version": "4.1.1",
@@ -4497,6 +4510,7 @@
         "once": {
           "version": "1.4.0",
           "bundled": true,
+          "optional": true,
           "requires": {
             "wrappy": "1"
           }
@@ -4572,7 +4586,8 @@
         },
         "safe-buffer": {
           "version": "5.1.2",
-          "bundled": true
+          "bundled": true,
+          "optional": true
         },
         "safer-buffer": {
           "version": "2.1.2",
@@ -4602,6 +4617,7 @@
         "string-width": {
           "version": "1.0.2",
           "bundled": true,
+          "optional": true,
           "requires": {
             "code-point-at": "^1.0.0",
             "is-fullwidth-code-point": "^1.0.0",
@@ -4619,6 +4635,7 @@
         "strip-ansi": {
           "version": "3.0.1",
           "bundled": true,
+          "optional": true,
           "requires": {
             "ansi-regex": "^2.0.0"
           }
@@ -4657,11 +4674,13 @@
         },
         "wrappy": {
           "version": "1.0.2",
-          "bundled": true
+          "bundled": true,
+          "optional": true
         },
         "yallist": {
           "version": "3.0.3",
-          "bundled": true
+          "bundled": true,
+          "optional": true
         }
       }
     },