Skip to content

Commit a03b61e

Browse files
committed
docs/autoscaling: Add more clarification on requirements
1 parent 6834703 commit a03b61e

File tree

1 file changed

+20
-4
lines changed

1 file changed

+20
-4
lines changed

docs/hypernode-platform/autoscaling/how-does-horizontal-autoscaling-work.md

Lines changed: 20 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,14 @@ For now, we don't support horizontal autoscaling for development plans.
7373

7474
#### Enable and configure Varnish
7575

76-
To make use of Horizontal autoscaling, Varnish should be enabled and configured on the Hypernode.
76+
Varnish is a requirement, because it's essential to deliver cached pages from the load balancer instead of the application servers when scaled up.
77+
The benefits are:
78+
79+
- Pages in the cache are served faster, because it is one less network hop
80+
- Saves network bandwidth
81+
- Saves CPU usage for both load balancer and application servers
82+
- Page cache is not affected by scaling up or down
83+
7784
You can check if Varnish is enabled on your Hypernode by running
7885

7986
```console
@@ -99,7 +106,9 @@ acl purge {
99106

100107
#### Make sure to use MySQL 5.7 or higher
101108

102-
The configured MySQL version should be 5.7 or above. You can check the enabled MySQL version by running the following command.
109+
MySQL 5.7 or higher is a requirement, because those versions support auto negotiation of TLS. TLS is an essential part for horizontal autoscaling, because the application servers will connect to the MySQL instance over the internet instead of wireguard.
110+
111+
You can check the enabled MySQL version by running the following command:
103112

104113
```console
105114
app@abcdef-example-magweb-cmbl:~$ hypernode-systemctl settings mysql_version
@@ -116,10 +125,14 @@ You should see something similar to `'host' => 'mysqlmaster',`. If this is not t
116125

117126
Make sure supervisor is disabled and that there are no supervisor services configured.
118127

128+
For now, we don't support having supervisor services, because we can't guarantee everything works when scaling up. If you do think your use case should be supported, please let us know!
129+
119130
#### Disable Podman services
120131

121132
Make sure podman is disabled and that there are no podman services running.
122133

134+
For now, we don't support having podman containers/services, because we can't guarantee everything works when scaling up. If you do think your use case should be supported, please let us know!
135+
123136
#### Configure hostnames correctly
124137

125138
The database, cache, session and queue of the application must be configured with correct hostnames instead of `localhost` or `127.0.0.1`. This way the services will be available across multiple hypernodes when the app is autoscaled.
@@ -133,7 +146,9 @@ Make sure the env variables (db, cache, session, queue) are not using localhost.
133146
Horizontal autoscaling is available for Magento 2.4.7 and higher.
134147
To make use of Horizontal autoscaling, there are a couple of other requirements the application should meet.
135148

136-
#### Make sure Redis cache is configured properly
149+
#### Make sure Redis cache is configured
150+
151+
Having a centralized cache database is essential for a consistent experience for your application.
137152

138153
Please make sure Redis cache is configured properly in the Magento 2 configuration file at `<magento_root>/app/etc/env.php`.
139154

@@ -143,7 +158,8 @@ More information about [Redis on Hypernode](../../ecommerce-applications/magento
143158

144159
#### Enable and configure Redis sessions
145160

146-
Redis persistent is another requirement before you can make use of Horizontal autoscaling.
161+
Redis sessions on the persistent instance is also required to make use of Horizontal autoscaling.
162+
147163
The persistent instance will be used to store the sessions so we can access the same sessions from the Horizontal autoscale Hypernodes.
148164

149165
You can check if Redis Persistent is enabled on your Hypernode by running

0 commit comments

Comments
 (0)