...
This guide will outline the initial setup that you would need to do to make use of the Governance AppCenter.
Prerequisites
You will need:
- 1 instance of Joget with the Governance App installedCenter installed
- At least 1 or more instances of Joget that is are reachable from the Governance App Center (whether publicly, or within the same network of the Governance AppCenter)
- Admin access to all the instances.
Upon importing the Governance Center, you will need the following plugins for the Governance Center to work:
- API Builder Addon For DX
- Governed API Plugins(governed-api-plugins-8.0-SNAPSHOT)
- Governed Plugins(governed-plugins)
Upon launching the Governance Center, you will need the following setups to proceed:
- At least 1 or more users are assigned as App Owner in the Manage User Role
- At least 1 user is assigned as App Developer in the Manage User Role or 1 user is assigned in a Groups
Step 1: Create a new environment
Identify the environment you wish to create. Example: Production, Staging, Development, Testing, etc
...
Only users with admin role can create an Environment.
Figure 1: Manage Environment Form
Step 2: Create a new Installation
...
Only users who are added as a deployer deployers in the installation can register Joget app and submit deployment.
Figure 2: Manage Installation Form
| Field | Description |
|---|---|
| Installation ID | Auto-generated |
| Installation Name | Installation Name used for reference within the Governance Appthe Governance Center |
| Base URL | URL of the Joget instance. (Must be reachable to the Governance App Center & you as the userthe user)
|
| Installation Admin ID | Username for the user with admin privilege in the installation Joget instance |
| Installation Admin Password | Password for the user with admin privilege in the installation Joget instance |
| Environment | The environment label name for this installation. Selectbox with options are retrieved from Manage Installations |
| Deployer | The user who requested for this installation. Multi Select Box that allows multiple selections. Selection options are retrieved from Users |
| Approver | The user who will be in charge of approving this installation. Multi Select Box that allows multiple selections. Selection options are retrieved from Users |
New Request
Once the Environment and Installations have been created, users who have been assigned as a Deployer will be able to perform 2 processes under the New Request UI category:
...
Choose the app owner and to whom the application is to be assigned.
Figure 3: App Registration Form
| Field | Description |
|---|---|
| App ID | Auto-generated |
| Installation | Define which installation should the App be registered. |
| Installation Approver | Define the Installation Approver. Selectbox that displays relevant installation approver users available based on the selection of the Installation field. |
| Environment | Define which environment the App would be registered to. Selectbox that displays relevant environments from Manage Environment based on the selection of the Installation field. |
| App Name | Selectbox that displays relevant Apps available based on the selection of the Installation field. |
| App Criticality | Define the criticality of the App.
|
| App Availability | Define the availability of the App. |
| App Purpose | Define the purpose of the App |
| Contact Type | Define the contact type. Selectbox with the following available options:
|
| App Owner | Define the owner of the App. Selectbox that displays relevant users who are identified as App Owner in the Manage User Role |
| Assign To | Define whether the App is assigned to an individual App Developer/Designer or a Group of Users Selectbox with the following available options:
|
| Set Pipeline? | Define whether the App will be deployed by following a sequence of installations. A single Checkbox that when ticked, will display the Pipeline (Please Select in order) field. |
| Pipeline (Please Select in order) | Define which installation the App would be deployed in sequence. Multi Select Box that allows multiple selections. Selection options are retrieved from Manage Installations This field will be displayed if the checkbox in Set Pipeline? field is ticked. |
| Group | Define which user group the deployed is assigned to. Selectbox that displays all available Groups |
| App Developer/Designer | Define which user is assigned to. |
Multi Select Box that allows multiple selections that display relevant users who are identified as App Developer in Manage User Role |
Step 2: Approver Checks App Registration Inbox
...
Approve the application registration registration by navigating to Approvals → App Registration Inbox
...
Figure 4: App Registration Inbox
Deployment Request Approval Process
Step 1: Submit a New Deployment
Submit New Deployment New Request → Submit Deployment
...
Choose the target installation that will receive the application from the source installation after the deployment has been approved.
Figure 5: Deployment Request Form
| Field | Description |
|---|---|
| Deployment Request ID | Auto-generated |
| Source Installation | Source instance from where the application is to be imported from |
| Current Environment | The source environment of the installation that this application should be imported from |
| Source Base URL | Source instance URL to import the application |
| App ID | ID of the application to be imported |
| App Version | The version of the application to be imported |
| Target Installation | Target instance to where the application will be exported & installed to |
| Target Environment | The target environment of the installation that this application will be exported & installed to |
| Target Base URL | Target instance URL to export & install the application to |
| Approver | The user who will be approving this deployment |
| Description (reason) | Description of the deployment request |
Step
...
2: Approver Checks Deployment Inbox
Approve the Deployment Approvals → Deployment Inbox
You will be able to see your deployments overview in the list here once it is approved by the approver.
Figure 7: Deployment Request Inbox