Add documentation for Azure Linux installation

[jonmclean]

Please add mssql-python installation instructions for Azure Linux [https://github.com/microsoft/AzureLinux] Azure Linux is Microsoft's minimal Linux distribution and is very handy for building Docker images that are deployed to Azure environments.

I tried to install required prerequisites in my Dockerfile using this code:

# krb5-libs and libtool-ltdl are mssql-python native deps (https://github.com/microsoft/mssql-python#installation)
RUN tdnf distro-sync -y && \
    tdnf install -y \
    ca-certificates \
    git \
    libtool \
    krb5-libs \
    libtool-ltdl \
    python3 \
    shadow-utils \
    sudo \
    util-linux && \
    tdnf clean all

After pip installing mssql_python in the Docker container and trying to run I get this error message:

  File "/opt/venv/lib/python3.12/site-packages/graphragzero/api/executors/retrieval.py", line 232, in _run
    if storage.has_dimensionality_reducer():
       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/venv/lib/python3.12/site-packages/graphragzero/utils/time.py", line 21, in _wrapper
    result = func(*args, **kwargs)
             ^^^^^^^^^^^^^^^^^^^^^
  File "/opt/venv/lib/python3.12/site-packages/graphragzero/example_integrations/azure_sql_db_storage.py", line 982, in has_dimensionality_reducer
    with connect(self._context.connection_string) as conn, conn.cursor() as cursor:
         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/venv/lib/python3.12/site-packages/mssql_python/db_connection.py", line 55, in connect
    conn = Connection(
           ^^^^^^^^^^^
  File "/opt/venv/lib/python3.12/site-packages/mssql_python/connection.py", line 332, in __init__
    self._conn = ddbc_bindings.Connection(
                 ^^^^^^^^^^^^^^^^^^^^^^^^^
RuntimeError: Failed to allocate environment handle

This looks like a pybind error to me so I assume there are more dependencies that need to be installed.

[github-actions]

Hi @jonmclean, thank you for opening this issue!

Our team will review it shortly. We aim to triage all new issues within 24-48 hours and get back to you.

If you have additional information to share, please feel free to update the issue.

Thank you for your patience!

[saurabh500]

@jonmclean can you try adding this dep to your Dockerfile

dnf install -y glibc-iconv

This should help unblock.

[jonmclean]

Installing glibc-iconv worked and I submitted a PR to update the documentation. #561

[bewithgaurav]

thanks for your contributions @jonmclean!
closing this off :)