docs: kubernetes operations guide

docs/admin/kubernetes-ops/README.md

@@ -7,7 +7,21 @@ tags:
 
 # Overview
 
-Please use the left navigation menu to browse the content of this section while we are still working on developing content for `Overview` page.
+This Operation Guide helps you learn about the common operations for Janssen on Kubernetes.
 
-!!! Contribute
-If you’d like to contribute to this document, get started with the [Contribution Guide](https://docs.jans.io/head/CONTRIBUTING/#contributing-to-the-documentation)
+
+## Prerequisite
+- Review the [janssen](../reference/README.md) components and architecture
+
+- Complete the [installation](../install/helm-install/local.md) of janssen on your desired Kubernetes provider.
+
+## Common Operations
+
+- [Scaling](scaling.md)
+- [Backup and Restore](backup-restore.md)  
+- [Certificate Management](cert-management.md)  
+- [Customization](customization.md)  
+- [Start Order](start-order.md)  
+- [Logs](logs.md)
+- [Health Check](health-check.md)
+- [FAQ](faq.md)

docs/admin/reference/kubernetes/README.md

@@ -3,11 +3,23 @@ tags:
   - administration
   - reference
   - kubernetes
+  - architecture
+  - components
 ---
 
 # Overview
 
-Please use the left navigation menu to browse the content of this section while we are still working on developing content for `Overview` page.
+This Reference Guide helps you learn about the components and architecture of Janssen.
 
-!!! Contribute
-    If you’d like to contribute to this document, get started with the [Contribution Guide](https://docs.jans.io/head/CONTRIBUTING/#contributing-to-the-documentation)
+## Janssen components
+
+- **auth-server**: The OAuth Authorization Server, the OpenID Connect Provider, the UMA Authorization Server--this is the main Internet facing component of Janssen. It's the service that returns tokens, JWT's and identity assertions. This service must be Internet facing.
+- **auth-key-rotation**: Responsible for regenerating auth-keys per x hours.
+- **config-api**: The API to configure the auth-server and other components is consolidated in this component. This service should not be Internet-facing.
+- **OpenDJ**: A directory server which implements a wide range of Lightweight Directory Access Protocol and related standards, including full compliance with LDAPv3 but also support  for Directory Service Markup Language (DSMLv2).Written in Java, OpenDJ offers multi-master replication, access control, and many extensions.
+- **Fido**: Provides the server side endpoints to enroll and validate devices that use FIDO. It provides both FIDO U2F (register, authenticate) and FIDO 2 (attestation, assertion) endpoints. This service must be internet facing.
+- **SCIM**: a JSON/REST API to manage user data. Use it to add, edit and update user information. This service should not be Internet facing.
+
+## Architectural diagram of Janssen
+
+![svg](../../../assets/jans-arch-diagram.svg)