Merge pull request #192 from ByteInternet/add-varnish-cluster-documentation

Add additional varnish documentation for cluster setups

Author: vdloo

docs/ecommerce-applications/magento-2/how-to-configure-varnish-for-magento-2-x.md

@@ -73,7 +73,7 @@ To do this, run the following command:
 
 ```console
 $ cd /data/web/magento2
-$ bin/magento setup:config:set --http-cache-hosts=127.0.0.1:6081
+$ bin/magento setup:config:set --http-cache-hosts=varnish:6081
 ```
 
 Now when you flush your caches in cache management, your varnish full_page cache will be flushed too.
@@ -112,6 +112,20 @@ backend default {
 
 Make sure you change this to the aforementioned configuration (without the health_check probe), since this will break on our Nginx configuration and will therefore result in a `503 Guru Meditation` error.
 
+**Note:** If you are using a cluster setup, you need to add some additional configuration to your vcl.
+The `acl purge` block inside your vcl should contain the private ip range of your cluster.
+You can find your private ip range using the `hypernode-cluster-info` command on one of your cluster nodes.
+
+As example, our private ip range is `192.168.1.0/24`.
+You can add this to the `acl purge` block. It should like something similar as the example below:
+
+```
+acl purge {
+    "localhost";
+    "192.168.1.0/24";
+}
+```
+
 ## Import Your VCL into the Varnish Daemon
 
 Import your VCL into Varnish and save as `mag2`:

docs/ecommerce-applications/shopware-5/how-to-configure-varnish-for-shopware-5.md

@@ -40,6 +40,22 @@ Please follow Shopware's [documentation about configuring Shopware 5 to work wit
 
 Copy the VCL configuration from [Shopware's documentation](https://developers.shopware.com/sysadmins-guide/varnish-setup/) and save it on your Hypernode, for example at `/data/web/shopware5.vcl`.
 
+**Note:** If you are using a cluster setup, you need to add some additional configuration to your vcl.
+The `acl purgers` block inside your vcl should contain the private ip range of your cluster.
+You can find your private ip range using the `hypernode-cluster-info` command on one of your cluster nodes.
+
+As example, our private ip range is `192.168.1.0/24`.
+You can add this to the `acl purgers` block. It should like something similar as the example below:
+
+```vcl
+acl purgers {
+    "127.0.0.1";
+    "localhost";
+    "::1";
+    "192.168.1.0/24";
+}
+```
+
 Now we can load in the configuration with the following command:
 
 `varnishadm vcl.load shopware5_debug /data/web/shopware5.vcl`

docs/ecommerce-applications/shopware-6/how-to-configure-varnish-for-shopware-6.md

@@ -92,6 +92,22 @@ Go to [Shopware's Reverse Http Cache documentation](https://developer.shopware.c
 
 To actually use Varnish you need to implement a varnish config file, a .vcl. If you're on Shopware >= 6.4, fetch the [Varnish configuration from their documentation](https://developer.shopware.com/docs/guides/hosting/infrastructure/reverse-http-cache#configure-varnish) (copy the code block starting with *vcl 4.0;*). Or you can create your own.
 
+**Note:** If you are using a cluster setup, you need to add some additional configuration to your vcl.
+The `acl purgers` block inside your vcl should contain the private ip range of your cluster.
+You can find your private ip range using the `hypernode-cluster-info` command on one of your cluster nodes.
+
+As example, our private ip range is `192.168.1.0/24`.
+You can add this to the `acl purgers` block. It should like something similar as the example below:
+
+```vcl
+acl purgers {
+    "127.0.0.1";
+    "localhost";
+    "::1";
+    "192.168.1.0/24";
+}
+```
+
 So, the steps to implement the Varnish configuration into Varnish are:
 
 - Create a file on your node, for example: **data/web/shopware6.vcl** with the Varnish config