Merge pull request #742 from winfried-van-loon/patch-1

Updating the DigitalOcean guide
This commit is contained in:
Mahmoud Zalt 2017-04-04 20:47:52 -04:00 committed by GitHub
commit 18b38db037
1 changed files with 83 additions and 80 deletions

View File

@ -1,112 +1,118 @@
#### Install Docker #### Install Docker
```
Login Digital Ocean - Visit [DigitalOcean](https://cloud.digitalocean.com/login) and login.
Add Droplet - Click the `Create Droplet` button.
1 Click Install docker - Open the `One-click apps` tab.
Choose Droplet - Select Docker with your preferred version.
reset ROOT password - Continue creating the droplet as you normally would.
check email - If needed, check your e-mail for the droplet root password.
```
#### SSH to your Server #### SSH to your Server
Find the IP address of the droplet in the DigitalOcean interface. Use it to connect to the server.
``` ```
ssh root@ipaddress ssh root@ipaddress
``` ```
you will be prompt of that password.
type the password you receive in your email
then it will ask to you to change a new password You may be prompted for a password. Type the one you found within your e-mailbox. It'll then ask you to change the password.
just change it to the custom root password you want
After SSH You can now check if Docker is available:
you can check that docker command is working by typing
``` ```
$root@midascode:~# docker $root@server:~# docker
``` ```
#### Set Up Your Laravel Project #### Set Up Your Laravel Project
``` ```
$root@midascode:~# apt-get install git $root@server:~# apt-get install git
$root@midascode:~# git clone https://github.com/laravel/laravel $root@server:~# git clone https://github.com/laravel/laravel
$root@midascode:~# cd laravel $root@server:~# cd laravel
$root@midascode:~/laravel/ git submodule add https://github.com/LaraDock/laradock.git $root@server:~/laravel/ git submodule add https://github.com/LaraDock/laradock.git
$root@midascode:~/laravel/ cd laradock $root@server:~/laravel/ cd laradock
``` ```
#### Install docker-compose command #### Install docker-compose command
``` ```
$root@midascode:~/laravel/laradock# curl -L https://github.com/docker/compose/releases/download/1.8.0/run.sh > /usr/local/bin/docker-compose $root@server:~/laravel/laradock# curl -L https://github.com/docker/compose/releases/download/1.8.0/run.sh > /usr/local/bin/docker-compose
$root@midascode:~/chmod +x /usr/local/bin/docker-compose $root@server:~/chmod +x /usr/local/bin/docker-compose
``` ```
#### Create Your LaraDock Containers #### Create Your LaraDock Containers
``` ```
$root@midascode:~/laravel/laradock# docker-compose up -d nginx mysql $root@server:~/laravel/laradock# docker-compose up -d nginx mysql
``` ```
Note that more containers are available, find them in the [docs](http://laradock.io/introduction/#supported-software-containers) or the `docker-compose.yml` file.
#### Go to Your Workspace #### Go to Your Workspace
``` ```
docker-compose exec workspace bash docker-compose exec workspace bash
``` ```
#### Install laravel Dependencies, Add .env , generate Key and give proper permission certain folder #### Install and configure Laravel
Let's install Laravel's dependencies, add the `.env` file, generate the key and give proper permissions to the cache folder.
``` ```
$ root@0e77851d27d3:/var/www# composer install $ root@workspace:/var/www# composer install
$ root@0e77851d27d3:/var/www# cp .env.example .env $ root@workspace:/var/www# cp .env.example .env
$ root@0e77851d27d3:/var/www# php artisan key:generate $ root@workspace:/var/www# php artisan key:generate
$ root@0e77851d27d3:/var/www# exit $ root@workspace:/var/www# exit
$root@midascode:~/laravel/laradock# cd .. $root@server:~/laravel/laradock# cd ..
$root@midascode:~/laravel# sudo chmod -R 777 storage bootstrap/cache $root@server:~/laravel# sudo chmod -R 777 storage bootstrap/cache
``` ```
you can then view your laravel site at your ipaddress You can then view your Laravel site by visiting the IP address of your server in your browser. For example:
for example
``` ```
192.168.1.1 http://192.168.1.1
``` ```
You will see there Laravel Default Welcome Page It should show you the Laravel default welcome page.
but if you need to view on your custom domain name However, we want it to show up using your custom domain name, as well.
which you would.
#### Using Your Own Domain Name #### Using Your Own Domain Name
login to your DNS provider
Godaddy, Namecheap what ever... Login to your DNS provider, such as Godaddy, Namecheap.
And Point the Custom Domain Name Server to
Point the Custom Domain Name Server to:
``` ```
ns1.digitalocean.com ns1.digitalocean.com
ns2.digitalocean.com ns2.digitalocean.com
ns3.digitalocean.com ns3.digitalocean.com
``` ```
In Your Digital Ocean Account go to
```
https://cloud.digitalocean.com/networking/domains
```
add your domain name and choose the server ip you provision earlier
#### Serve Site With NGINX (HTTP ONLY) Within DigitalOcean, you'll need to change some settings, too.
Go back to command line
Visit: https://cloud.digitalocean.com/networking/domains
Add your domain name and choose the server IP you'd provision earlier.
#### Serving Site With NGINX (HTTP ONLY)
Go back to command line.
``` ```
$root@midascode:~/laravel/laradock# cd nginx $root@server:~/laravel/laradock# cd nginx
$root@midascode:~/laravel/laradock/nginx# vim laravel.conf $root@server:~/laravel/laradock/nginx# vim laravel.conf
```
remove default_server
``` ```
Remove `default_server`
```
listen 80 default_server; listen 80 default_server;
listen [::]:80 default_server ipv6only=on; listen [::]:80 default_server ipv6only=on;
``` ```
and add server_name (your custom domain)
And add `server_name` (your custom domain)
``` ```
listen 80; listen 80;
listen [::]:80 ipv6only=on; listen [::]:80 ipv6only=on;
@ -114,27 +120,29 @@ remove default_server
``` ```
#### Rebuild Your Nginx #### Rebuild Your Nginx
``` ```
$root@midascode:~/laravel/laradock/nginx# docker-compose down $root@server:~/laravel/laradock/nginx# docker-compose down
$root@midascode:~/laravel/laradock/nginx# docker-compose build nginx $root@server:~/laravel/laradock/nginx# docker-compose build nginx
``` ```
#### Re Run Your Containers MYSQL and NGINX #### Re Run Your Containers MYSQL and NGINX
``` ```
$root@midascode:~/laravel/laradock/nginx# docker-compose up -d nginx mysql $root@server:~/laravel/laradock/nginx# docker-compose up -d nginx mysql
``` ```
###### View Your Site with HTTP ONLY (http://yourdomain.com) **View Your Site with HTTP ONLY (http://yourdomain.com)**
#### Run Site on SSL with Let's Encrypt Certificate #### Run Site on SSL with Let's Encrypt Certificate
###### Note: You need to Use Caddy here Instead of Nginx **Note: You need to Use Caddy here Instead of Nginx**
###### To go Caddy Folders and Edit CaddyFile To go Caddy Folders and Edit CaddyFile
``` ```
$root@midascode:~/laravel/laradock# cd caddy $root@server:~/laravel/laradock# cd caddy
$root@midascode:~/laravel/laradock/caddy# vim Caddyfile $root@server:~/laravel/laradock/caddy# vim Caddyfile
``` ```
Remove 0.0.0.0:80 Remove 0.0.0.0:80
@ -143,31 +151,36 @@ Remove 0.0.0.0:80
0.0.0.0:80 0.0.0.0:80
root /var/www/public root /var/www/public
``` ```
and replace with your https://yourdomain.com and replace with your https://yourdomain.com
``` ```
https://yourdomain.com https://yourdomain.com
root /var/www/public root /var/www/public
``` ```
uncomment tls uncomment tls
``` ```
#tls self-signed #tls self-signed
``` ```
and replace self-signed with your email address and replace self-signed with your email address
``` ```
tls midascodebreaker@gmai.com tls serverbreaker@gmai.com
``` ```
This is needed Prior to Creating Let's Encypt This is needed Prior to Creating Let's Encypt
#### Run Your Caddy Container without the -d flag and Generate SSL with Let's Encrypt #### Run Your Caddy Container without the -d flag and Generate SSL with Let's Encrypt
``` ```
$root@midascode:~/laravel/laradock/caddy# docker-compose up caddy $root@server:~/laravel/laradock/caddy# docker-compose up caddy
``` ```
you will be prompt here to enter your email... you may enter it or not You'll be prompt here to enter your email... you may enter it or not
``` ```
Attaching to laradock_mysql_1, laradock_caddy_1 Attaching to laradock_mysql_1, laradock_caddy_1
caddy_1 | Activating privacy features... caddy_1 | Activating privacy features...
@ -179,17 +192,18 @@ caddy_1 | https://yourdomain.com
caddy_1 | http://yourdomain.com caddy_1 | http://yourdomain.com
``` ```
After it finish Press Ctrl + C to exit ... After it finishes, press `Ctrl` + `C` to exit.
#### Stop All Containers and ReRun Caddy and Other Containers on Background #### Stop All Containers and ReRun Caddy and Other Containers on Background
``` ```
$root@midascode:~/laravel/laradock/caddy# docker-compose down $root@server:~/laravel/laradock/caddy# docker-compose down
$root@midascode:~/laravel/laradock/caddy# docker-compose up -d mysql caddy $root@server:~/laravel/laradock/caddy# docker-compose up -d mysql caddy
``` ```
View your Site in the Browser Securely Using HTTPS (https://yourdomain.com) View your Site in the Browser Securely Using HTTPS (https://yourdomain.com)
##### Note that Certificate will be Automatically Renew By Caddy **Note that Certificate will be Automatically Renew By Caddy**
>References: >References:
> >
@ -200,14 +214,3 @@ View your Site in the Browser Securely Using HTTPS (https://yourdomain.com)
- [https://caddyserver.com/docs/automatic-https](https://caddyserver.com/docs/automatic-https) - [https://caddyserver.com/docs/automatic-https](https://caddyserver.com/docs/automatic-https)
- [https://caddyserver.com/docs/tls](https://caddyserver.com/docs/tls) - [https://caddyserver.com/docs/tls](https://caddyserver.com/docs/tls)
- [https://caddyserver.com/docs/caddyfile](https://caddyserver.com/docs/caddyfile) - [https://caddyserver.com/docs/caddyfile](https://caddyserver.com/docs/caddyfile)