SC 10.3 XM1 Docker install SPE fails and leaves server in invalid state

[jbaarsch2]

SC 10.3 XM1 Docker install SPE fails and leaves server in invalid state

[jbaarsch2]

Roger that Batman, updating the documentation would be prudent in this regard. I can take a stab at updating. I agree layering in with a custom Dockerfile would be the best path. However, I am trying to follow the guides to see how a uninitiated dev would stumble. Thank you both!

[michaellwest]

@jbaarsch2 I updated the installation page with some more details. Please let me know what other details you would like to see.

https://doc.sitecorepowershell.com/installation

[jbaarsch2]

I logged on this morning to update, but it looks like you beat me to it! Above and beyond as usual Mr. West, far more detailed and helpful than what I was going adjust. Hats off to you!

[bic742]

You shouldn't be installing SPE via the package. You should be layering it into your image via a Dockerfile and the asset image.

[jbaarsch2]

If that is the case, then we should update the documentation for SPE to not install it as a package, correct?
https://doc.sitecorepowershell.com/installation

Or are you saying, installing as a package should work, as long as you are not using docker? If that is the case, we should call that out in the documentation imo

[bic742]

Not necessarily. The package would be used for OnPrem instances of Sitecore. The Docker process is different. The linked documentation hasn't been modified in 2 years, so it still reflects the basic package installation steps.

The documentation is open source, along with the module. If you feel there is a gap in what is there, PR's are welcome. :)

[michaellwest]

Yes, the documentation should include details for Docker setup. The existing documentation would still be valid for installations not containerized. Pull Requests are welcome.

[michaellwest]

The issue you are encountering trying to install the module package through the installation wizard is a general problem with containers. Typical solutions include deploying to a folder where a watcher copies it to the web root or you layer in the files in a custom container image.