Вопрос или проблема
Контекст
У меня есть Docker-файл для сборки проекта на C++. Проект использует MySql или MsSqlServer в зависимости от конфигурации. Пока что я начинал свой образ Docker с ubuntu:focal, и все работало отлично.
Проблема
Я хотел бы использовать более современный компилятор, поэтому пришло время обновить образ Docker, чтобы он создавался из ubuntu:noble.
Я исправил большинство проблем, но теперь я получил ошибку компиляции:
#66 390.1 /root/SomeProduct/Src/DBConnectorMicrosoftSql.cpp:51:14: фатальная ошибка: файл 'msodbcsql.h' не найден
#66 390.1 51 | #include <msodbcsql.h>
#66 390.1 | ^~~~~~~~~~~~~
#66 390.1 1 ошибка сгенерирована.
И я не смог выяснить, какой пакет нужно установить, чтобы решить эту глупую проблему.
Соответствующая часть моего Dockerfile выглядит так:
FROM ubuntu:noble
RUN apt-get -y install curl wget gnupg
RUN apt-get -y install zip unzip tar
RUN curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor -o /usr/share/keyrings/microsoft-prod.gpg
RUN curl https://packages.microsoft.com/config/ubuntu/24.04/prod.list | tee /etc/apt/sources.list.d/mssql-release.list
RUN apt-get -y update
RUN ACCEPT_EULA=Y apt-get -y install --no-install-recommends msodbcsql18 mssql-tools18 unixodbc-dev
ENV PATH=${PATH}:/opt/mssql-tools18/bin
# другие шаги, связанные с процессом сборки C++
...
В основном это было уточнено на основе инструкций Microsoft.
Попытавшись решить эту проблему, я добавил эти строки в Dockerfile, пытаясь найти отсутствующий заголовочный файл:
RUN apt-get install -y apt-file
RUN apt-file update
RUN apt-file find msodbcsql.h && false
# или
RUN apt-file search msodbcsql.h && false
но search и find ничего не нашли.
Итак, как я могу решить эту проблему с отсутствующим заголовочным файлом?
Он был переименован? Он был перемещен в другую директорию? Он перемещен в другой пакет?
Ваш заголовочный файл msodbcsql.h отсутствует в msodbcsql18, вам просто нужно удалить строку #include <msodbcsql.h> и затем использовать стандартные заголовочные файлы ODBC из unixodbc-dev с
#include <sql.h>
#include <sqlext.h>
Вам также нужно будет использовать в коде правильные функции ODBC из sql.h и не забыть удалить ссылку на msodbcsql.h в вашем Makefile, если он у вас есть.
Ответ или решение
Обновление Dockerfile для Ubuntu Noble Numbat (24.04) с использованием msodbcsql
Введение
Вы обновляете свой Dockerfile для сборки C++ проекта для использования более современных инструментов компиляции на базе дистрибутива Ubuntu 24.04 (Noble Numbat). В процессе перехода возникла проблема с отсутствием заголовочного файла msodbcsql.h. В этой статье мы разберем, как решить эту проблему, а также дадим общие рекомендации по обновлению вашего Dockerfile.
Проблема с заголовочным файлом
Ошибка компиляции, указывающая на отсутствие файла msodbcsql.h, чаще всего связана с тем, что Microsoft изменили структуру пакетов для ODBC драйвера. Начиная с версии 18, Microsoft убрала заголовочный файл msodbcsql.h, заменив его на стандартные заголовочные файлы ODBC.
Вместо использования msodbcsql.h, вам необходимо использовать стандартные заголовочные файлы ODBC:
#include <sql.h>
#include <sqlext.h>Таким образом, вам потребуется переписать ваш код таким образом, чтобы он использовал функции из sql.h и sqlext.h. Также не забудьте удалить ссылку на msodbcsql.h в вашем Makefile, если он у вас есть.
Обновление Dockerfile
Ваш обновленный Dockerfile может выглядеть следующим образом:
FROM ubuntu:noble
# Установка необходимых инструментов
RUN apt-get -y install curl wget gnupg
RUN apt-get -y install zip unzip tar
# Добавление репозиториев Microsoft
RUN curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor -o /usr/share/keyrings/microsoft-prod.gpg
RUN curl https://packages.microsoft.com/config/ubuntu/24.04/prod.list | tee /etc/apt/sources.list.d/mssql-release.list
# Обновление пакетов и установка msodbcsql и инструментов
RUN apt-get -y update
RUN ACCEPT_EULA=Y apt-get -y install --no-install-recommends msodbcsql18 mssql-tools18 unixodbc-dev
ENV PATH=${PATH}:/opt/mssql-tools18/bin
# Здесь могут быть другие шаги, связанные с процессом сборки C++
...Заключение
С переходом на ubuntu:noble вам, вероятно, придется внести изменения в ваш код, задействующий ODBC, заменив вызовы, использующие msodbcsql.h, на стандартные функции из ODBC. Это позволит избежать проблем с отсутствием необходимых заголовков и обеспечит корректную работу вашей программы с базами данных Microsoft SQL Server.
Если у вас возникли дополнительные вопросы или сложности в процессе обновления, не стесняйтесь обращаться за помощью. Оптимизация вашего рабочего окружения должна быть простым и рациональным процессом, способствующим развитию вашего проекта.