NIFIREG-172 Adds Swagger UI

- Adds self-hosted Swagger UI to nifi-registry-web-api WAR at /swagger/ui.html
- Updates NOTICE for included ALv2 licensed source.
- Adds Jersey filter exclusion for resources starting with /swagger/*
- Adds top-level authorizable resource type for /swagger/*
- Updates ResourceAuthorizationFilter configuration to include swagger resource type
- Corrects name of Position model object in Swagger specification
- Corrects duplicate operationId/nickname field for methods in
  FlowResource and BucketFlowResource
- Updates and fixes to README and NOTICE files

This closes #119.

Signed-off-by: Bryan Bende <bbende@apache.org>
18 files changed
tree: 2e839aae959b563f0c0fedb566cc610fba4faa2e
  1. nifi-registry-assembly/
  2. nifi-registry-bootstrap/
  3. nifi-registry-client/
  4. nifi-registry-data-model/
  5. nifi-registry-docker/
  6. nifi-registry-docs/
  7. nifi-registry-flow-diff/
  8. nifi-registry-framework/
  9. nifi-registry-jetty/
  10. nifi-registry-properties/
  11. nifi-registry-provider-api/
  12. nifi-registry-resources/
  13. nifi-registry-runtime/
  14. nifi-registry-security-api/
  15. nifi-registry-security-utils/
  16. nifi-registry-utils/
  17. nifi-registry-web-api/
  18. nifi-registry-web-docs/
  19. nifi-registry-web-ui/
  20. .gitignore
  21. .travis.yml
  22. build-and-run.sh
  23. LICENSE
  24. NOTICE
  25. pom.xml
  26. README.md
  27. stop.sh
README.md

Apache NiFi Registry Build Status

Registry—a subproject of Apache NiFi—is a complementary application that provides a central location for storage and management of shared resources across one or more instances of NiFi and/or MiNiFi.

Table of Contents

Getting Started

Requirements

  • Java 1.8 (above 1.8.0_45)
  • Maven 3.1.0, or newer
  • Recent git client
  1. Clone the repo

     git clone https://git-wip-us.apache.org/repos/asf/nifi-registry.git
     git checkout master
    
  2. Build the project

     cd nifi-registry
     mvn clean install
    

    If you wish to enable style and license checks, specify the contrib-check profile:

     mvn clean install -Pcontrib-check
    

    If you wish to run integration tests and contrib-check, specify both profiles:

     mvn clean install -Pcontrib-check,integration-tests
    
  3. Start the application

     cd nifi-registry-assembly/target/nifi-registry-<VERSION>-bin/nifi-registry-<VERSION>/
     ./bin/nifi-registry.sh start
    

    Note that the application web server can take a while to load before it is accessible.

  4. Accessing the application web UI

    With the default settings, the application UI will be available at http://localhost:18080/nifi-registry

  5. Accessing the application REST API

    If you wish to test against the application REST API, you can access the REST API directly. With the default settings, the base URL of the REST API will be at http://localhost:18080/nifi-registry-api. A UI for testing the REST API will be available at http://localhost:18080/nifi-registry-api/swagger/ui.html

  6. Accessing the application logs

    Logs will be available in logs/nifi-registry-app.log

License

Except as otherwise noted this software is licensed under the Apache License, Version 2.0

Licensed 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.