intersystems zpm-registry
ZPM Registry is a a server part of ObjectScript Package Manager.
ZPM Registry hosts ZPM packages and publishes API to publish, list and deploy packages.
InterSystems Developers Community has the the public ZPM Registry - Commmunity Registry hosted on pm.community.intersystems.com and this code works there. Here is the list of available packages.
ZPM Client by default installs packages from Community Registry.
You can use ZPM Registry project to build your own private registry to have the option to install packages with ZPM client from your private registry.
Prerequisites
ZPM Registry works only on IRIS and IRIS For Health, community and Enterprise versions.
Installation
ZPM Installation
install zpm-registry
Docker Installation
Build docker container
Usual Installation
Import classes from cls and run Installer from Root
Usage
ZPM Registry exposes REST API, which perfoms listing, publising and deployment services. You can examine the REST in the source class Registry.cls or via Swagger
Note, when you publish the repo via API you need to provide the Github URL of the repo, which will contain module.xml.
And published package will remember the repository and will not allow to publish/update package with the same name but with another repository.
Working With Your Registry From ZPM Client
You can setup ZPM client to work with your registry with the following command:
zpm:USER>repo -n registry -r -url https://registry.yourdomain.com
Settings
To configure the registry, utilize the zpm-registry.yaml file located within the IRIS installation folder. Retrieve the IRIS directory in which the file should reside using the following command: write ##class(%SYSTEM.Util).InstallDirectory()
.
Proxy-Registry
Starting from version 1.1.2, zpm-registry includes the Proxy feature.
This allows the IPM client to use only your private registry and install packages from your private registry, all the while retaining the capability to install packages from an external registry (Uplink).
External registries that your local registry can access are called Uplinks. You can define one or more external registries. You can also list which packages from the Uplink registry should be available.
These settings are set in the zpm-registry.yaml
file.
Settings file example:
uplinks:
pm:
url: https://pm.community.intersystems.com/
allow_packages: dsw,zpm*,?u*
For more information, see https://community.intersystems.com/post/new-zpm-registry-feature-%E2%80%93-proxy-registry
Delete packages
Starting from version 0.7, IPM introduces support for the “unpublish” command, which facilitates the removal of a package that was previously published.
In order for this command to be executed, it is necessary to explicitly allow the removal of packages on the side of the registry. To do this, add the line “delete-enabled: true” to the settings file zpm-registry.yaml
Settings file example:
delete-enabled: true