alenpelin / sitecore-bootcamp

Sitecore installation in a form of NuGet package.

Sitecore Bootcamp

Sitecore Bootcamp is a project which designed to install Sitecore via NuGet with minimal artifact size possible (90% of the files are downloaded from Sitecore cloud), flavoured with extra features:

• run-time installation (with 503 status code) - just like other CMSs do
• /Web_Config/Include folder support for web.config patching the same way as /App_Config/Include/*.config does

Check Wiki section for details.

Prerequisites (once per dev machine)

1. Run latest QA version of SIM
2. Ensure that SIM has necessary Sitecore version to install
3. Click Bundled Tools -> Generate NuGet option

Usage (for running on dev machine)

1. Create empty Visual Studio website solution
2. Open NuGet Console
3. Install-Package Sitecore.Bootcamp
4. Change NuGet server (combobox) to Sitecore NuGet
5. Install-Package SC.Sitecore.Kernel
6. Find Sitecore.Kernel in Project References
7. Modify its properties to set Copy Local = True
8. Create /App_Data folder and put there the license.xml valid Sitecore license file
9. Click F5 and choose running without debugging

Usage (for running on remote servers)

9. Install-Package SC-AsFiles
10. Deploy to the remote server 11. Open the remote server URL in browser

Under the hood

Check Wiki section for details.

sitecore-bootcamp's Issues

Postpone client files extracting

Extracting client files is a long process which takes up to 20 seconds. In current implementation 0.0.5.6 client files are extracted during installation-after-deployment process, however it is not actually so required. It is possible however to move this operation to the initialize pipeline in Sitecore as it will not recycle application pool

Connection strings from Azure Web App settings are ignored

We need to use ConfigurationManager to check if connection string is defined or not.

Deploy without cleaning remote files doesn't work

Scenario:

1. Create very basic solution with bootcamp
2. Deploy it and make sure it works
3. Add web.config include file
4. Deploy that file

Actual Result:
The web.config include file is not merged.

Expected Result:
The web.config include file is merged.

Implement /App_Data to be data folder

Run installation in a thread

Currently installation is done via foreground http-request-associated thread, which can be terminated if the browser tab is closed. We need to dedicate a parallel thread that will continue its job even if the client is disconnected.

DeleteBootcampFiles fails with exception

Exception Details: System.IO.IOException: Cannot create a file when that file already exists.
Stack Trace: 
[IOException: Cannot create a file when that file already exists.
]
   System.IO.__Error.WinIOError(Int32 errorCode, String maybeFullPath) +1093
   System.IO.File.InternalMove(String sourceFileName, String destFileName, Boolean checkHost) +175
   Sitecore.Bootcamp.Core.Processors.DeleteBootcampFiles.Process(ProcessorArgs args) +158
   Sitecore.Bootcamp.Core.Pipeline.Run(ProcessorArgs args) +100
   Sitecore.Bootcamp.Core.BootcampCore.Install() +934
   System.Web.UI.Control.LoadRecursive() +68
   System.Web.UI.Page.ProcessRequestMain(Boolean includeStagesBeforeAsyncPoint, Boolean includeStagesAfterAsyncPoint) +4498

Implement Sitecore.Bootcamp.Databases NuGet package

Implement Sitecore.Bootcamp.Databases NuGet package that will store default Sitecore databases and be able to deploy it using something like DACPAC

Too long MongoDB database name

Exception: System.ArgumentOutOfRangeException
Message: Database name 'C_Sitecore_Projects_Sitecore_NoSQL_src_Sitecore_NoSQL__tracking_live' exceeds 64 bytes (after encoding to UTF8).
Parameter name: name
Source: MongoDB.Driver
   at MongoDB.Driver.MongoDatabase..ctor(MongoServer server, String name, MongoDatabaseSettings settings)
   at MongoDB.Driver.MongoServer.GetDatabase(String databaseName, MongoDatabaseSettings databaseSettings)
   at Sitecore.Analytics.Data.DataAccess.MongoDb.MongoDbDriver..ctor(String connectionString, Boolean failOnReadErrors, MongoDbProfiler profiler)
   at Sitecore.Analytics.Data.DataAccess.MongoDb.MongoDbDriver..ctor(String connectionString, String failOnReadErrors)