Getting Started

This guide will outline the initial setup that you would need to do to make use of the Governance Center.

Prerequisites

You will need:

• 1 instance of Joget with the Governance Center installed
• At least 1 or more instances of Joget that are reachable from the Governance Center (whether publicly, or within the same network of the Governance Center) 
• 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

Create a new environment by navigating to Administration→ Manage Environment → New

Only users with admin role can create an Environment.

Figure 1: Manage Environment Form

Step 2: Create a new Installation

Register installations, identify to which environment they belong, and identify the users who can register Joget apps and submit deployment requests for this installation. 

Create a new installation by navigating to Administration→ Manage Installations→ New

An environment can contain one or more installations.

Only users with an admin role can create an Installation.

Only users who are added as deployers in the installation can register Joget app and submit deployment.

Figure 2: Manage Installation Form

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:

1. App Registration Approval Process
2. Deployment Request Approval Process

App Registration Approval Process

Step 1: Register for a new Joget App

Register a Joget app by navigating to New Request → Register App

Choose the installation and installation approver and the Environment will be auto-completed.

Choose the app owner and to whom the application is to be assigned.

Figure 3: App Registration Form

Step 2: Approver Checks App Registration Inbox

Approve the application 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 source installation which contains the application you want to transfer to the target installation

Choose the target installation that will receive the application from the source installation after the deployment has been approved.

Figure 5: Deployment Request Form

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