Skip to content

Commit

Permalink
Merge branch 'master' into stage
Browse files Browse the repository at this point in the history
  • Loading branch information
nsolov authored Aug 20, 2023
2 parents 83da9fc + 336b9b1 commit a135d19
Show file tree
Hide file tree
Showing 3 changed files with 41 additions and 9 deletions.
1 change: 0 additions & 1 deletion .github/workflows/trigger-deploy.yml
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,6 @@ jobs:
trigger-zpm-deployment:
name: Trigger zpm-registry-deployment via REST API
runs-on: ubuntu-22.04

steps:
- name: REST POST call
run: |-
Expand Down
47 changes: 40 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# intersystems zpm-registry
[![Quality Gate Status](https://community.objectscriptquality.com/api/project_badges/measure?project=intersystems_iris_community%2Fzpm-registry&metric=alert_status)](https://community.objectscriptquality.com/dashboard?id=intersystems_iris_community%2Fzpm-registry)
[![Quality Gate Status](https://community.objectscriptquality.com/api/project_badges/measure?project=intersystems_iris_community%2Fzpm-registry&metric=alert_status)](https://community.objectscriptquality.com/dashboard?id=intersystems_iris_community%2Fzpm-registry)

ZPM Registry is a a server part of ObjectScript Package Manager.

Expand All @@ -13,26 +13,59 @@ You can use ZPM Registry project to build your own private registry to have the
ZPM Registry works only on IRIS and IRIS For Health, community and Enterprise versions.

# Installation
## Usual Installation
Import classes from cls and run Installer from Root

## ZPM Installation
`install zpm-registry`

## Docker Installation
Build docker container

## ZPM Installation
`install zpm-registry`
## 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](https://github.com/intersystems-community/zpm-registry/blob/master/src/cls/ZPM/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.
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
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
```


Expand Down
2 changes: 1 addition & 1 deletion module.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<Name>zpm-registry</Name>
<ExternalName>ZPM Registry</ExternalName>
<Description>Registry server for ZPM</Description>
<Version>1.2.4</Version>
<Version>1.2.6</Version>
<Packaging>module</Packaging>
<Dependencies>
<ModuleReference>
Expand Down

0 comments on commit a135d19

Please sign in to comment.