arina-ielchiieva commented on a change in pull request #1348: DRILL-6346: 
Create an Official Drill Docker Container
URL: https://github.com/apache/drill/pull/1348#discussion_r202019289
 
 

 ##########
 File path: docs/dev/Docker.md
 ##########
 @@ -0,0 +1,73 @@
+# How to build, publish and run a Apache Drill Docker image
+
+## Prerequisites
+
+To build an Apache Drill docker image, you need to have the following software 
installed on your system to successfully complete a build. 
+  * Java 8
+  * Maven 3.3.1 or greater
+  * Docker 18 or greater
+
+## Checkout
+
+`git clone https://github.com/apache/drill.git`
+    
+## Build Drill
+```
+$ cd drill
+$ mvn clean install
+```   
+## Build Docker Image
+```
+$ cd distribution
+$ mvn dockerfile:build -Pdocker
+```
+
+## Push Docker Image
+   
+   By default, the image built above is configured to be pushed to [Drill 
Docker Hub](https://hub.docker.com/r/drill/apache-drill/) to create official 
Drill Docker images. 
+```   
+$ cd distribution
+$ mvn dockerfile:push -Pdocker
+```    
+  You can configure the repository in pom.xml to point to any private or 
public container registry, or specify it in your mvn command:
+```  
+$ cd distribution
+$ mvn dockerfile:push -Pdocker -Pdocker.repository=<my_repo>
+```
+## Run Docker Container
+   
+   Running the Docker container should start Drill in embedded mode and 
connect to Sqlline
+```    
+$ docker run -i -t drill/apache-drill:1.14.0 /bin/bash
 
 Review comment:
   Please add the following clarifications:
   1. Detach: When starting this way (without detach), once you exit the 
sqline, container will be also killed. To persist the container use `--detach`: 
`docker run -i --detach -t drill/apache-drill:1.14.0 /bin/bash /bin/bash`.
   2. Port forwarding: In order to access Drill WebUI you need to open 8047 
port: `docker run -i -p 8047:8047 -t drill/apache-drill:1.14.0 /bin/bash`.
   3. Name: Suggest optionally to add name to the container (`--name drill`): 
`docker run --name drill -i -p 8047:8047 -t drill/apache-drill:1.14.0 
/bin/bash`.
   4. Docker machine: On Windows and Mac default docker machine might not have 
enough resources.
   On my env I had to create new docker machine. Example:
   ```
   # stop default
   docker-machine stop default
   # add drill-machine
   docker-machine create -d virtualbox --virtualbox-cpu-count "2" 
--virtualbox-memory "16384" drill-machine
   # activate drill-machine
   eval $(docker-machine env drill-machine)
   # check status
   docker-machine active
   ```
   5. Querying custom files: To query custom files (which I believe will be the 
major use case), user needs to mount a volume 
(https://docs.docker.com/storage/volumes/) and then update file storage plugin 
to look at that volume. I did not try that but it's worth mentioning and even 
adding a simple manual.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


With regards,
Apache Git Services

Reply via email to