Skip to content

Commit

Permalink
Update README for Docker
Browse files Browse the repository at this point in the history
  • Loading branch information
chethanuk authored and electrum committed Oct 9, 2019
1 parent 774fab9 commit f6d91f0
Showing 1 changed file with 52 additions and 0 deletions.
52 changes: 52 additions & 0 deletions docker/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,40 @@ This Docker image is designed to provide the following
* An image that can be deployed as a full cluster by mounting in configuration
* An image to be used as the basis for the Kubernetes Presto operator

## Quickstart

### Run the Presto server

You can launch a single node Presto cluster for testing purposes.
The Presto node will function both as a coordinator and a worker.
To launch it, execute the following:

```bash
docker run -p 8080:8080 --name presto prestosql/presto
```

Wait for the following message log line:
```
INFO main io.prestosql.server.PrestoServer ======== SERVER STARTED ========
```

The Presto server is now running on `localhost:8080` (the default port).

### Run the Presto CLI

Run the [Presto CLI](https://prestosql.io/docs/current/installation/cli.html),
which connects to `localhost:8080` by default:

```bash
docker exec -it presto presto
```

You can pass additional arguments to the Presto CLI:

```bash
docker exec -it presto presto --catalog tpch --schema sf1
```

## Configuration

Configuration is expected to be mounted to either to `/etc/presto` or
Expand All @@ -26,3 +60,21 @@ across all worker nodes if desired. Additionally this has the added benefit of
The default configuration uses `/data/presto` as the default for
`node.data-dir`. Thus if using the default configuration and a mounted volume
is desired for the data directory it should be mounted to `/data/presto`.

## Building a custom Docker image

To build an image for a locally modified version of Presto, run the Maven
build as normal for the `presto-server` and `presto-cli` modules, then
build the image:

```bash
./build-local.sh
```

The Docker build process will print the ID of the image, which will also
be tagged with `presto:xxx-SNAPSHOT`, where `xxx-SNAPSHOT` is the version
number of the Presto Maven build.

## Getting Help

Join the Presto community [Slack](https://prestosql.io/slack.html).

0 comments on commit f6d91f0

Please sign in to comment.