Changing registry deployment mode

🌐 This document is available in both English and Ukrainian. Use the language toggle in the top right corner to switch between versions.

1. Overview

Deployment mode is a parameter that indicates the environment in which the registry regulations are deployed. It allows distinguishing between the production environment and the development environment, as well as configuring the settings according to the needs of each. The registry Platform supports two deployment modes: development and production. The development mode

The development mode involves deployment with settings for convenience in development and debugging.

The production mode involves optimized deployment for maximum productivity, stability, and security. It excludes additional debugging tools, provides optimal configuration and settings for real-world operation on target clusters.

In the production mode, the following components involved in the registry development processes are not deployed:

  • Components involved in the processes of registry regulations development;

  • Public endpoints of the components involved in the processes of registry regulations development.

Table 1. Components and endpoints used by registry developers

Registry development component

Production use

Public Endpoint (Route)

admin-portal

Depends on configuration

Available

registry-regulation-management

Available

Not available

kafka-ui

Not available

Not available

redash-admin

Not available

Not available

redash-admin-adhocworker

Not available

Not available

redash-admin-scheduledworker

Not available

Not available

redash-admin-exporter

Not available

Not available

form-management-modeler (legacy)

Not available

Not available

pgAdmin

Not available

Not available

registry-vault

Available

Not available

external-integration-mocks

Not available

Not available

registry-rest-api

Available

Not available

This table provides recommendations for using components and their deployment availability in a production environment.

Services such as admin-portal and registry-regulation-management can be enabled if needed; however, their use in production environments is not recommended. At the same time, the deployment of these services is supported and can be activated through registry settings based on your requirements.

2. Configuration

To change the registry deployment mode — deploymentMode — from production to development, follow these steps:

  1. Open the OpenShift console, find the Control Plane project, and navigate to the gerrit component.

  2. Find the repository with your registry and open the deploy-templates/values.yaml file.

  3. Locate the deploymentMode: production variable and change its value to deploymentMode: development.

    The deployment mode settings appear as follows:

    deploy-templates/values.yaml
    global:
      deploymentMode: development
  4. (Optional) If you need to deploy the registry without a specific portal (for example, Citizen portal), exclude it from the settings as follows:

    deploy-templates/values.yaml
    global:
      excludePortals: ['citizen']

    By default, the excludePortals variable is absent, which indicates the deploying of all portals:

    deploy-templates/values.yaml
    global:
      excludePortals: ['']

    When excluding the Citizen portal from the deployment process, the following services are also not deployed:

    • citizen-portal

    • ddm-notification-service

    • user-service-api

    • user-service-persistence

  5. Commit the changes with git commit, apply the changes to the master branch, and initiate the registry deployment.