1
0
mirror of https://github.com/minio/docs.git synced 2025-08-09 13:02:53 +03:00
Files
docs/source/includes/common-mc-admin-config.rst
Ravind Kumar 4edb3f7bae Improve documentation on MINIO_DOMAIN (#1131)
# Summary

As per a recent customer issue, our guidance on `MINIO_DOMAIN` and
path/virtual bucket lookups needs some attention.

There are two main areas to address:

1. We need to guide users to avoid namespace collision within the
`MINIO_DOMAIN` , as this causes bucket lookup issues with certain MinIO
services/features
2. We need to generally improve docs on setting `MINIO_DOMAIN` correctly

There is also a side objective from Engineering to ensure we have a
simple admonition to direct users to test wherever possible changes to
config settings before applying to production.

---------

Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com>
2024-02-14 17:16:58 -05:00

119 lines
3.3 KiB
ReStructuredText

.. Root API Access
.. start-minio-data-compression-default-excluded-desc
.. list-table::
:header-rows: 1
:widths: 30 30 40
:width: 100%
* - Object Type
- File Extension
- Media (MIME) Type
* - Audio
-
- ``audio/*``
* - Video
- | ``*.mp4``
| ``*.mkv``
| ``*.mov``
- ``video/*``
* - Image
- | ``*.jpg``
| ``*.png``
| ``*.gif``
- ``application/x-compress`` (LZW)
* - 7ZIP Compressed
- ``*.7z``
-
* - BZIP2 Compressed
- ``*.bz2``
- ``application/x-bz2``
* - GZIP Compressed
- ``*.gz``
- ``application/x-gzip``
* - RAR Compressed
- ``*.rar``
-
* - LZMA Compressed
- ``*.xz``
- ``application/x-xz``
* - ZIP Compressed
- ``*.zip``
- | ``application/zip``
| ``application-x-zip-compressed``
.. end-minio-data-compression-default-excluded-desc
.. start-minio-data-compression-default-desc
+-----------------+--------------------------+
| File Extensions | Media (MIME) Types |
+=================+==========================+
| ``.txt`` | ``text/*`` |
| | |
| ``.log`` | ``application/json`` |
| | |
| ``.csv`` | ``application/xml`` |
| | |
| ``.json`` | ``binary/octet-stream`` |
| | |
| ``.tar`` | |
| | |
| ``.xml`` | |
| | |
| ``.bin`` | |
+-----------------+--------------------------+
.. end-minio-data-compression-default-desc
.. start-minio-api-sync-events
Enables synchronous :ref:`bucket notifications <minio-bucket-notifications>`.
Specify ``on`` to direct MinIO to wait until the remote target returns success on receipt of an event before processing further events.
Defaults to ``off``, or asynchronous bucket notifications where MinIO does not wait for the remote target to return success on receipt of an event.
.. end-minio-api-sync-events
.. start-minio-settings-no-config-option
This setting does not have a configuration setting option.
.. end-minio-settings-no-config-option
.. start-minio-settings-defined
You can establish or modify settings by defining:
- an *environment variable* on the host system prior to starting or restarting the MinIO Server.
Refer to your operating system's documentation for how to define an environment variable.
- a *configuration setting* using :mc:`mc admin config set`.
- a *configuration setting* using the :ref:`MinIO Console's <minio-console-settings>` :guilabel:`Administrator > Settings` pages.
If you define both an environment variable and the similar configuration setting, MinIO uses the environment variable value.
Some settings have only an environment variable or a configuration setting, but not both.
.. end-minio-settings-defined
.. start-minio-settings-test-before-prod
.. important::
Each configuration setting controls fundamental MinIO behavior and functionality.
MinIO **strongly recommends** testing configuration changes in a lower environment, such as DEV or QA, before applying to production.
.. end-minio-settings-test-before-prod