https://github.com/prestodb/presto-admin

A tool to install, configure and manage Presto installations
https://github.com/prestodb/presto-admin

Last synced: about 1 month ago
JSON representation

A tool to install, configure and manage Presto installations

• Host: GitHub
• URL: https://github.com/prestodb/presto-admin
• Owner: prestodb
• License: apache-2.0
• Created: 2015-05-22T03:40:42.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2022-12-27T14:55:35.000Z (almost 2 years ago)
• Last Synced: 2024-04-16T07:20:18.755Z (8 months ago)
• Language: Python
• Homepage: http://prestodb.github.io/presto-admin/
• Size: 38.7 MB
• Stars: 170
• Watchers: 35
• Forks: 101
• Open Issues: 64
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
# presto-admin [![Build Status](https://travis-ci.org/prestodb/presto-admin.svg?branch=master)](https://travis-ci.org/prestodb/presto-admin)

presto-admin installs, configures, and manages Presto installations.

Comprehensive documentation can be found [here](http://prestodb.github.io/presto-admin/).

## Requirements

1. Python 2.6 or 2.7

2. [Docker](https://www.docker.com/). (Only required for development, if you want to run the system tests)

    * If you DO NOT have Docker already installed, you can run the `install-docker.sh`

      script in the `bin` directory of this project. That script has only been tested on

      Ubuntu 14.04.

    * If you have Docker already installed, you need to make sure that your user has

      been added to the docker group. This will enable you to run commands without `sudo`,

      which is a requirement for some of the unit tests. To enable sudoless docker access

      run the following:

            $ sudo groupadd docker

            $ sudo gpasswd -a ${USER} docker

            $ sudo service docker restart

      If the user you added to the docker group is the same one you're logged in as, you will

      need to log out and back in so that the changes can take effect.

## Building

Presto-admin makes use of `make` as its build tool. `make` in turn calls out to various utilities (e.g.

`tox`, `flake8`, `sphinx-apidoc`, `python`) in order to perform the requested actions.

In order to get started with `presto-admin`,

1. Fork the `presto-admin` repo on GitHub, https://github.com/prestodb/presto-admin.

2. Clone your fork locally ::

        $ git clone [email protected]:your_name_here/presto-admin.git

3. Install your local copy into a virtualenv. Assuming you have virtualenvwrapper installed, this is how you set up your fork for local development ::

        $ mkvirtualenv prestoadmin

        $ cd prestoadmin/

        $ python setup.py develop

4. Create a branch for local development ::

        $ git checkout -b name-of-your-bugfix-or-feature

     Now you can make your changes locally.

5. When you're done making changes, check that your changes pass `make clean lint test`, which runs flake8 and the unit tests (which test both Python 2.6 and 2.7).

To run the product tests tests (`make test-all`), you need docker installed. You may also need to run `pip install wheel` in your virtualenv. To install and start docker use ::

        $ wget -qO- https://get.docker.com/ | sh

        # Add current user to Docker group to run without sudo

        $ sudo gpasswd -a ${USER} docker

        $ sudo service docker restart

### Building the installer

The two tasks used to build the presto-admin installer are `dist` and

`dist-offline`. The `dist` task builds an installer that requires internet

connectivity during installation. The `dist-offline` task builds an installer

that does not require internet connectivity during installation. Instead the

offline installer downloads all dependencies at build time and points `pip` to

those dependencies during installation.

## License

Free software: Apache License Version 2.0 (APLv2).