GitHubUpdater

Sync GitHub repositories into InterSystems Cache.

Installation

1. Download the latest Release .xml file and import it into Caché (any namespace, further referred to as {Namespace}).

Usage

Call

w ##class(CacheUpdater.Task).Update("Owner", "Repository", "Branch", "Username", "Password", "Namespace")

to download and compile classes from the Github repo.

Where

Owner - The name of the repository owner.

Repository - The name of the repository.

Branch - The name of the commit/branch/tag. If skipped the repository’s default branch (usually master) would be used.

Username - GitHub user, who has access to repository. Optional for public repositories.

Password - GitHub password, corresponding to Username. Optional for public repositories.

Note, that with Username, you can make up to 5,000 requests per hour.
For unauthenticated requests, the rate limit allows to make up to 60 requests per hour.
Unauthenticated requests are associated with an IP address.

Namespace - Namespace, where to download and compile repository.

For example in the repository: https://github.com/intersystems-ru/Cache-MDX2JSON

Owner - intersystems-ru, Repository - Cache-MDX2JSON.

OR

create task for syncing GitHub repository → Cache instance do the following:

1. Go to SMP → System Operation → Task Manager → New Task
2. Set Name as desired
3. Set Namespace to run task in to {Namespace}
4. Set Task type to GitHub Update
5. Set GitHubURL to a valid GitHub repository, eg: https://github.com/intersystems-ru/Cache-MDX2JSON
6. Set Namespace to a Namespace you want to download GitHub repository to
7. Optionally provide Username, Password (for private repos or very frequent updates).
8. Set up the Branch you need. Possible values are names of commit/branch/tag
9. Set other parameters as desired and finish creation of the task

After task runs at least once you will get GitHubURL repository contents in Namespace

Continuous Integration

If you want more functionality check out CacheGitHubCI project.