get, build, initialize and run SAP Hybris Commerce Suite inside Docker container
It's unofficial PoC for experimental purposes! It's not supported by SAP Hybris! Do NOT use it in production!
Read a blog post about dockerizing Hybris.
Please note: Since version 6.3 Hybris has built-in recipes with Docker support and it's recommended solution. This repository contains only unofficial Proof of Concept with development setup.
- Quick start
- Usage
- Installing Docker
- Resolving problems with Docker
- Server endpoints
- Platform build version
- Remarks
- Testing
- References
- License
If you have already installed Docker and Git, just open the terminal and do the following things:
git clone https://github.com/pwittchen/ydocker.git
cd ydocker/
./ydocker -b
Provide your credentials and wait while container is being created. It may take about 30 minutes or more.
When it's done, run the server with the following command:
./ydocker -r
Wait a while, let the server to start up and then check if everything works by visitng the following URL:
https://localhost:9002/backoffice
That's it!
If you haven't installed Docker yet, go to the section about installing Docker first.
You can use helper shell script called ydocker
with the following parameters:
-b building Docker container
-r running Hybris Server in Docker container
-c running Docker container with CLI
-i showing info about Docker container
-u showing Commerce Suite Download Url
-d deleting Docker container
-h showing help
Inside .ydocker.conf
file you can view or customize the following parameters:
- Docker image name
- Commerce Suite version (set
latest
to keep your software fresh - you can also set specific version like6.2
; in the latest releases versioning style was changed, solatest
may not refer to the latest version - it's recommended to specify the concrete version - e.g.18.08
) - Artifact type (
snapshot
orrelease
) - Recipe
- Host port
- Container port
Please remember that you need to have your own SAP e-mail and password in order to be able to download SAP Hybris Commerce Suite from Hybris repository inside Docker container.
If you haven't installed Docker yet, follow instructions below.
If you are using Ubuntu Linux and want to install Docker, follow official instructions for Installation on Ubuntu from the Docker website.
If you are using macOS and want to install Docker, get Docker for Mac from the official Docker website.
When you get the following message: cannot connect to docker daemon
:
- Make sure that Docker daemon is running by typing:
sudo service docker status
- If Docker daemon is stopped, type:
sudo service docker start
- Type
sudo
before every Docker command (works on Ubuntu Linux)
When you get the following message: port is already allocated
:
- Restart Docker daemon by typing:
sudo service docker restart
and run container again (works on Ubuntu Linux)
- Hybris Administration Console (HAC):
https://localhost:9002/
- Backoffice:
https://localhost:9002/backoffice
- B2C accelerator:
https://localhost:9002/yacceleratorstorefront/en/?site=apparel-uk&clear=true
To get information about build and version of the platform inside created container, use the following commands:
./ydocker -c
cat /home/sap-hybris-commerce-suite/hybris/bin/platform/build.number
This repository does not contain any source code or libraries of SAP Hybris Commerce Suite. It just downloads them, if you provide valid credentials to the shell script. You should have such credentials if you're company employee or partner. You'll need a lot of space on disk (probably about 12 GB, but I think 15 GB is safe number), because Commerce Suite is huge project. Size of built container is 6.8 GB. Moreover, it's not official company's repository. It's just proof of concept and may be not fully functional and stable.
This solution was tested on the following systems:
- Ubuntu Linux 14.04 LTS
- OS X El Capitan 10.11.6
Building container and running the application went fine. Docker was installed according to the official instructions.
- https://github.com/pwittchen/learning-docker
- https://github.com/wsargent/docker-cheat-sheet
- http://wittchen.io/2016/07/27/dockerizing-hybris/
- https://github.com/pwittchen/ydownloader
- https://github.com/stefanleh/hybris-base-image
- https://github.com/stefanleh/hybris-mysql
- https://github.com/stefanleh/hybris-datahub-mysql
- https://github.com/debianmaster/docker-hybris
- https://github.com/prelegalwonder/hybris-docker
- https://github.com/mlong168/hybris-docker
- https://github.com/mcastellin/docker-hybris
Copyright 2016 Piotr Wittchen
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.