Xedge>> dfadmin>> 返回
项目作者： NYU-CI

项目描述 ：
Data Facility Admin
高级语言： TSQL
项目地址: git://github.com/NYU-CI/dfadmin.git
创建时间： 2019-01-15T00:45:55Z
项目社区：https://github.com/NYU-CI/dfadmin
开源协议：Creative Commons Zero v1.0 Universal
下载


Data Facility Admin

Codacy Badge Status
Codacy Badge Coverage
Build Status

Admin system for the Data Facility.

Why

DFAdmin was created to organize the core entities of a Data Facility such as Datasets, People and Projects. It is used as a core component on ADRF, being the orchestrator of IAM. Read more on the ADRF Framework, Data Model and DFAdmin whitepaper.

Features

Data Model

Data Model

Screenshots

DFAdmin V3 Login

DFAdmin V3 Home

Requirements

  • Docker (v 17.12.0)& Docker Compose
  • Wait-for-it. After git clone, run make git-submodules-init

Teste on MacOX: Docker version 17.12.0-ce, build c97c6d6

Deploy - with Docker

Two containers are used:

  • web: to run the web application and Django management tasks.
  • db: is a PostgreSQL database with a local folder mounted as the data volume.

Copy the code to the desired server and run:

  1. make deploy-build-latest: used to build the containers on the first time and to update the web container when needed.
  2. make depoy-up: used to run start the containers.

Development

Prepare the application and database

  1. Run ln -s local.env .env to symlink the local dev configuration
  2. Run the containers docker-compose up -d
  3. Prepare the database with the data backup and migrate make dev-db-restore or just make db-migrate if you don’t have a previous db backup to use.
  4. Create the super user: docker-compose exec web ./manage.py createsuperuser (if you restored the dev db it might already have a super user with dfadmin/dfadmin credentials)
  5. Run tests (make test) to make sure all is right.

Cheers! Go to http://localhost:8000 and check the DF Admin website.

Running tests

You can run tests with the following:

  • make test: to run tests creating the database (necessary on the first run)

Clean the database (Postgres)

This will wipe out everything (tables, sequences and views; the whole schema): dev-db-clear

Access

Now access the <host>:8000/admin and you should be prompted for login credentials.

Before commit

Before commit your changes, please:

  1. Run tests: make test
  2. Run code checks: make code-check

LDAP Control

(needs update)

When you write users and groups in LDAP, we should know some information like objectClass, loginShell, HomeDirectory, uidNumber, and gidNumber.
All the groups that exist in LDAP should come from DF Admin. We should have the Django models Group, Dataset, and Project in DF Admin. These models should use the same sequence to set their id value, and we should use this id to set the gidNumber in LDAP. We should use the id of the Django model User as the uidNumber. The groups and users in LDAP should be created only by DF Admin. The rest of the necessary information necessary to create groups and users in LDAP should be processed by a script using conventions.

Troubleshooting

wait for it not found: Make sure you initialized the submodules. (see requirements above)

Documentation

Reference the folder documentation.

UML Class Diagram

A class diagram can be generated automatically based on the models with django_model_graph.sh

  1. source env/bin/activate
  2. make docs

Release

Please check the RELEASE documentation when preparing a release.

Keycloak Integration

Postman Collections: https://www.getpostman.com/collections/1b72e4b52b9e5ad42d3c

Getting KeyCloak PubKey (It needs to have the “——BEGIN…” And “——-END…”) (PEM format): https://www.getpostman.com/collections/1b72e4b52b9e5ad42d3c

References:

https://zapier.com/engineering/apikey-oauth-jwt/
https://www.digitalocean.com/community/tutorials/an-introduction-to-oauth-2
http://getblimp.github.io/django-rest-framework-jwt/#additional-settings
https://auth0.com/blog/building-modern-applications-with-django-and-vuejs/

Contributors