Sitecore.Ship is a lightweight means to install Sitecore Update packages via HTTP requests.
Sitecore.Ship documentation can be found on Apiary.io
Instructions for Use
The latest release versions of the Sitecore.Ship packages can be found in the NuGet package gallery
Early releases of the Sitecore.Ship packages can be found on a public feed from MyGet
Installing Sitecore.Ship via NuGet
Ensure that the website project is set to run with
.NET Framework 4.5
Ensure that the
web.configfile for the target project if already existing is included into your project.
Run the following powershell command in the package manager console of the Visual Studio solution for the target website to install the Nancy based version of Sitecore.Ship:
PM:> install-package Sitecore.Ship
or to use the ASP Net HTTP Handler only option install the following package:
PM:> install-package Sitecore.Ship.AspNet
Installing the package will do the following:
Add a new
packageInstallationsection to your
web.configfile. You can set configuration options in this section to enable remote access to the installer and to enable the package streaming functionality. These options are safe by default, that is, no remote access and package streaming disabled.
Note: the configuration settings are ignored in this branch of Sitecore.Ship.
Register a single new HTTP handler section in
<system.webserver>. Support for classic mode in IIS has been removed.
ship.configSitecore include file to the
Shown below is a fully specified configuration section for Sitecore.Ship:
<packageInstallation enabled="true" allowRemote="true" allowPackageStreaming="true" recordInstallationHistory="true"> <Whitelist> <add name="local loopback" IP="127.0.0.1" /> <add name="Allowed machine 1" IP="10.20.3.4" /> <add name="Allowed machine 2" IP="10.40.4.5" /> </Whitelist> </packageInstallation>
- IP address whitelisting is disabled if no elements are specified below the
<Whitelist>element or if the element is omited.
recordInstallationHistory has been set to true packages should follow the naming conventions set out below:
Packages should follow the following naming conventions. Id should be an int.
- ID should be an integer
- Extension should be either update or zip
Run the following commands from the package manage console within Visual Studio:
PM:> uninstall-package Sitecore.Ship
Contributing to the Project
If you are interested in contributing to the growth and development of Sitecore.Ship in even a small way, please read the notes below.
Your participation in the project is very much welcomed.
Working with Sitecore.Ship Source Code
Clone this repository to your local file system
From a command prompt type
.\build.cmdand press Enter
A successful command line build will generate a NuGet package in the
Please ensure that there are no compilation or test failures and no code analysis warnings are being reported by the command line build.
Running Smoke Tests
build.proj file contains a set of smoke tests to verify that the Sitecore.Ship features all run successfully when the package has been installed in a Sitecore website.
In order to run these smoke tests you will need to:
Have a local install of Sitecore.
Set the TestWebsitePath and TestWebsiteUrl in the build\environment.props to reference the local Sitecore website.
Ensure that the test website has the Ship package installed by running the following in the Package Manager Console:
install-package Sitecore.Ship -Source <path to folder containing your sitecore.ship nupkg file>
You can then run the smoke tests by entering:
A series of curl commands fire off HTTP requests to the Sitecore.Ship service routes and the results are printed out to the console. Each of these commands should execute successfully before you send a pull request back to the main project.