|
@@ -15,7 +15,8 @@
|
|
|
- [Docker Hub](#docker-hub)
|
|
|
- [Usage](#usage)
|
|
|
- [Prerequisites](#prerequisites)
|
|
|
-- [Quick Setup](#quick-setup)
|
|
|
+- [Setup](#setup)
|
|
|
+- [Updates](#updates)
|
|
|
- [Custom CLI Commands](#custom-cli-commands)
|
|
|
- [Misc Info](#misc-info)
|
|
|
- [Credits](#credits)
|
|
@@ -46,9 +47,9 @@ View Dockerfiles:
|
|
|
- [`1.13-0`](https://github.com/markshust/docker-magento/tree/11.0.0/images/nginx/1.13)
|
|
|
- [markoshust/magento-php (Docker Hub)](https://hub.docker.com/r/markoshust/magento-php/)
|
|
|
- 7.3
|
|
|
- - [`7.3-fpm`](https://github.com/markshust/docker-magento/tree/master/images/php/7.3) - Available for testing on Magento 2.3.3 as of 2019-09-26
|
|
|
+ - [`latest`, `7.3-fpm`, `7.3-fpm-0`](https://github.com/markshust/docker-magento/tree/master/images/php/7.3)
|
|
|
- 7.2
|
|
|
- - [`latest`, `7.2-fpm`, `7.2-fpm-3`](https://github.com/markshust/docker-magento/tree/master/images/php/7.2)
|
|
|
+ - [`7.2-fpm`, `7.2-fpm-3`](https://github.com/markshust/docker-magento/tree/master/images/php/7.2)
|
|
|
- [`7.2-fpm-2`](https://github.com/markshust/docker-magento/tree/23.2.1/images/php/7.2)
|
|
|
- [`7.2-fpm-1`](https://github.com/markshust/docker-magento/tree/23.1.1/images/php/7.2)
|
|
|
- [`7.2-fpm-0`](https://github.com/markshust/docker-magento/tree/23.0.0/images/php/7.2)
|
|
@@ -66,6 +67,9 @@ View Dockerfiles:
|
|
|
- [`7.1-fpm-2`](https://github.com/markshust/docker-magento/tree/13.0.0/images/php/7.1)
|
|
|
- [`7.1-fpm-1`](https://github.com/markshust/docker-magento/tree/11.1.5/images/php/7.1)
|
|
|
- [`7.1-fpm-0`](https://github.com/markshust/docker-magento/tree/11.0.0/images/php/7.1)
|
|
|
+- [markoshust/magento-elasticsearch (Docker Hub)](https://hub.docker.com/r/markoshust/magento-elasticsearch/)
|
|
|
+ - 6.5
|
|
|
+ - [`latest`, `6.5`, `6.5.4-0`](https://github.com/markshust/docker-magento/tree/master/images/elasticsearch/6.5)
|
|
|
|
|
|
## Usage
|
|
|
|
|
@@ -86,7 +90,7 @@ This configuration has been tested on Mac & Linux.
|
|
|
|
|
|
> **Windows Configurations**: The Windows configuration does not currently work and is in need of a contributor to get functional once again. Please see [issue 100](https://github.com/markshust/docker-magento/issues/100) to contribute.
|
|
|
|
|
|
-## Quick Setup
|
|
|
+## Setup
|
|
|
|
|
|
### Automated Setup (New Project)
|
|
|
|
|
@@ -95,10 +99,10 @@ This configuration has been tested on Mac & Linux.
|
|
|
Run this automated one-liner from the directory you want to install your project to:
|
|
|
|
|
|
```bash
|
|
|
-curl -s https://raw.githubusercontent.com/markshust/docker-magento/master/lib/onelinesetup | bash -s -- magento2.test 2.3.2
|
|
|
+curl -s https://raw.githubusercontent.com/markshust/docker-magento/master/lib/onelinesetup | bash -s -- magento2.test 2.3.3
|
|
|
```
|
|
|
|
|
|
-The `magento2.test` above defines the hostname to use, and the `2.3.2` defines the Magento version to install. Note that since we need a write to `/etc/hosts` for DNS resolution, you will be prompted for your system password during setup.
|
|
|
+The `magento2.test` above defines the hostname to use, and the `2.3.3` defines the Magento version to install. Note that since we need a write to `/etc/hosts` for DNS resolution, you will be prompted for your system password during setup.
|
|
|
|
|
|
After the one-liner above completes running, you should be able to access your site at `https://magento2.test`.
|
|
|
|
|
@@ -113,19 +117,19 @@ Same result as the one-liner above. Just replace `magento2.test` references with
|
|
|
curl -s https://raw.githubusercontent.com/markshust/docker-magento/master/lib/template | bash -s -- magento-2
|
|
|
|
|
|
# Download the version of Magento you want to use with:
|
|
|
-bin/download 2.3.2
|
|
|
+bin/download 2.3.3
|
|
|
|
|
|
# or if you'd rather install with Composer, run:
|
|
|
#
|
|
|
# OPEN SOURCE:
|
|
|
#
|
|
|
# rm -rf src
|
|
|
-# composer create-project --repository=https://repo.magento.com/ --ignore-platform-reqs magento/project-community-edition=2.3.2 src
|
|
|
+# composer create-project --repository=https://repo.magento.com/ --ignore-platform-reqs magento/project-community-edition=2.3.3 src
|
|
|
#
|
|
|
# COMMERCE:
|
|
|
#
|
|
|
# rm -rf src
|
|
|
-# composer create-project --repository=https://repo.magento.com/ --ignore-platform-reqs magento/project-enterprise-edition=2.3.2 src
|
|
|
+# composer create-project --repository=https://repo.magento.com/ --ignore-platform-reqs magento/project-enterprise-edition=2.3.3 src
|
|
|
|
|
|
# Create a DNS host entry for the site:
|
|
|
echo "127.0.0.1 magento2.test" | sudo tee -a /etc/hosts
|
|
@@ -177,22 +181,35 @@ open https://magento2.test
|
|
|
|
|
|
> For more details on how everything works, see the extended [setup readme](https://github.com/markshust/docker-magento/blob/master/SETUP.md).
|
|
|
|
|
|
+## Updates
|
|
|
+
|
|
|
+To update your project to the latest version of `docker-magento`, run:
|
|
|
+
|
|
|
+```bin/update```
|
|
|
+
|
|
|
+We recommend keeping your docker config files in version control, so you can monitor the changes to files after updates. After reviewing the code updates and ensuring they updated as intended, run `bin/restart` to restart your containers to have the new configuration take effect.
|
|
|
+
|
|
|
+It is recommended to keep your root docker config files in one repository, and your Magento code setup in another. This ensures the Magento base path lives at the top of one specific repository, which makes automated build pipelines and deployments easy to manage, and maintains compatibility with projects such as Magento Cloud.
|
|
|
+
|
|
|
## Custom CLI Commands
|
|
|
|
|
|
- `bin/bash`: Drop into the bash prompt of your Docker container. The `phpfpm` container should be mainly used to access the filesystem within Docker.
|
|
|
-- `bin/dev-urn-catalog-generate`: Generate URN's for PHPStorm and remap paths to local host. Restart PHPStorm after running this command.
|
|
|
- `bin/cli`: Run any CLI command without going into the bash prompt. Ex. `bin/cli ls`
|
|
|
- `bin/clinotty`: Run any CLI command with no TTY. Ex. `bin/clinotty chmod u+x bin/magento`
|
|
|
- `bin/composer`: Run the composer binary. Ex. `bin/composer install`
|
|
|
- `bin/copyfromcontainer`: Copy folders or files from container to host. Ex. `bin/copyfromcontainer vendor`
|
|
|
- `bin/copytocontainer`: Copy folders or files from host to container. Ex. `bin/copytocontainer --all`
|
|
|
-- `bin/download`: Download & extract specific Magento version to the `src` directory. Ex. `bin/download 2.3.2`
|
|
|
+- `bin/dev-urn-catalog-generate`: Generate URN's for PHPStorm and remap paths to local host. Restart PHPStorm after running this command.
|
|
|
+- `bin/devconsole`: Alias for `bin/n98-magerun2 dev:console`
|
|
|
+- `bin/download`: Download & extract specific Magento version to the `src` directory. Ex. `bin/download 2.3.3`
|
|
|
- `bin/fixowns`: This will fix filesystem ownerships within the container.
|
|
|
- `bin/fixperms`: This will fix filesystem permissions within the container.
|
|
|
- `bin/grunt`: Run the grunt binary. Note that this runs the version from the node_modules directory for project version parity. Ex. `bin/grunt exec`
|
|
|
- `bin/magento`: Run the Magento CLI. Ex: `bin/magento cache:flush`
|
|
|
+- `bin/n98-magerun2`: Access the n98 magerun CLI. Ex: `bin/n98-magerun2 dev:console`
|
|
|
- `bin/node`: Run the node binary. Ex. `bin/node --version`
|
|
|
- `bin/npm`: Run the npm binary. Ex. `bin/npm install`
|
|
|
+- `bin/pwa-studio`: (BETA) Start the PWA Studio server. Note that Chrome will throw SSL cert errors and not allow you to view the site, but Firefox will.
|
|
|
- `bin/redis`: Run a command from the redis container. Ex `bin/redis redis-cli monitor`
|
|
|
- `bin/remove`: Remove all containers.
|
|
|
- `bin/removevolumes`: Remove all volumes.
|
|
@@ -200,9 +217,11 @@ open https://magento2.test
|
|
|
- `bin/root`: Run any CLI command as root without going into the bash prompt. Ex `bin/root apt-get install nano`
|
|
|
- `bin/rootnotty`: Run any CLI command as root with no TTY. Ex `bin/rootnotty chown -R app:app /var/www/html`
|
|
|
- `bin/setup`: Run the Magento setup process to install Magento from the source code, with optional domain name. Defaults to `magento2.test`. Ex. `bin/setup magento2.test`
|
|
|
+- `bin/setup-pwa-studio`: (BETA) Install PWA Studio (requires NodeJS and Yarn to be installed on the host machine). Pass in your base site domain, otherwise the default `master-7rqtwti-mfwmkrjfqvbjk.us-4.magentosite.cloud` will be used. Ex: `bin/setup-pwa-studio magento2.test`
|
|
|
- `bin/start`: Start all containers, good practice to use this instead of `docker-compose up -d`, as it may contain additional helpers.
|
|
|
- `bin/status`: Check the container status.
|
|
|
- `bin/stop`: Stop all containers.
|
|
|
+- `bin/update`: Update your project to the most recent version of `docker-magento`.
|
|
|
- `bin/xdebug`: Disable or enable Xdebug. Accepts params `disable` (default) or `enable`. Ex. `bin/xdebug enable`
|
|
|
|
|
|
## Misc Info
|