{"id":18948382,"url":"https://github.com/oxid-esales/docker-eshop-sdk-recipes","last_synced_at":"2025-04-15T23:30:51.029Z","repository":{"id":43299977,"uuid":"452445963","full_name":"OXID-eSales/docker-eshop-sdk-recipes","owner":"OXID-eSales","description":"Oxid eShop setup recipes","archived":false,"fork":false,"pushed_at":"2024-10-25T10:42:32.000Z","size":378,"stargazers_count":20,"open_issues_count":0,"forks_count":6,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-10-25T15:46:47.490Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OXID-eSales.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-01-26T21:25:30.000Z","updated_at":"2024-10-25T10:42:36.000Z","dependencies_parsed_at":"2023-10-11T18:28:15.128Z","dependency_job_id":"289ccef3-84ce-4739-9ba3-6087bc28fb91","html_url":"https://github.com/OXID-eSales/docker-eshop-sdk-recipes","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OXID-eSales%2Fdocker-eshop-sdk-recipes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OXID-eSales%2Fdocker-eshop-sdk-recipes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OXID-eSales%2Fdocker-eshop-sdk-recipes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OXID-eSales%2Fdocker-eshop-sdk-recipes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OXID-eSales","download_url":"https://codeload.github.com/OXID-eSales/docker-eshop-sdk-recipes/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223688674,"owners_count":17186298,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-08T13:13:21.790Z","updated_at":"2024-11-08T13:13:22.841Z","avatar_url":"https://github.com/OXID-eSales.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OXID eShop Setup Recipes\n\nRecipes used together with https://github.com/OXID-eSales/docker-eshop-sdk for an OXID eShop development environment.\n\n## Prerequirements\n\nCheck if other docker projects are stopped! If you have something running, ports may conflict and nothing will work as intended!\n\nFor recipes that involves private repositories, you will need the Github token which have access to those repositories.\nIn case Github credentials are asked, put your username and the **Github Token in place of password**!\n\nUse other then **root** user, as composer and other parts of the system (like php container) may be very unhappy meeting one!\n\nAlso, consider preconfiguring the git authentication to be cached globally. It will help a lot with recipes where several private repositories are involved:\n```\ngit config --global credential.helper cache\n```\n\n### Linux / MacOS\n\n- Docker and Docker-Compose\n- Makefile\n- PERL. Try if you have it installed with `perl -v`\n- `127.0.0.1 localhost.local` added to `/etc/hosts`\n\n### Windows\n\n- Windows Subsystem for Linux:\n  - Install with `wsl --install -d Ubuntu`, reboot and add your Linux user\n  - Update with `sudo apt update \u0026\u0026 apt upgrade`\n  - Install Makefile with `sudo apt install make`\n- Docker Desktop for Windows with WSL2 backend enabled\n- `127.0.0.1 localhost.local` added to `%windir%\\system32\\drivers\\etc\\hosts`\n\n## Installation instructions:\n\n1. Clone the SDK to ``MyProject`` directory in this case:\n```\necho MyProject \u0026\u0026 git clone https://github.com/OXID-eSales/docker-eshop-sdk.git $_ \u0026\u0026 cd $_\n```\n\n2. Clone recipes\n```\ngit clone --recurse-submodules https://github.com/OXID-eSales/docker-eshop-sdk-recipes recipes/oxid-esales\n```\n\n3. And last - run the desired recipe, for example:\n```\n./recipes/oxid-esales/shop/b-6.5.x-ce-dev/run.sh\n```\n\n## Parts directory is a submodule\n\nThe ``parts`` directory is used as a git submodule. It has its own repository for easier reuse between\ndifferent recipes.\n\nTo pull the latest changes from parts repository and update the link, you can use the following commands by being in the current repository root:\n\n```\ngit submodule update --remote\ngit commit -am \"Update parts submodule to latest\"\n```\n\nBe careful with the changes in the parts repository, as they may affect all **recipes** using it.\nAlso be careful with pushing changes to the parts repository, as it may affect all **repositories** using it.\n\n## Multiserver configuration\n\nTo experiment with multiserver configuration locally you can run either the full recipe example - ``shop/b-7.1.x-apex-multiserver.sh`` - or add the load balancing setup to an existing docker-compose.yml using ``parts/shared/create_multiserver_setup.sh``. This script will accept the ``-c=\u003csome number\u003e`` argument if you want to specify a number of frontend php containers. It will create two by default.\n\nIf you wish to run the part script on an existing docker configuration, you will need to manually cleanup the blocks for all services included in ``services/loadbalancer.yml`` as well as any numbered frontend containers if it has been run before in your setup.\n\n## 6.4 recipes\n\nThe recipes for 6.4 modules are available in recipes b-6.4.x-branch. Please check it out, if you want to use those\nrecipes.\n\n\u003e **_NOTE:_** Don not forget that version 6.4 is not supported anymore.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foxid-esales%2Fdocker-eshop-sdk-recipes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foxid-esales%2Fdocker-eshop-sdk-recipes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foxid-esales%2Fdocker-eshop-sdk-recipes/lists"}