Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/apache/ranger

Apache Ranger - To enable, monitor and manage comprehensive data security across the Hadoop platform and beyond
https://github.com/apache/ranger

apache authz docker java python ranger

Last synced: 12 days ago
JSON representation

Apache Ranger - To enable, monitor and manage comprehensive data security across the Hadoop platform and beyond

Host: GitHub
URL: https://github.com/apache/ranger
Owner: apache
License: apache-2.0
Created: 2014-07-27T07:00:08.000Z (over 10 years ago)
Default Branch: master
Last Pushed: 2024-10-28T10:21:42.000Z (13 days ago)
Last Synced: 2024-10-28T13:44:04.534Z (13 days ago)
Topics: apache, authz, docker, java, python, ranger
Language: Java
Homepage: https://ranger.apache.org
Size: 113 MB
Stars: 904
Watchers: 74
Forks: 970
Open Issues: 165
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
- Security: security-admin/.gitignore

Awesome Lists containing this project

awesome-datalake - Apache Ranger - To enable, monitor and manage comprehensive data security across the Hadoop platform and beyond. (Security)
awesome-datalake - Apache Ranger - To enable, monitor and manage comprehensive data security across the Hadoop platform and beyond. (Security)

README

# Apache Ranger

[![License](https://img.shields.io/:license-Apache%202-green.svg)](https://www.apache.org/licenses/LICENSE-2.0.txt)
[![PyPI Downloads](https://static.pepy.tech/personalized-badge/apache-ranger?period=month&units=international_system&left_color=black&right_color=orange&left_text=PyPI%20downloads)](https://pypi.org/project/apache-ranger/)
[![Documentation](https://img.shields.io/badge/docs-apache.org-blue.svg)](https://ranger.apache.org)
[![Wiki](https://img.shields.io/badge/ranger-wiki-orange)](https://cwiki.apache.org/confluence/display/RANGER/Index)

#### NOTE
Apache Ranger allows contributions via pull requests (PRs) on GitHub.
Alternatively, use [this](https://reviews.apache.org) to submit changes for review using the Review Board.
Also create a [ranger jira](https://issues.apache.org/jira/browse/RANGER) to go along with the review and mention it in the review board review.

## Building Ranger in Docker (Sandbox Install)

Ranger is built using [Apache Maven](https://maven.apache.org/). To run Ranger:

1. Check out the code from GIT [repository](https://github.com/apache/ranger.git)

2. Ensure that docker & docker-compose is installed and running on your system.

3. Ensure that JDK 1.8+ is installed on your system.

4. Ensure that Apache Maven is installed on your system.

5. Run the following command to build & run Ranger from Docker

`./ranger_in_docker up`

6. After successful completion of the above command, you should be able to view Ranger Admin Console by using URL:
```
http://:6080/

UserName: admin
Password: rangerR0cks!
```

## Regular Build Process

1. Check out the code from GIT repository

2. On the root folder, please execute the following Maven command:

`mvn clean compile package install`

`mvn eclipse:eclipse`

Ranger Admin UI tests depend on PhantomJS. If the build fails with npm or Karma errors you can either:
- install PhantomJS dependencies for your platform (bzip2 and fontconfig)
- skip JavaScript test execution: mvn -DskipJSTests ...

3. After the above build command execution, you should see the following TAR files in the target folder:
```
ranger--admin.tar.gz
ranger--atlas-plugin.tar.gz
ranger--hbase-plugin.tar.gz
ranger--hdfs-plugin.tar.gz
ranger--hive-plugin.tar.gz
ranger--kafka-plugin.tar.gz
ranger--kms.tar.gz
ranger--knox-plugin.tar.gz
ranger--migration-util.tar.gz
ranger--ranger-tools.tar.gz
ranger--solr-plugin.tar.gz
ranger--sqoop-plugin.tar.gz
ranger--src.tar.gz
ranger--storm-plugin.tar.gz
ranger--tagsync.tar.gz
ranger--usersync.tar.gz
ranger--yarn-plugin.tar.gz
ranger--kylin-plugin.tar.gz
ranger--elasticsearch-plugin.tar.gz
```

## Importing Apache Ranger Project into Eclipse

1. Create an Eclipse workspace called 'ranger'

2. Import maven project from the root directory where ranger source code is downloaded (and build)

## Deployment Process

### Installation Host Information
1. Ranger Admin Tool Component (ranger--admin.tar.gz) should be installed on a host where Policy Admin Tool web application runs on port 6080 (default).
2. Ranger User Synchronization Component (ranger--usersync.tar.gz) should be installed on a host to synchronize the external user/group information into Ranger database via Ranger Admin Tool.
3. Ranger Component plugin should be installed on the component boxes:
- HDFS Plugin needs to be installed on Name Node hosts.
- Hive Plugin needs to be installed on HiveServer2 hosts.
- HBase Plugin needs to be installed on both Master and Regional Server nodes.
- Knox Plugin needs to be installed on Knox gateway host.
- Storm Plugin needs to be installed on Storm hosts.
- Kafka/Solr Plugin needs to be installed on their respective component hosts.
- YARN plugin needs to be installed on YARN Resource Manager hosts.
- Sqoop plugin needs to be installed on Sqoop2 hosts.
- Kylin plugin needs to be installed on Kylin hosts.
- Elasticsearch plugin needs to be installed on Elasticsearch hosts.

### Installation Process

1. Download the tar.gz file into a temporary folder in the box where it needs to be installed.

2. Expand the tar.gz file into /usr/lib/ranger/ folder

3. Go to the component name under the expanded folder (e.g. /usr/lib/ranger/ranger--admin/)

4. Modify the install.properties file with appropriate variables

5. - If the module has setup.sh, execute ./setup.sh
- If the install.sh file does not exists, execute ./enable--plugin.sh