Skip to main content

Builder - Version Control

Browse published modules and their version history on the Version Control page in the Builder.

The Version Control page in the Builder lists the modules published to your registries. Use it to see which modules are available, how many projects use each one, and the version history of a module.

Note: Two versions of this page are in use. Newer organizations see a single Registries tab, described first. If your page also has a Storages tab, see Storages tab on the earlier layout.

Access the Version Control page

  1. Open the Builder.

  2. Click Version Control in the left sidebar.

Registries tab

The Registries tab shows the published modules in the selected registry.

  1. Select a registry in the Registry field, for example production.

  2. To find a module, type its identifier in the Search field.

Column

Description

Idn

Module identifier.

Latest Version

The most recent published version of the module.

Subscriptions

Number of projects subscribed to this module.

View version history

Click Version History on a module row to open a panel that lists every published version of that module.

Column

Description

Idn

Module identifier.

Version

Version number.

Active Clients

Number of organizations currently running this version.

Status

Status of the version, for example Deployed.

Created at

Date and time the version was created.

Published at

Date and time the version was published.

Use the Search field at the top of the panel to filter the list.

How Version Control connects to Projects

When you create a project and activate a module from a registry, the project subscribes to that module. The Registries tab shows the other side of that relationship: the published modules, and how many projects subscribe to each.

To publish your own project to a registry, publish one of its versions from the project page. See Builder - Projects.

Storages tab on the earlier layout

This section applies if your Version Control page has a Storages tab.

The Storages tab displays project images, which are point-in-time snapshots of a project's state. Project images are created from the Projects page (see Builder - Projects) and stored here.

Column

Description

Idn

Unique identifier for the project image.

Image hash

Hash value identifying the image contents.

Created at

Timestamp when the image was created.

Release an image

Releasing an image publishes it to a registry as a versioned module that other projects can subscribe to.

  1. Click the release action on a project image row.

  2. Fill in the release form:

Field

Required

Description

Registry

Yes

The target registry to publish to.

Module

Yes

The module identifier. You can select an existing module or type a new one.

Release Version

Yes

The version number (for example, 1.0.0).

Deploy

No

Switch. When enabled, the release is immediately deployed as a public module.

  1. Click Release and Deploy (if Deploy is enabled) or Release (if Deploy is disabled).

Delete a project image

  1. Click the three-dot menu on the project image row.

  2. Select Delete and confirm.

Automatic updates

When a module is updated in a registry, projects with Auto update enabled automatically receive the new version. Projects without auto-update can be manually updated using Force Update Project from the Projects page.

Did this answer your question?