Skip to content

Latest commit

 

History

History
42 lines (25 loc) · 2.8 KB

STARTERKIT_INSTRUCTIONS.md

File metadata and controls

42 lines (25 loc) · 2.8 KB

Docker Hackathon "Starter-kit"

This year we have included a simple starter-kit that generates a preconfigured docker-compose environment that you can use for the Hackathon.

It is not required to use the starter-kit or Docker as long as all entry submission requirements are met.
Do not spend time on the starter-kit if you do not have any previous experience with running Sitecore on Docker.

If you do not want to use the starter-kit, you can delete the entire .\_StarterKit folder from your repository along with the .ps1 files in the solution root.

You are also completely free to make any adjustments that is needed for your submission to the generated setup . Just keep it simple, please.

Prerequisites

Refer to the prerequisites from the Sitecore Getting Started template walk-through.

It is recommended to have followed this walk-through succesfully on each machine that will make use of this Starter-kit to ensure all prerequisites are in place.

Initial setup

If you have IIS running then stop it by running iisreset /stop or open 'IIS manager' > right click computername > 'Stop'

  1. Open a powershell terminal as Administrator
  2. Navigate to this folder and run .\Start-Hackathon.ps1
  3. Follow on-screen instructions
  4. Test, git commit and push so other team members can pull the generated setup
  5. Other team members should then git pull and run .\Start-Hackathon.ps1 to generate locally trusted certificates and add hosts entries

If setup fails or you need to re-run the setup wizard for other reasons then run .\Remove-Starterkit.ps1 to reset and run .\Start-Hackathon.ps1 again.

After the initial setup .\Start-Hackathon.ps1 can be used to bring up the containers - similar to manually running .\docker-compose up -d from the .\docker folder.

To take the containers down again you can use .\Stop-Hackathon.ps1 - this calls docker-compose down followed by docker system prune. This can sometime help if you experience issues with the Sitecore containers not starting up or do not respond after computer has been turned off or put in Sleep-mode.

If the certificates are invalid then make sure that the mkcert self-signed root certificate is in Local Machine > Trusted root certificates.

Deviations from Sitecore Docker examples

docker-compose files has been moved the .\docker folder to keep the solution root clean.

all images has Sitecore Powershell Extensions pre-installed

yask for Sitecore

This "starter-kit" has evolved into yet another Starter-kit for Sitecore. If you have any input, suggestions or other and would like to contribute to it's further development please check out this repository