Repository: ranger Updated Branches: refs/heads/ranger-0.7 a219604a4 -> 6a953dbd6
RANGER-1651 : Improve Ranger and Ranger KMS REST Api documentation Project: http://git-wip-us.apache.org/repos/asf/ranger/repo Commit: http://git-wip-us.apache.org/repos/asf/ranger/commit/6a953dbd Tree: http://git-wip-us.apache.org/repos/asf/ranger/tree/6a953dbd Diff: http://git-wip-us.apache.org/repos/asf/ranger/diff/6a953dbd Branch: refs/heads/ranger-0.7 Commit: 6a953dbd6de0468143afae8e5b5546646559ac13 Parents: a219604 Author: Mehul Parikh <me...@apache.org> Authored: Tue Jun 20 17:54:34 2017 +0530 Committer: Mehul Parikh <me...@apache.org> Committed: Tue Jun 27 12:01:43 2017 +0530 ---------------------------------------------------------------------- docs/src/site/site.xml | 2 ++ enunciate.xml | 37 +++++++++++++++++++++++++++++++++++++ kms/pom.xml | 15 +++++++++++++++ pom.xml | 27 +++++++++++++++++++++++++++ security-admin/pom.xml | 15 +++++++++++++++ 5 files changed, 96 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/ranger/blob/6a953dbd/docs/src/site/site.xml ---------------------------------------------------------------------- diff --git a/docs/src/site/site.xml b/docs/src/site/site.xml index fc4b037..e729499 100644 --- a/docs/src/site/site.xml +++ b/docs/src/site/site.xml @@ -46,6 +46,8 @@ under the License. <menu name="Resources"> <item name="Wiki" href="https://cwiki.apache.org/confluence/display/RANGER/Index"; /> <item name="Quick Start Guide" href="quick_start_guide.html"/> + <item name="Ranger REST API Documentation" href="apidocs/index.html"/> + <item name="Ranger KMS REST API Documentation" href="kms/apidocs/index.html"/> <!-- According to http://jira.codehaus.org/browse/MNGSITE-152 --> <item name="License" href="http://www.apache.org/licenses/"/> </menu> http://git-wip-us.apache.org/repos/asf/ranger/blob/6a953dbd/enunciate.xml ---------------------------------------------------------------------- diff --git a/enunciate.xml b/enunciate.xml new file mode 100644 index 0000000..c91d196 --- /dev/null +++ b/enunciate.xml @@ -0,0 +1,37 @@ +<!-- + ~ Licensed to the Apache Software Foundation (ASF) under one + ~ or more contributor license agreements. See the NOTICE file + ~ distributed with this work for additional information + ~ regarding copyright ownership. The ASF licenses this file + ~ to you under the Apache License, Version 2.0 (the + ~ "License"); you may not use this file except in compliance + ~ with the License. You may obtain a copy of the License at + ~ + ~ http://www.apache.org/licenses/LICENSE-2.0 + ~ + ~ Unless required by applicable law or agreed to in writing, software + ~ distributed under the License is distributed on an "AS IS" BASIS, + ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + ~ See the License for the specific language governing permissions and + ~ limitations under the License. + --> +<enunciate xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"; + xsi:noNamespaceSchemaLocation="http://enunciate.webcohesion.com/schemas/enunciate-2.8.0.xsd"; > + <title>Ranger REST API</title> + <description> Apache Ranger is a framework to enable, monitor and manage comprehensive data security across the Hadoop platform. Apache Ranger currently provides a centralized security adminstration, fine grain access control and detailed auditing for user access within Apache Hadoop, Apache Hive, Apache HBase and other Apache components</description> + <modules> + <swagger/> + <jackson/> + <jackson1 disabled="true"/> + <c-xml-client disabled="true"/> + <java-json-client disabled="true"/> + <csharp-xml-client disabled="true"/> + <java-xml-client disabled="true"/> + <javascript-client disabled="true"/> + <ruby-json-client disabled="true"/> + <gwt-json-overlay disabled="true"/> + <php-xml-client disabled="true"/> + <php-json-client disabled="true"/> + <jaxws disabled="true"/> + </modules> +</enunciate> http://git-wip-us.apache.org/repos/asf/ranger/blob/6a953dbd/kms/pom.xml ---------------------------------------------------------------------- diff --git a/kms/pom.xml b/kms/pom.xml index dd3f0c5..54fa01c 100644 --- a/kms/pom.xml +++ b/kms/pom.xml @@ -429,6 +429,10 @@ <version>${derby.version}</version> <scope>test</scope> </dependency> + <dependency> + <groupId>com.webcohesion.enunciate</groupId> + <artifactId>enunciate-core-annotations</artifactId> + </dependency> </dependencies> <build> <pluginManagement> @@ -438,6 +442,17 @@ <artifactId>maven-war-plugin</artifactId> <version>2.6</version> </plugin> + <plugin> + <groupId>com.webcohesion.enunciate</groupId> + <artifactId>enunciate-maven-plugin</artifactId> + <configuration> + <configFile>enunciate.xml</configFile> + <enunciateArtifactId/> + <docsDir>docs/target/kms/</docsDir> + <source>1.8</source> + <target>1.8</target> + </configuration> + </plugin> </plugins> </pluginManagement> <resources> http://git-wip-us.apache.org/repos/asf/ranger/blob/6a953dbd/pom.xml ---------------------------------------------------------------------- diff --git a/pom.xml b/pom.xml index 91e4434..80de97e 100644 --- a/pom.xml +++ b/pom.xml @@ -353,6 +353,11 @@ <artifactId>gson</artifactId> <version>${gson.version}</version> </dependency> + <dependency> + <groupId>com.webcohesion.enunciate</groupId> + <artifactId>enunciate-core-annotations</artifactId> + <version>2.8.0</version> + </dependency> </dependencies> </dependencyManagement> <build> @@ -475,6 +480,26 @@ <artifactId>maven-release-plugin</artifactId> <version>2.5.2</version> </plugin> + <plugin> + <groupId>com.webcohesion.enunciate</groupId> + <artifactId>enunciate-maven-plugin</artifactId> + <version>2.8.0</version> + <configuration> + <configFile>enunciate.xml</configFile> + <enunciateArtifactId/> + <docsDir>docs/src/site/</docsDir> + <source>1.8</source> + <target>1.8</target> + </configuration> + <executions> + <execution> + <goals> + <goal>docs</goal> + </goals> + <phase>package</phase> + </execution> + </executions> + </plugin> </plugins> </pluginManagement> <plugins> @@ -576,6 +601,8 @@ <exclude>**/.pydevproject</exclude> <exclude>**/derby.log</exclude> <exclude>**/*.jaas</exclude> + <exclude>**/target/apidocs/**</exclude> + <exclude>**/target/kms/apidocs/**</exclude> </excludes> </configuration> </plugin> http://git-wip-us.apache.org/repos/asf/ranger/blob/6a953dbd/security-admin/pom.xml ---------------------------------------------------------------------- diff --git a/security-admin/pom.xml b/security-admin/pom.xml index 90b8cab..f863d74 100644 --- a/security-admin/pom.xml +++ b/security-admin/pom.xml @@ -434,6 +434,10 @@ <artifactId>guice</artifactId> <version>3.0</version> </dependency> + <dependency> + <groupId>com.webcohesion.enunciate</groupId> + <artifactId>enunciate-core-annotations</artifactId> + </dependency> </dependencies> <build> <pluginManagement> @@ -516,6 +520,17 @@ </execution> </executions> </plugin> + <plugin> + <groupId>com.webcohesion.enunciate</groupId> + <artifactId>enunciate-maven-plugin</artifactId> + <configuration> + <configFile>enunciate.xml</configFile> + <enunciateArtifactId/> + <docsDir>docs/target/</docsDir> + <source>1.8</source> + <target>1.8</target> + </configuration> + </plugin> </plugins> <resources> <resource>
