-
-
Notifications
You must be signed in to change notification settings - Fork 257
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
28 changed files
with
631 additions
and
37 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1 +1,2 @@ | ||
.bash_history | ||
node_modules |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,56 @@ | ||
FROM alexcheng/apache2-php7:{{phpVersion}} | ||
|
||
LABEL maintainer="[email protected]" | ||
LABEL version="{{magento2Version}}" | ||
LABEL description="Magento {{magento2Version}}" | ||
|
||
ENV MAGENTO_VERSION {{magento2Version}} | ||
ENV INSTALL_DIR /var/www/html | ||
ENV COMPOSER_HOME /var/www/.composer/ | ||
|
||
RUN curl -sS https://getcomposer.org/installer | php \ | ||
&& mv composer.phar /usr/local/bin/composer | ||
COPY ./auth.json $COMPOSER_HOME | ||
|
||
RUN requirements="libpng12-dev libmcrypt-dev libmcrypt4 libcurl3-dev libfreetype6 libjpeg-turbo8 libjpeg-turbo8-dev libpng12-dev libfreetype6-dev libicu-dev libxslt1-dev" \ | ||
&& apt-get update \ | ||
&& apt-get install -y $requirements \ | ||
&& rm -rf /var/lib/apt/lists/* \ | ||
&& docker-php-ext-install pdo_mysql \ | ||
&& docker-php-ext-configure gd --with-freetype-dir=/usr/include/ --with-jpeg-dir=/usr/include/ \ | ||
&& docker-php-ext-install gd \ | ||
&& docker-php-ext-install mcrypt \ | ||
&& docker-php-ext-install mbstring \ | ||
&& docker-php-ext-install zip \ | ||
&& docker-php-ext-install intl \ | ||
&& docker-php-ext-install xsl \ | ||
&& docker-php-ext-install soap \ | ||
&& requirementsToRemove="libpng12-dev libmcrypt-dev libcurl3-dev libpng12-dev libfreetype6-dev libjpeg-turbo8-dev" \ | ||
&& apt-get purge --auto-remove -y $requirementsToRemove | ||
|
||
RUN chsh -s /bin/bash www-data | ||
|
||
{{{magento2Installation}}} | ||
|
||
RUN cd $INSTALL_DIR \ | ||
&& find . -type d -exec chmod 770 {} \; \ | ||
&& find . -type f -exec chmod 660 {} \; \ | ||
&& chmod u+x bin/magento | ||
|
||
COPY ./install-magento /usr/local/bin/install-magento | ||
RUN chmod +x /usr/local/bin/install-magento | ||
|
||
COPY ./install-sampledata /usr/local/bin/install-sampledata | ||
RUN chmod +x /usr/local/bin/install-sampledata | ||
|
||
RUN a2enmod rewrite | ||
RUN echo "memory_limit=2048M" > /usr/local/etc/php/conf.d/memory-limit.ini | ||
|
||
RUN apt-get clean && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* | ||
|
||
WORKDIR $INSTALL_DIR | ||
|
||
# Add cron job | ||
ADD crontab /etc/cron.d/magento2-cron | ||
RUN chmod 0644 /etc/cron.d/magento2-cron \ | ||
&& crontab -u www-data /etc/cron.d/magento2-cron |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -5,3 +5,164 @@ | |
[![Docker build](http://dockeri.co/image/alexcheng/magento2)](https://hub.docker.com/r/alexcheng/magento2/) | ||
|
||
This repo converts the [long installation guide](http://devdocs.magento.com/guides/v1.0/install-gde/bk-install-guide.html) of Magento 2 into simple Docker image to use. It uses the same convention as my [Docker image for Magento 1.x](https://github.com/alexcheng1982/docker-magento). | ||
|
||
For documentation, please refer to the Magento 1.x [repo](https://github.com/alexcheng1982/docker-magento). These two Docker images follow the same instructions. | ||
|
||
__Note__ This docker image uses the *Contributing developer* profile to install Magento, so it has limitations. See more details [here](http://devdocs.magento.com/guides/v2.0/install-gde/bk-install-guide.html). | ||
|
||
**Please note: this Docker image is for development and testing only, not for production use. Setting up a Magento 2 production server requires more configurations. Please refer to [official documentations](http://devdocs.magento.com/guides/v2.2/config-guide/deployment/).** | ||
|
||
## Magento 2 installation types | ||
|
||
Magento 2 has three different ways to [install](http://devdocs.magento.com/guides/v2.0/install-gde/bk-install-guide.html), for users, integrators and developers. This Docker image uses **integrator** as the default installation type, so the **Web Setup Wizard** can be used. For each version, both integrator and developer installation types are available. The user installation type is not currently supported. | ||
|
||
For example, Magento 2 version `2.2.2` has tag `2.2.2`, `2.2.2-integrator` and `2.2.2-developer`. `2.2.2` is the same as `2.2.2-integrator`. | ||
|
||
Below are some basic instructions. | ||
|
||
## Quick start | ||
|
||
The easiest way to start Magento 2 with MySQL is using [Docker Compose](https://docs.docker.com/compose/). Just clone this repo and run following command in the root directory. The default `docker-compose.yml` uses MySQL and phpMyAdmin. | ||
|
||
~~~ | ||
$ docker-compose up -d | ||
~~~ | ||
|
||
For admin username and password, please refer to the file `env`. You can also update the file `env` to update those configurations. Below are the default configurations. | ||
|
||
~~~ | ||
MYSQL_HOST=db | ||
MYSQL_ROOT_PASSWORD=myrootpassword | ||
MYSQL_USER=magento | ||
MYSQL_PASSWORD=magento | ||
MYSQL_DATABASE=magento | ||
MAGENTO_LANGUAGE=en_GB | ||
MAGENTO_TIMEZONE=Pacific/Auckland | ||
MAGENTO_DEFAULT_CURRENCY=NZD | ||
MAGENTO_URL=http://local.magento | ||
MAGENTO_BACKEND_FRONTNAME=admin | ||
MAGENTO_USE_SECURE=0 | ||
MAGENTO_BASE_URL_SECURE=0 | ||
MAGENTO_USE_SECURE_ADMIN=0 | ||
MAGENTO_ADMIN_FIRSTNAME=Admin | ||
MAGENTO_ADMIN_LASTNAME=MyStore | ||
[email protected] | ||
MAGENTO_ADMIN_USERNAME=admin | ||
MAGENTO_ADMIN_PASSWORD=magentorocks1 | ||
~~~ | ||
|
||
For example, if you want to change the default currency, just update the variable `MAGENTO_DEFAULT_CURRENCY`, e.g. `MAGENTO_DEFAULT_CURRENCY=USD`. | ||
|
||
You can find all available options in the official [setup guide](http://devdocs.magento.com/guides/v2.0/install-gde/install/cli/install-cli-install.html#instgde-install-cli-magento). If you need more options, fork this repo and add them in `bin\install-magento`. | ||
|
||
Please see the following video for a quick demo. | ||
|
||
[![Use Magento 2 with Docker](https://img.youtube.com/vi/18tOf_cuQKg/hqdefault.jpg)](https://www.youtube.com/watch?v=18tOf_cuQKg "Use Magento 2 with Docker") | ||
|
||
## Installation | ||
|
||
After starting the container, you'll see the setup page of Magento 2. You can use the script `install-magento` to quickly install Magento 2. The installation script uses the variables in the `env` file. | ||
|
||
### Magento 2 | ||
|
||
~~~ | ||
$ docker exec -it <container_name> install-magento | ||
~~~ | ||
|
||
### Sample data | ||
|
||
~~~ | ||
$ docker exec -it <container_name> install-sampledata | ||
~~~ | ||
|
||
**Please note:** Sample data for Magento 2.2.2 doesn't work at the moment, see [this issue](https://github.com/alexcheng1982/docker-magento2/issues/11). | ||
|
||
### Database | ||
|
||
The default `docker-compose.yml` uses MySQL as the database and starts [phpMyAdmin](https://www.phpmyadmin.net/). The default URL for phpMyAdmin is `http://localhost:8580`. Use MySQL username and password to log in. | ||
|
||
## FAQ | ||
|
||
### Where is the database? | ||
|
||
Magento 2 cannot run with a database. This image is for Magento 2 only. It doesn't contain MySQL server. MySQL server should be started in another container and linked with Magento 2 container. It's recommended to use Docker Compose to start both containers. You can also use [Kubernetes](https://kubernetes.io/) or other tools. | ||
|
||
### Why accessing http://local.magento? | ||
|
||
For development and testing in the local environment, using `localhost` as Magento 2 URL has some issues. The default `env` file use `http://local.magento` as the value of `MAGENTO_URL`. You need to [edit your `hosts` file](https://support.rackspace.com/how-to/modify-your-hosts-file/) to add the mapping from `local.magento` to `localhost`. You can use any domain names as long as it looks like a real domain, not `localhost`. | ||
|
||
If `localhost` doesn't work, try using `127.0.0.1`. | ||
|
||
``` | ||
127.0.0.1 local.magento | ||
``` | ||
|
||
### How to update Magento 2 installation configurations? | ||
|
||
Depends on how the container is used, | ||
|
||
* When using the GUI setup page of Magento 2, update configurations in the UI. | ||
* When using the script, update configurations in the `env` file. | ||
* When starting Magento 2 as a standalone container, use `-e` to pass environment variables. | ||
|
||
### Why getting access denied error after changing the default DB password? | ||
|
||
If you change the default DB password in `env` file and get the access denied error when installing Magento 2, see [this issue comment](https://github.com/alexcheng1982/docker-magento2/issues/10#issuecomment-355382150). | ||
|
||
## Develop and test using this Docker image | ||
|
||
As I mentioned before, this Docker image is primarily used for development and testing. Depends on the tasks you are trying to do, there are different ways to use this Docker image. | ||
|
||
### Extensions and themes | ||
|
||
You can keep the extensions and themes directories on your local host machine, and use Docker Compose [volumes](https://docs.docker.com/compose/compose-file/#volumes) to install the extensions and themes. For example, if you have a theme in the directory `/dev/mytheme`, you can install it by specifying it in the `docker-composer.yml` file. Then you can see the theme in Magento admin UI. | ||
|
||
```yml | ||
version: '3.0' | ||
services: | ||
web: | ||
image: alexcheng/magento2 | ||
ports: | ||
- "80:80" | ||
links: | ||
- db | ||
env_file: | ||
- env | ||
volumes: | ||
- /dev/mytheme:/var/www/html/app/design/frontend/mytheme/default | ||
db: | ||
image: mysql:5.6.23 | ||
volumes: | ||
- db-data:/var/lib/mysql/data | ||
env_file: | ||
- env | ||
phpmyadmin: | ||
image: phpmyadmin/phpmyadmin | ||
ports: | ||
- "8580:80" | ||
links: | ||
- db | ||
volumes: | ||
db-data: | ||
``` | ||
### Modify Magento core files | ||
If you want to modify Magento core files, you cannot modify them directly in the container. Those changes will be lost. It's also not recommended to update Magento core files directly, which makes upgrading Magento a painful process. Actually, Docker makes the process much easier if you absolutely need to modify some core files. You can use volumes to overwrite files. | ||
For example, if you want to overwrite the file `app/code/Magento/Catalog/Block/Product/Price.php`, you can copy the content to a new file in your local directory `/dev/mycode/magento_2_2` and make the changes, then use `volumes` to overwrite it. | ||
|
||
```yml | ||
volumes: | ||
- /dev/mycode/magento_2_2/app/code/Magento/Catalog/Block/Product/Price.php:/var/www/html/app/code/Magento/Catalog/Block/Product/Price.php | ||
``` | ||
|
||
By using Docker, we can make sure that all your changes to Magento core files are kept in one place and tracked in source code repository. These changes are also correctly aligned with different Magento versions. | ||
|
||
When deploying those changes to production servers, we can simply copy all files in the `/dev/mycode/magento_2_2` directory to Magento installation directory and overwrite existing files. | ||
|
||
### Test Magento compatibilities | ||
|
||
This Docker images has different tags for corresponding Magento versions, e.g. `2.2.1`, `2.2.2`. You can switch to different Magento versions very easily when testing extensions and themes. |
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,3 @@ | ||
* * * * * www-data /usr/local/bin/php /var/www/html/bin/magento cron:run | grep -v "Ran jobs by schedule" >> /var/www/html/var/log/magento.cron.log | ||
* * * * * www-data /usr/local/bin/php /var/www/html/bin/magento indexer:reindex | ||
{{{extraCronJobs}}} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,63 @@ | ||
FROM alexcheng/apache2-php7:7.0.24 | ||
|
||
LABEL maintainer="[email protected]" | ||
LABEL version="2.0.17" | ||
LABEL description="Magento 2.0.17" | ||
|
||
ENV MAGENTO_VERSION 2.0.17 | ||
ENV INSTALL_DIR /var/www/html | ||
ENV COMPOSER_HOME /var/www/.composer/ | ||
|
||
RUN curl -sS https://getcomposer.org/installer | php \ | ||
&& mv composer.phar /usr/local/bin/composer | ||
COPY ./auth.json $COMPOSER_HOME | ||
|
||
RUN requirements="libpng12-dev libmcrypt-dev libmcrypt4 libcurl3-dev libfreetype6 libjpeg-turbo8 libjpeg-turbo8-dev libpng12-dev libfreetype6-dev libicu-dev libxslt1-dev" \ | ||
&& apt-get update \ | ||
&& apt-get install -y $requirements \ | ||
&& rm -rf /var/lib/apt/lists/* \ | ||
&& docker-php-ext-install pdo_mysql \ | ||
&& docker-php-ext-configure gd --with-freetype-dir=/usr/include/ --with-jpeg-dir=/usr/include/ \ | ||
&& docker-php-ext-install gd \ | ||
&& docker-php-ext-install mcrypt \ | ||
&& docker-php-ext-install mbstring \ | ||
&& docker-php-ext-install zip \ | ||
&& docker-php-ext-install intl \ | ||
&& docker-php-ext-install xsl \ | ||
&& docker-php-ext-install soap \ | ||
&& requirementsToRemove="libpng12-dev libmcrypt-dev libcurl3-dev libpng12-dev libfreetype6-dev libjpeg-turbo8-dev" \ | ||
&& apt-get purge --auto-remove -y $requirementsToRemove | ||
|
||
RUN chsh -s /bin/bash www-data | ||
|
||
RUN cd /tmp && \ | ||
curl https://codeload.github.com/magento/magento2/tar.gz/$MAGENTO_VERSION -o $MAGENTO_VERSION.tar.gz && \ | ||
tar xvf $MAGENTO_VERSION.tar.gz && \ | ||
mv magento2-$MAGENTO_VERSION/* magento2-$MAGENTO_VERSION/.htaccess $INSTALL_DIR | ||
|
||
RUN chown -R www-data:www-data /var/www | ||
RUN su www-data -c "cd $INSTALL_DIR && composer install" | ||
RUN su www-data -c "cd $INSTALL_DIR && composer config repositories.magento composer https://repo.magento.com/" | ||
|
||
RUN cd $INSTALL_DIR \ | ||
&& find . -type d -exec chmod 770 {} \; \ | ||
&& find . -type f -exec chmod 660 {} \; \ | ||
&& chmod u+x bin/magento | ||
|
||
COPY ./install-magento /usr/local/bin/install-magento | ||
RUN chmod +x /usr/local/bin/install-magento | ||
|
||
COPY ./install-sampledata /usr/local/bin/install-sampledata | ||
RUN chmod +x /usr/local/bin/install-sampledata | ||
|
||
RUN a2enmod rewrite | ||
RUN echo "memory_limit=2048M" > /usr/local/etc/php/conf.d/memory-limit.ini | ||
|
||
RUN apt-get clean && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* | ||
|
||
WORKDIR $INSTALL_DIR | ||
|
||
# Add cron job | ||
ADD crontab /etc/cron.d/magento2-cron | ||
RUN chmod 0644 /etc/cron.d/magento2-cron \ | ||
&& crontab -u www-data /etc/cron.d/magento2-cron |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,8 @@ | ||
{ | ||
"http-basic": { | ||
"repo.magento.com": { | ||
"username": "5310458a34d580de1700dfe826ff19a1", | ||
"password": "255059b03eb9d30604d5ef52fca7465d" | ||
} | ||
} | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,3 @@ | ||
* * * * * www-data /usr/local/bin/php /var/www/html/bin/magento cron:run | grep -v "Ran jobs by schedule" >> /var/www/html/var/log/magento.cron.log | ||
* * * * * www-data /usr/local/bin/php /var/www/html/bin/magento indexer:reindex | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,7 @@ | ||
#!/usr/bin/env bash | ||
|
||
su www-data <<EOSU | ||
/var/www/html/bin/magento setup:install --base-url=$MAGENTO_URL --backend-frontname=$MAGENTO_BACKEND_FRONTNAME --language=$MAGENTO_LANGUAGE --timezone=$MAGENTO_TIMEZONE --currency=$MAGENTO_DEFAULT_CURRENCY --db-host=$MYSQL_HOST --db-name=$MYSQL_DATABASE --db-user=$MYSQL_USER --db-password=$MYSQL_PASSWORD --use-secure=$MAGENTO_USE_SECURE --base-url-secure=$MAGENTO_BASE_URL_SECURE --use-secure-admin=$MAGENTO_USE_SECURE_ADMIN --admin-firstname=$MAGENTO_ADMIN_FIRSTNAME --admin-lastname=$MAGENTO_ADMIN_LASTNAME --admin-email=$MAGENTO_ADMIN_EMAIL --admin-user=$MAGENTO_ADMIN_USERNAME --admin-password=$MAGENTO_ADMIN_PASSWORD | ||
EOSU |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,24 @@ | ||
version: '3.0' | ||
services: | ||
web: | ||
image: alexcheng/magento2 | ||
ports: | ||
- "80:80" | ||
links: | ||
- db | ||
env_file: | ||
- env | ||
db: | ||
image: mysql:5.6.23 | ||
volumes: | ||
- db-data:/var/lib/mysql/data | ||
env_file: | ||
- env | ||
phpmyadmin: | ||
image: phpmyadmin/phpmyadmin | ||
ports: | ||
- "8580:80" | ||
links: | ||
- db | ||
volumes: | ||
db-data: |
Oops, something went wrong.