mirror of
https://github.com/frappe/frappe_docker.git
synced 2024-11-08 14:21:05 +00:00
Merge pull request #5 from vishalseshagiri/master
merge with master
Former-commit-id: 4fd5633745
This commit is contained in:
commit
70b80f9018
61
README.md
61
README.md
@ -1,6 +1,7 @@
|
|||||||
# frappe_docker
|
# frappe_docker
|
||||||
|
|
||||||
Containerizing the frappe bench installation for a development environment
|
* Docker Compose file to run frappe in a container
|
||||||
|
* Docker makes it much easier to deploy [frappe](https://github.com/frappe/frappe) on your development servers.
|
||||||
|
|
||||||
## Getting Started
|
## Getting Started
|
||||||
|
|
||||||
@ -10,29 +11,67 @@ These instructions will get you a copy of the project up and running on your loc
|
|||||||
|
|
||||||
What things you need to install the software and how to install them
|
What things you need to install the software and how to install them
|
||||||
|
|
||||||
|
[Docker](https://www.docker.com/)
|
||||||
|
|
||||||
|
[Docker Compose](https://docs.docker.com/compose/overview/)
|
||||||
|
|
||||||
|
### Container Configuration
|
||||||
|
|
||||||
|
#### ports:
|
||||||
|
|
||||||
```
|
```
|
||||||
Docker
|
ports:
|
||||||
docker-compose
|
- "3306:3306"
|
||||||
|
- "8000:8000"
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Expose port 3306 inside the container on port 3306 on ALL local host interfaces. In order to bind to only one interface, you may specify the host's IP address as `([<host_interface>:[host_port]])|(<host_port>):<container_port>[/udp]` as defined in the [docker port binding documentation](http://docs.docker.com/userguide/dockerlinks/)
|
||||||
|
|
||||||
|
#### volumes:
|
||||||
|
|
||||||
|
```
|
||||||
|
volumes:
|
||||||
|
- ./frappe:/home/frappe
|
||||||
|
- ./conf/mariadb-conf.d:/etc/mysql/conf.d
|
||||||
|
```
|
||||||
|
Expose a directory inside the host to the container.
|
||||||
|
|
||||||
|
#### links:
|
||||||
|
|
||||||
|
```
|
||||||
|
links:
|
||||||
|
- redis
|
||||||
|
- mariadb
|
||||||
|
```
|
||||||
|
|
||||||
|
Links another container to the current container. This will add `--link docker_frappe:mariadb` and `--link docker_frappe:redis` to the options when running the container.
|
||||||
|
|
||||||
|
#### depends_on:
|
||||||
|
|
||||||
|
```
|
||||||
|
depends_on:
|
||||||
|
- mariadb
|
||||||
|
- redis
|
||||||
|
```
|
||||||
|
Express dependency between services, which has two effects:
|
||||||
|
|
||||||
|
1. docker-compose up will start services in dependency order. In the following example, db and redis will be started before web.
|
||||||
|
|
||||||
|
2. docker-compose up SERVICE will automatically include SERVICE’s dependencies. In the following example, docker-compose up web will also create and start db and redis.
|
||||||
|
|
||||||
### Installing
|
### Installing
|
||||||
|
|
||||||
A step by step series of examples that tell you have to get a development env running
|
A step by step series of examples that tell you have to get a development env running
|
||||||
#### 1. Installation Pre-requisites
|
#### 1. Installation Pre-requisites
|
||||||
|
|
||||||
- Installing Docker Community Edition
|
- Installing Docker Community Edition (version 17.06.0-ce)
|
||||||
|
|
||||||
Follow the steps given in [here](https://docs.docker.com/engine/installation)
|
Follow the steps given in [here](https://docs.docker.com/engine/installation)
|
||||||
|
|
||||||
Docker version 17.06.0-ce, build 02c1d87
|
- Installing docker-compose(only for Linux users).Docker for Mac, Docker for Windows, and Docker Toolbox include Docker Compose (version 1.14.0)
|
||||||
|
|
||||||
- Installing docker-compose(only for Linux users).Docker for Mac, Docker for Windows, and Docker Toolbox include Docker Compose
|
|
||||||
|
|
||||||
|
|
||||||
Follow the steps given in [here](https://docs.docker.com/compose/install/)
|
Follow the steps given in [here](https://docs.docker.com/compose/install/)
|
||||||
|
|
||||||
docker-compose version 1.14.0, build c7bdf9e
|
|
||||||
|
|
||||||
#### 2. Build the container and install bench
|
#### 2. Build the container and install bench
|
||||||
|
|
||||||
* Make sure your logged in as root. Build the container and install bench inside the container as a **non root** user
|
* Make sure your logged in as root. Build the container and install bench inside the container as a **non root** user
|
||||||
@ -115,7 +154,7 @@ A step by step series of examples that tell you have to get a development env ru
|
|||||||
|
|
||||||
To login to Frappe / ERPNext, open your browser and go to `[your-external-ip]:8000`, probably `localhost:8000`
|
To login to Frappe / ERPNext, open your browser and go to `[your-external-ip]:8000`, probably `localhost:8000`
|
||||||
|
|
||||||
The default username is "Administrator" and password is what you set when you created the new site.
|
The default username is "Administrator" and password is what you set when you created the new site.
|
||||||
|
|
||||||
## Built With
|
## Built With
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user