# README
OADP NAC
Non Admin Controller
Documentation in this repository are considered unofficial and for development purposes only.
Description
This open source controller adds the non admin feature to OADP operator. With it, cluster admins can configure which namespaces non admin users can backup/restore.
Getting Started
Prerequisites
- oc
- Access to a OpenShift cluster
- OADP operator version
1.5+
installed in the cluster
NOTE: Before OADP operator version 1.5.0 is released, you need to install OADP operator from source to use NAC.
Using NAC
To use NAC functionality:
- as admin user:
- create non admin user and its namespace, and apply required permissions to it (to create a non admin user to test NAC, you can check non admin user documentation)
- create/update DPA and configure non admin feature as needed, setting it to enabled
- as non admin user:
-
create sample application
For example, use one of the sample applications available in
hack/samples/apps/
folder, by runningoc process -f ./hack/samples/apps/<name> \ -p NAMESPACE=<non-admin-user-namespace> \ | oc create -f -
Check the application was successful deployed by accessing its route.
Create and update items in application UI, to later check if application was successfully restored.
-
create NonAdminBackup
For example, use one of the sample NonAdminBackup available in
hack/samples/backups/
folder, by runningoc process -f ./hack/samples/backups/<type> \ -p NAMESPACE=<non-admin-user-namespace> \ | oc create -f -
-
delete sample application
For example, delete one of the sample applications available in
hack/samples/apps/
folder, by runningoc process -f ./hack/samples/apps/<name> \ -p NAMESPACE=<non-admin-user-namespace> \ | oc delete -f -
Check that application was successful deleted by accessing its route.
-
create NonAdminRestore
For example, use one of the sample NonAdminRestore available in
hack/samples/restores/
folder, by runningoc process -f ./hack/samples/restores/<type> \ -p NAMESPACE=<non-admin-user-namespace> \ -p NAME=<NonAdminBackup-name> \ | oc create -f -
After NonAdminRestore completes, check if the application was successful restored by accessing its route and seeing its items in application UI.
-
Contributing
Please check our contributing documentation to propose changes to the repository.
Architecture
For a better understanding of the project, check our architecture documentation and designs documentation.
License
This repository is licensed under the terms of Apache License Version 2.0.