Create and install a Sitecore Content Serialization package
Sitecore Content Serialization (SCS) packages (file extension .itempackage
) contain specified modules and their serialized items. You use packages as build artifacts in your continuous integration pipeline by creating them in your build pipeline and installing them in your delivery pipeline.
Create an SCS package in your build pipeline
You must configure any included items and excluded fields before package generation.
To create an SCS package in your build pipeline:
-
Go to your project folder that contains your
sitecore.json
file. -
To create the package, run the following command:
RequestResponsedotnet sitecore ser pkg create -o <name of package>
NoteYou can use the
--include
and--exclude
arguments to specify what modules go into your package.By placing your demo or test content in a separate module, you can use these arguments to exclude it from deployment to upstream environments.
-
Ensure the package file is present among your build artifacts.
Install an SCS package in your delivery pipeline
After you have created the SCS package, you can then install it as part of your continuous delivery pipeline:
To install an SCS package:
-
Make sure that you have configured your Identity Server and Content Management roles for non-interactive client login.
-
To install the package, run the following command:
RequestResponsedotnet sitecore ser pkg install -f <name of package>.itempackage --client-id <your client id> --client-secret <your client secret> --cm <your content management host> --auth <your identity host>
NoteYour client secret is a password that provides administrative access to the Sitecore instance. Ensure you are properly protecting this password using proper security mechanisms in your build system.
Use the
dotnet sitecore ser pkg install --help
command to see more arguments for the package install command.