HTTP(S)
Packages hosted on a website as a zip file can be installed by using the direct URL to the package. Both HTTP and HTTPS URLs are supported. If the URL returns a
301 or 302 redirect, it will be followed until the package is reached.Make sure your package zip file has a
box.json inside of it so CommandBox can tell the version and name of the package. If there is no box.json, the following rules will be decided to determine the name of the package:- 1.If the URL has the zip file name in it, the name without ".zip" is used.
- 2.If the URL contains
github.com, the repo name will be used. - 3.Otherwise, the entire URL will have non alpha-numeric characters removed and used.
Installation
To install a package from a website, use the full URL like so:
1
install http://www.site.com/myPackage.zip
Copied!
In box.json
You can specify packages from HTTP(S) endpoints as dependencies in your
box.json in this format:1
{
2
"dependencies" : {
3
"myPackage" : "http://www.site.com/myPackage.zip"
4
}
5
}
Copied!
Cached URLs
If you know a given URL will always return the exact same package, then you can request CommandBox to cache the download in local artifacts to speed up builds. To do so, use an endpoint name of
https+cached or http+cached in your install ID.1
install https+cached://downloads.ortussolutions.com/ortussolutions/coldbox-modules/cbi18n/1.4.0/cbi18n-1.4.0.zip
Copied!
Or
1
start cfengine=http+cached://update.lucee.org/rest/update/provider/forgebox/5.3.3.60-RC
Copied!
Cached artifacts will be stored under the slug
HTTP_Cached and can be viewed like so:1
artifacts list HTTP_Cached
Copied!
Last modified 1mo ago
Copy link
Edit on GitHub