added documentation for redis sessions

fballiano · web-flow · commit 9828df3507bf · 2019-08-06T12:20:10.000+01:00
diff --git a/README.md b/README.md
@@ -2,12 +2,13 @@
 
 ## Infrastructure overview
 * Container 1: MariaDB
-* Container 2: Redis (for Magento's cache)
-* Container 3: Apache 2.4 + PHP 7.2 (modphp)
-* Container 4: Cron
-* Container 5: Varnish 5
-* Container 6: Redis (for autodiscovery cluster nodes)
-* Container 7: Nginx SSL terminator
+* Container 2: Redis (volatile, for Magento's cache)
+* Container 3: Redis (for Magento's sessions)
+* Container 4: Apache 2.4 + PHP 7.2 (modphp)
+* Container 5: Cron
+* Container 6: Varnish 5
+* Container 7: Redis (volatile, cluster nodes autodiscovery)
+* Container 8: Nginx SSL terminator
 
 ### Why a separate cron container?
 First of all containers should be (as far as possible) single process, but the most important thing is that (if someday we'll be able to deploy this infrastructure in production) we may need a cluster of apache+php containers but a single cron container running.
@@ -92,6 +93,46 @@ rm -rf magento2/var/cache/*
 ```
 from now on the var/cache directory should stay empty cause all the caches should be stored in Redis.
 
+## Enable Redis for Magento's sessions
+open magento2/app/etc/env.php and replace these lines:
+```php
+'session' => [
+  'save' => 'files',
+],
+```
+
+with these ones:
+
+```php
+'session' => [
+  'save' => 'redis',
+  'redis' => [
+    'host' => 'sessions',
+    'port' => '6379',
+    'password' => '',
+    'timeout' => '2.5',
+    'persistent_identifier' => '',
+    'database' => '0',
+    'compression_threshold' => '2048',
+    'compression_library' => 'gzip',
+    'log_level' => '3',
+    'max_concurrency' => '6',
+    'break_after_frontend' => '5',
+    'break_after_adminhtml' => '30',
+    'first_lifetime' => '600',
+    'bot_first_lifetime' => '60',
+    'bot_lifetime' => '7200',
+    'disable_locking' => '0',
+    'min_lifetime' => '60',
+    'max_lifetime' => '2592000'
+  ]
+],
+```
+and delete old Magento's sessions with
+```
+rm -rf magento2/var/session/*
+```
+
 ## Enable Varnish
 Varnish Full Page Cache should already be enabled out of the box (we startup Varnish with the default VCL file generated by Magento2) but you could anyway go to "stores -> configuration -> advanced -> system -> full page cache" and:
 * select Varnish in the "caching application" combobox
@@ -139,7 +180,6 @@ Please note that your php.ini will be the last parsed thus you can ovverride any
 ## TODO
 * migrate to alpine/linuxkit based containers?
 * optimize everything for docker swarm
-* sessions on redis?
 * DB clustering?
 * optional RabbitMQ
 
@@ -148,3 +188,5 @@ Please note that your php.ini will be the last parsed thus you can ovverride any
   * migrated to docker-compose syntax 3.7
   * implemented "delegated" consistency for some of volumes for a better performance
   * varnish.vcl was regenerated for Varnish 5 (which was already used since some months)
+* 2019-08-06:
+  * new redis sessions container was added
