magento2gitpod

Magento 2 optimized setup for https://gitpod.io workspace -- Nginx, MySQL (switch to Percona MySQL 8.x available in the menu), PHP 7.4 (older and newer versions available in the menu), PHP-FPM, and a lot more...

Watch full video how you can easily setup Magento 2 Dev environment right in your browser: https://youtu.be/ZydOkPWJPT8

How-to instructions:

1. Register on https://gitpod.io
2. Fork https://github.com/nemke82/magento2gitpod to your repo
3. Install https://chrome.google.com/webstore/detail/gitpod-online-ide/dodmmooeoklaejobgleioelladacbeki?hl=en
4. Load your forked repo and click on green GITPOD button, next to Clone or Download button: http://i.imgur.com/XZCn57y.png

Gitpod will now launch a workspace container for you in the cloud, containing a full Linux system. It will also clone the GitHub repository branch based on the GitHub page you were coming from.

More info: https://www.gitpod.io/docs/10_getting_started/

Services/Tools installed:

• Nginx

• PHP 7.4 based on ppa:ondrej/php repo (https://launchpad.net/~ondrej/+archive/ubuntu/php). To add additional PHP extensions, please update https://github.com/nemke82/magento2gitpod/blob/master/.gitpod.Dockerfile#L15 block. (older and newer versions available in the menu)

• Python (base version)

• rsync

• mc (Midnight commander)

• MySQL (Percona) 5.7 version default. (switch to Percona MySQL 8.x available in the menu)

• xDebug (latest Magento 2 supported version 2.9.8). From menu area select "Start X-Debug" and wait for confirmation. Enables CLI and PHP together, then you can follow https://www.gitpod.io/docs/languages/php/#debugging-php-in-gitpod guidelines.

• Blackfire. Note: Please run ./blackfire-run.sh to enter your Server/Client ID and Token's. Sometimes it requires extra PHP-FPM restart, so please run service php7.2-fpm restart if required.

• Tideways. Note: Please run /usr/bin/tideways-daemon --address 0.0.0.0:9135 & to initiate daemon. Please update .env-file located in repo with TIDEWAYS_APIKEY

• Newrelic. Note: Please run newrelic-daemon -c /etc/newrelic/newrelic.cfg to initiate daemon. Please update .gitpod.Dockerfile (https://github.com/nemke82/magento2gitpod/blob/master/.gitpod.Dockerfile) with license key. Requires Fresh M2 installation (run m2install.sh) or your store to finish process of validation.
  

• Redis. Note: Please run 'redis-server &' to start it or run it without & in the separate tab.

• NodeJS/NPM NVM Manager. Note: run nvm ls-remote to list available versions, then nvm install to install specific version or latest.

• ElasticSearch 5.6.16. Note: Please run following command to start it:
  '$ES_HOME56/bin/elasticsearch -d -p $ES_HOME56/pid -Ediscovery.type=single-node'
  

• ElasticSearch 6.8.9. Note: Please run following command to start it:
  '$ES_HOME68/bin/elasticsearch -d -p $ES_HOME68/pid -Ediscovery.type=single-node'
  

• ElasticSearch 7.9.3. Note: Please run following command to start it:
  '$ES_HOME79/bin/elasticsearch -d -p $ES_HOME79/pid -Ediscovery.type=single-node'
  

  Some extensions like ElasticSuite (https://github.com/Smile-SA/elasticsuite/wiki/ServerConfig-5.x) requires two ElasticSearch plugins to be installed. You can install them with the following commands:
  

  $ES_HOME/bin/elasticsearch-plugin install analysis-phonetic
  $ES_HOME/bin/elasticsearch-plugin install analysis-icu
  

• MFTF (Magento 2 Multi Functional Testing Framework) Follow https://github.com/magento/magento2-functional-testing-framework/blob/develop/docs/getting-started.md guidelines. Installer is here: chmod a+rwx m2-install-solo.sh && bash m2-install-solo.sh

Note: Please run following command to start Selenium and Chromedriver (as required):

java -Dwebdriver.chrome.driver=chromedriver -jar $HOME/selenium-server-standalone-3.141.59.jar &
$HOME/chromedriver &

Every listed service installation code is added within .gitpod.Dockerfile You can split them into separate workspaces and share it among themself if you know what you are doing.

• RabbitMQ support default username/password: guest/guest
  For browser open 15762 browser (already exposed)
  Rest commands can be used as per RabbitMQ guidelines https://www.rabbitmq.com/cli.html

• PWA Studio Support To start installation select field from menu.sh
  or run manually with following command: bash /workspace/magento2gitpod/pwa-studio-installer.sh
  Start service:
  bash /workspace/magento2gitpod/pwa/start.sh &

TO INSTALL Magento 2.4.4 (latest):
./m2-install.sh

For Magento 2.4-dev branch replicated from https://github.com/magento/magento2 please run:
m2-install-solo.sh

MySQL (default settings): username: root
password: nem4540

In case you need to create additional database:
mysql -e 'create database nemanja;'
(where "nemanja" is database name used)

In case you need to adjust certain my.cnf settings, please edit https://github.com/nemke82/magento2gitpod/blob/master/mysql.cnf file and redeploy GitPod workspace.

Discovered bugs: Sometimes it may happen that the exposed port 8002 used for Nginx does not work when tab is loaded in browser. To fix that, either stop/start workspace or destroy it and start process again.

If you are moving your own installation don't foget to adjust following cookie paths:
web/cookie/path to "/"
web/cookie/domain to ".gitpod.io"
web/secure/offloader_header to "X-Forwarded-Proto"

You may fork this repo and boot it on your own server or local computer: https://www.gitpod.io/docs/self-hosted/latest/self-hosted/

Changelog 2020-07-03:

• Updated m2-install.sh script to install latest Magento 2.3.5 version
• Support for ElasticSearch 5.6, 6.8 and 7.8
• Menu installer (menu.sh) added.
• Option to start/stop services from menu.sh file added.
• MySQL (my.cnf) file adjusted with new settings.
• NodeJS/NPM NVM Manager.
• Baler installer added based on https://nemanja.io/optimize-magento-2-store-using-baler-method/ article.
• MagePack installer added based on https://nemanja.io/speed-up-magento-2-page-load-rendering-using-magepack-method/ article.
• MySQL switched to Percona 5.7 (latest). Root password defined (it was not previously). Check above for changes.

Changelog 2020-10-14:

• PHP 7.2 depreciated and left as optional in the Dockerfile
• PHP 7.3 latest support
• php-fpm.conf file updated to use PHP 7.3 latest

Changelog 2020-11-03:

• RabbitMQ Support and integrated to m2-install.sh and m2-install-solo.sh (dev github repo) installations

Changelog 2020-12-11:

• Completely rewritten menu.sh file and it's location (now in the editor area) and labeled.
• menu.sh file updated with Magento 2 Loop cron task.
• Added installer for Magento 2.4.1 using composer and Magento 2.4-develop using Git clone ways.

Changelog 2020-12-15:

• Command lh added. It provides Google lighhouse report as preview in your Gitpod tab. You can check demo here: https://youtu.be/vbPi8zzZyBk

Changelog 2021-04-13:

• Updated m2-install.sh script to install latest Magento 2.4.2 version

Changelog 2021-05-13:

• Added supervisord to the Dockerfile
• MySQL service moved from cold start to supervisord service (type sudo supervisorctl to check all services integrated)

Changelog 2021-05-26:

• Default PHP moved to PHP 7.4

Changelog 2021-07-17:

• Dockerfile heavily refactored as per new sudo instructions (https://www.gitpod.io/docs/config-docker#configure-a-custom-dockerfile)

Changelog 2021-08-06:

• PWA Studio installer added to menu.sh and separate as a bash file pwa-studio-installer.sh

Changelog 2021-12-09:

• CloudBeaver.io SQL tool added to menu.sh and separate as a bash file cloudbeaver.sh

Changelog 2021-12-10:

• MailHog SMTP server added to menu.sh and separate as a bash file mailhog.sh Please watch video how it works: https://youtu.be/AFOtKNPTY0M

Changelog 2022-01-02:

• Happy New year! Support for PHP 7.3 and xDebug 2.9 added for troubleshooting legacy Magento installations. you can start it from menu.sh or as separate process using file: /workspace/magento2gitpod/switch-php73.sh

Changelog 2022-01-09:

• Updated m2-install.sh and m2-install-solo.sh files. Added --no-interaction --no-progress to composer require and composer install due magento/magento2#34831

Changelog 2022-01-15:

• Varnish 6 support with Magento configuration/switch. Start/Stop added to menu.sh menu To purge cache you can execute: curl -X 'PURGE' -H'X-Magento-Tags-Pattern: .*' 127.0.0.1

  also, useful to add invalidation to env.php: php bin/magento setup:config:set --http-cache-hosts=127.0.0.1

Changelog 2022-01-25:

• Composer config added to m2-install.sh installation script to fix --no-interaction mode used when installing Magento

Changelog 2022-02-09:

• php-fpm 7.4 moved to supervisord, you can now reload php-fpm with sudo supervisorctl reload php-fpm command.
• mysql data-directory is moved from /var/lib/mysql to /workspace/magento2gitpod/mysql to make it persistent when workspace times out
• redis and elasticsearch are now automatically started when workspace started using supervisord.

Changelog 2022-04-23:

• PHP 8.1 support. Switch added to menu.sh and separate bash installer switch-php81.sh script
• Installer for Magento 2.4.4 added to menu.sh (2.4.3-p2 installer left active in the menu)
• MySQL 8 support. Switch added to menu.sh and separate bash installer switch-mysql8.sh script

Changelog 2022-05-17:

• Varnish 7.1 support. Switch added to menu.sh and separate bash installer switch-varnish7.sh script

Changelog 2022-06-24:

• m2-install.sh and m2-install-solo.sh scripts updated with web/secure/offloader_header X-Forwarded-Proto to avoid redirect loop. Menu installer remains the same.

Changelog 2022-07-06:

• Blackfire installer updated to support any PHP version used (old or new). You can install it using blackfire-run.sh script or through menu.sh installer.