Merge pull request #384 from moon-hn/object-storage-path-styles

Adding information about the path-style config

Author: poespas

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

@@ -32,6 +32,19 @@ bin/magento setup:config:set system/media_storage_configuration/media_storage 0
 
 If you're using Hypernode Object Storage or a different provider than AWS S3, you need to specify the `--remote-storage-endpoint` option.
 
+For Hypernode Object Storage, use `main` as the bucket name and `EU` as the region. You can retrieve the remaining parameters by running `hypernode-object-storage info --with-credentials`.
+
+```console
+app@abcdef-example-magweb-cml:~$ hypernode-object-storage info --with-credentials
++--------------------------------------+----------------+---------+-------------+-------------------------------------+---------------+---------------+
+|                 UUID                 |      Name      |   Plan  |  Hypernodes |           Management URL            |   Access Key  |   Secret Key  |
++--------------------------------------+----------------+---------+-------------+-------------------------------------+---------------+---------------+
+| 12345678-9012-3456-b7e3-19ab43df4a23 | testappbucket1 | OS200GB |   testapp   |  https://example.ams.objectstore.eu |   abcd1234    |   1234abcd    |
++--------------------------------------+----------------+---------+-------------+-------------------------------------+---------------+---------------+
+```
+
+If you're using a different object storage provider, replace these values with the relevant details from your provider.
+
 ```bash
 bin/magento setup:config:set \
     --remote-storage-driver="aws-s3" \
@@ -42,18 +55,33 @@ bin/magento setup:config:set \
     --remote-storage-endpoint="https://my-s3-compatible.endpoint.com"
 ```
 
-For Hypernode Object Storage, use `main` as the bucket name and `EU` as the region. You can retrieve the remaining parameters by running `hypernode-object-storage info --with-credentials`.
+Running the Magento object storage command may not include all necessary settings in the configuration.
 
-```console
-app@abcdef-example-magweb-cml:~$ hypernode-object-storage info --with-credentials
-+--------------------------------------+----------------+---------+-------------+-------------------------------------+---------------+---------------+
-|                 UUID                 |      Name      |   Plan  |  Hypernodes |           Management URL            |   Access Key  |   Secret Key  |
-+--------------------------------------+----------------+---------+-------------+-------------------------------------+---------------+---------------+
-| 12345678-9012-3456-b7e3-19ab43df4a23 | testappbucket1 | OS200GB |   testapp   |  https://example.ams.objectstore.eu |   abcd1234    |   1234abcd    |
-+--------------------------------------+----------------+---------+-------------+-------------------------------------+---------------+---------------+
+If you're using Hypernode object storage, you need to add the following parameters to your env.php to complete the setup:
+
+```php
+'use_path_style_endpoint' => true,
+'path_style' => true,
 ```
 
-If you're using a different object storage provider, replace these values with the relevant details from your provider.
+The complete and functional Magento configuration should resemble the following example:
+
+```php
+'remote_storage' => [
+    'driver' => 'aws-s3',
+    'config' => [
+        'endpoint' => '',
+        'bucket' => 'main',
+        'region' => 'EU',
+        'use_path_style_endpoint' => true,
+        'path_style' => true,
+        'credentials' => [
+            'key' => '',
+            'secret' => ''
+        ]
+    ]
+],
+```
 
 **AWS S3**