https://github.com/georgechang/schost-basic

Basic Sitecore Host application for demo
https://github.com/georgechang/schost-basic

Last synced: 3 months ago
JSON representation

Basic Sitecore Host application for demo

• Host: GitHub
• URL: https://github.com/georgechang/schost-basic
• Owner: georgechang
• Created: 2019-03-10T01:12:49.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2019-03-30T02:08:17.000Z (over 5 years ago)
• Last Synced: 2024-01-24T03:42:03.639Z (5 months ago)
• Language: C#
• Homepage:
• Size: 54.7 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Lists

• Awesome-Sitecore - Basic Sitecore Host Application - A basic Sitecore Host application that displays a demo web page. (Sitecore Host)

README

        
# Basic Sitecore Host Application

This is a basic Sitecore Host application that displays a demo web page. This was originally used as a demo for [SUGCON EU](https://www.sugcon.eu/) 2019 and at the [Atlanta Sitecore User Group](https://www.meetup.com/Atlanta-Sitecore/) in March 2019.

## Components 🧩

### `ScHost`

This is the base Sitecore Host application. It initializes Sitecore Host...and that's about it.

### `GC.Plugin.Messaging.Web`

This is the plugin that provides functionality to the Sitecore Host application. It initializes a web host and provides a demo page to be displayed.

## Usage 🙋‍♂️

There is a Cake script that will execute the build and deployment of the application.

Simply run `build.ps1` and the script will build and deploy the application into the `bin` directory of `ScHost`. This will include the dependent `GC.Plugin.Messaging.Web` plugin and deploy the files to the appropriate directories in the application.

If you'd like to publish your application to a different path, you can execute the Cake script like this:

`.\build.ps1 -ScriptArgs '-output="C:\output"'`

**You will need a Sitecore subscription license placed in the `sitecoreruntime` folder of the published application in order for it to run.**

To use the plugin independently, you can run `dotnet pack` on the `GC.Plugin.Messaging.Web` project which will properly generate a NuGet package for use with a Sitecore Host application. You'll need to then extract and install the NuGet package based on Sitecore's documentation [here](https://doc.sitecore.com/developers/91/sitecore-experience-management/en/add-a-runtime-plugin-manually.html#UUID-eb8606b9-8730-496a-b367-671c8b9dbab7_section-idm45363803631184).

## Docker 🚚

There is a `Dockerfile` included in the project which will build and create a Docker image of the Sitecore Host application. The `Dockerfile` expects the Sitecore `license.xml` to be in the root (same folder as the `Dockerfile`) in order to build the image.

The Cake script also has steps to build the Docker image. You can run the following to build a Docker image:

`.\build.ps1 -Target "Docker Build"`

Or, to build and run the image, you can do:

`.\build.ps1 -Target "Docker Run"`

By default, it tags the images as `schost:latest`. If you want to change the tag of the Docker image that is built with the Cake script, you can run either the `Docker Build` or `Docker Run` targets with the this extra parameter:

`.\build.ps1 -Target "Docker Build" -ScriptArgs '-tag="newtag:latest"'`

## Disclaimer ⚠

This is only intended as a proof-of-concept and does not contain production-ready code. Please don't treat it as such. 😎