update the doc to support multiple projects
This commit is contained in:
parent
dbee864d44
commit
66723c0278
69
README.md
69
README.md
@ -207,17 +207,22 @@ What's better than a **Demo Video**:
|
|||||||
<a name="Installation"></a>
|
<a name="Installation"></a>
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
|
Choose the setup the best suits your needs.
|
||||||
|
|
||||||
Clone the `LaraDock` repository:
|
#### A) Setup for Single Project:
|
||||||
|
*(In case you want a Docker environment for each project)*
|
||||||
|
|
||||||
**A)** If you already have a Laravel project, clone this repository on your `Laravel` root directory:
|
##### A.1) Setup environment in existing Project:
|
||||||
|
*(In case you already have a project, and you want to setup an environemnt to run it)*
|
||||||
|
|
||||||
|
1 - Clone this repository on your project root directory:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git submodule add https://github.com/LaraDock/laradock.git
|
git submodule add https://github.com/LaraDock/laradock.git
|
||||||
```
|
```
|
||||||
>If you are not already using Git for your Laravel project, you can use `git clone` instead of `git submodule`.
|
>If you are not already using Git for your PHP project, you can use `git clone` instead of `git submodule`.
|
||||||
|
|
||||||
Note: In this case the folder structure will be like this (recommended):
|
Note: In this case the folder structure will be like this:
|
||||||
|
|
||||||
```
|
```
|
||||||
- project1
|
- project1
|
||||||
@ -226,9 +231,10 @@ Note: In this case the folder structure will be like this (recommended):
|
|||||||
- laradock
|
- laradock
|
||||||
```
|
```
|
||||||
|
|
||||||
<br>
|
##### A.2) Setup environment first then create project:
|
||||||
|
*(In case you don't have a project, and you want to create your project inside the Docker environment)*
|
||||||
|
|
||||||
**B)** If you don't have a Laravel project, and you want to install Laravel from Docker, clone this repo anywhere on your machine:
|
1 - Clone this repository anywhere on your machine:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone https://github.com/LaraDock/laradock.git
|
git clone https://github.com/LaraDock/laradock.git
|
||||||
@ -238,11 +244,54 @@ Note: In this case the folder structure will be like this:
|
|||||||
```
|
```
|
||||||
- projects
|
- projects
|
||||||
- laradock
|
- laradock
|
||||||
- project1
|
- myProject
|
||||||
- project2
|
|
||||||
```
|
```
|
||||||
|
|
||||||
**Note:** if you are using this folder structure don't forget to edit the `docker-compose.yml` file to map to your Laravel directory once you have it (example: `- ../project1/:/var/www/laravel`). "You will need to stop and re-run your docker-compose command for the changes to take place".
|
2 - Edit the `docker-compose.yml` file to map to your project directory once you have it (example: `- ../myProject:/var/www`).
|
||||||
|
|
||||||
|
3 - Stop and re-run your docker-compose command for the changes to take place.
|
||||||
|
|
||||||
|
```
|
||||||
|
docker-compose stop && docker-compose up -d XXXX YYYY ZZZZ ....
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
#### B) Setup for Multiple Projects:
|
||||||
|
|
||||||
|
1 - Clone this repository anywhere on your machine:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone https://github.com/LaraDock/laradock.git
|
||||||
|
```
|
||||||
|
|
||||||
|
2 - Edit the `docker-compose.yml` file to map to your projects directories:
|
||||||
|
|
||||||
|
```
|
||||||
|
volumes_source:
|
||||||
|
image: tianon/true
|
||||||
|
volumes:
|
||||||
|
- ../project1/:/var/www/project1
|
||||||
|
- ../project2/:/var/www/project2
|
||||||
|
```
|
||||||
|
|
||||||
|
3 - You can access all sites by visiting `http://localhost/project1/public` and `http://localhost/project2/public` but of course that's not very useful so let's setup nginx quickly.
|
||||||
|
|
||||||
|
|
||||||
|
4 - Go to `nginx/sites` and copy `sample.conf.example` to `project1.conf` then to `project2.conf`
|
||||||
|
|
||||||
|
5 - Open the `project1.conf` file and edit the `server_name` and the `root` as follow:
|
||||||
|
|
||||||
|
```
|
||||||
|
server_name project1.dev;
|
||||||
|
root /var/www/project1/public;
|
||||||
|
```
|
||||||
|
Do the same for each project `project2.conf`, `project3.conf`,...
|
||||||
|
|
||||||
|
6 - Create your project Databases **To Be Continue..**
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<a name="Usage"></a>
|
<a name="Usage"></a>
|
||||||
## Usage
|
## Usage
|
||||||
@ -306,7 +355,7 @@ Open your `.env` file and set the `DB_HOST` to `mysql`:
|
|||||||
DB_HOST=mysql
|
DB_HOST=mysql
|
||||||
```
|
```
|
||||||
|
|
||||||
*If you are using Laravel and you don't have it installed yet, see [How to Install Laravel in a Docker Container](#Install-Laravel).*
|
*If you want to use Laravel and you don't have it installed yet, see [How to Install Laravel in a Docker Container](#Install-Laravel).*
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user