{"draftJsState":{"blocks":[{"data":{"image":{"id":"6511f5a14fbdd11cc595fc0a"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"1ror9"},{"data":{},"depth":0,"entityRanges":[{"key":0,"length":22,"offset":10}],"inlineStyleRanges":[],"text":"Источник: Nuances of Programming","type":"unstyled","key":"4c1s5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":223,"style":"ITALIC"}],"text":"Появилась новая встроенная поддержка контейнеров для версий .NET 7 и новее. С совершенно новым SDK-пакетом .NET 7 образы Docker для приложения собираются теперь мгновенно, так же быстро поднимаются для него и контейнеры, а Dockerfile не нужен — одним файлом для сопровождения меньше.","type":"unstyled","key":"f7stk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":217,"style":"ITALIC"}],"text":"В Microsoft анонсировали, начиная с SDK-пакета .NET 7, поддержку фреймворком создания контейнеризированных приложений в рамках инструментария публикации. Таким образом устраняется необходимость в самом дополнительном Dockerfile. Теперь сократится сопровождаемый разработчиками код Docker, значительно упростится весь рабочий процесс.","type":"unstyled","key":"7ml4l"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Содержание","type":"header-three","key":"26gf4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Основная идея","type":"unordered-list-item","key":"8jfkb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Контейнеризация приложений .NET 6 — вкратце","type":"unordered-list-item","key":"fjara"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Недостатки «Dockerfile»","type":"unordered-list-item","key":"5imlu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Встроенная поддержка контейнеров для .NET 7","type":"unordered-list-item","key":"dnfg2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Дополнительные настройки для встроенной поддержки Docker","type":"unordered-list-item","key":"cgfh4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Directory.Build.props","type":"unordered-list-item","key":"3h4cg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Для локальной разработки","type":"unordered-list-item","key":"amobu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Рабочий процесс «GitHub Actions»","type":"unordered-list-item","key":"75h09"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Небольшие ограничения","type":"unordered-list-item","key":"8ucd8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Основная идея","type":"header-three","key":"97eaq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Каков общий рабочий процесс большинства программных приложений, особенно микросервисов?","type":"unstyled","key":"a7ml5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":170,"style":"ITALIC"}],"text":"Код → отправка в репозиторий → запуск конвейера непрерывной интеграции и непрерывного развертывания. Часть этого конвейера — этап сборки Docker, на котором из длинного Dockerfile обычно считываются данные и генерируются образы Docker для приложения. → И, наконец, развертывание образа в службе облачных вычислений.","type":"unstyled","key":"dvcq1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":29,"style":"ITALIC"}],"text":"Теперь не нужно сопровождать Dockerfile: образ генерируется самим фреймворком .NET и отправляется в выбранный репозиторий.","type":"unstyled","key":"fb455"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":161,"style":"ITALIC"}],"text":"Далее мы узнаем, как собираются образы Docker при помощи инструментария интерфейса командной строки .NET, изучим предоставляемые им варианты, сравним с подходом Dockerfile и интегрируем в рабочий процесс Github Actions, продемонстрировав полезность этого для ваших проектов.","type":"unstyled","key":"7g8c4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":62,"style":"ITALIC"}],"text":"Сначала быстро рассмотрим контейнеризацию приложения .NET 6 с Dockerfile.","type":"unstyled","key":"2os61"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Создадим два простых приложения: dotnet6 и dotnet7. Поместим их код в папки одного репозитория. А в конце покажем, как это интегрировать с конвейером сборки и отправляемым, например, на DockerHub образом, и прямо в GitHub напишем простой рабочий процесс GitHub Actions.","type":"unstyled","key":"9psql"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Устанавливаем оба SDK-пакета и Docker Desktop:","type":"unstyled","key":"7v6n"},{"data":{},"depth":0,"entityRanges":[{"key":1,"length":6,"offset":0}],"inlineStyleRanges":[],"text":"Первый.","type":"unordered-list-item","key":"8d3fa"},{"data":{},"depth":0,"entityRanges":[{"key":2,"length":6,"offset":0}],"inlineStyleRanges":[],"text":"Второй.","type":"unordered-list-item","key":"18j6d"},{"data":{},"depth":0,"entityRanges":[{"key":3,"length":14,"offset":0}],"inlineStyleRanges":[],"text":"Docker Desktop.","type":"unordered-list-item","key":"3eshv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":7,"offset":159,"style":"BOLD"}],"text":"Создаем на GitHub репозиторий, клонируем его на компьютер для локальной разработки, при помощи Visual Code открываем папку репозитория и добавляем здесь папку dotnet6.","type":"unstyled","key":"b9ljp"},{"data":{},"depth":0,"entityRanges":[{"key":4,"length":3,"offset":0}],"inlineStyleRanges":[],"text":"Вот исходный код этой реализации.","type":"unstyled","key":"5ijr5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Контейнеризация приложений .NET 6 — вкратце","type":"header-three","key":"ff3ne"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":11,"offset":47,"style":"ITALIC"},{"length":6,"offset":87,"style":"ITALIC"}],"text":"В папке dotnet6 создаем простой веб-API проект HelloDocker на .NET 6, запуская команду dotnet интерфейса командной строки:","type":"unstyled","key":"90dkg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"dotnet new webapi --name HelloDocker --framework net6.0","type":"blockquote","key":"eu91r"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":15,"offset":21,"style":"ITALIC"}],"text":"Здесь указывается на TargetFramework, то есть целевой фреймворк net6.0.","type":"unstyled","key":"6mrau"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Пропустите эту часть, если уже хорошо знаете контейнеризацию приложений до версии .NET 6 включительно.","type":"blockquote","key":"3vi7h"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":238,"style":"ITALIC"}],"text":"Это очень простой веб-API, которым возвращаются стандартные данные о погоде, подобный любому другому новому веб-API проекту по умолчанию на ASP.NET Core. Чтобы его контейнеризировать, до версии .NET 7 в корневой каталог проекта добавляли Dockerfile.","type":"unstyled","key":"dgc07"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":169,"offset":0,"style":"ITALIC"}],"text":"Совет: создав любое приложение dotnet, сразу очистить файл «launchSettings.json» и удалить все конфигурации, связанные со службами информационного сервера интернета IIS.","type":"unstyled","key":"fq8to"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"{\n \"$schema\": \"https://json.schemastore.org/launchsettings.json\",\n \"profiles\": {\n \"HelloDocker\": {\n \"commandName\": \"Project\",\n \"dotnetRunMessages\": true,\n \"launchBrowser\": false,\n \"launchUrl\": \"swagger\",\n \"applicationUrl\": \"https://localhost:7290;http://localhost:5033\",\n \"environmentVariables\": {\n \"ASPNETCORE_ENVIRONMENT\": \"Development\"\n }\n }\n }\n}","type":"blockquote","key":"ese83"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":9,"offset":70,"style":"BOLD"}],"text":"Так API всегда запустится на безопасном порте 7290 и HTTP-порте 5033. Внимание: только для запуска приложения на компьютере разработчика, а не в контейнере Docker.","type":"unstyled","key":"4haq4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"По умолчанию, когда контейнер Docker развертывается с образом .NET, приложение запускается в http://+:80.","type":"unstyled","key":"ca93q"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Чтобы переопределить его на другой номер порта в контейнере Docker, устанавливаем эту переменную окружения:","type":"unstyled","key":"bmt78"},{"data":{},"depth":0,"entityRanges":[{"key":5,"length":13,"offset":20}],"inlineStyleRanges":[],"text":"ENV ASPNETCORE_URLS=http://+:5000.","type":"unordered-list-item","key":"9f5kv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":19,"style":"BOLD"}],"text":"Добавим новый файл Dockerfile с таким содержимым:","type":"unstyled","key":"9h1st"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"FROM mcr.microsoft.com/dotnet/sdk:6.0 as build-env\nWORKDIR /src\nCOPY *.csproj .\nRUN dotnet restore\nCOPY . .\nRUN dotnet publish -c Release -o /publish\n\nFROM mcr.microsoft.com/dotnet/aspnet:6.0 as runtime\nWORKDIR /publish\nCOPY --from=build-env /publish .\nENV ASPNETCORE_URLS=http://+:5000\nEXPOSE 5000\nENTRYPOINT [\"dotnet\", \"HelloDocker.dll\"]","type":"blockquote","key":"5ls2m"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":18,"offset":96,"style":"ITALIC"},{"length":14,"offset":212,"style":"ITALIC"},{"length":7,"offset":272,"style":"ITALIC"},{"length":14,"offset":300,"style":"ITALIC"}],"text":"Вот что происходит дальше. Из репозитория образов Microsoft извлекается SDK-пакет dotnet6, файл HelloDocker.csproj копируется в каталог сборки, для восстановления всех зависимостей приложения запускается команда dotnet-restore, остальное содержимое копируется, и в режиме Release запускается команда dotnet publish.","type":"unstyled","key":"c1pvk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":19,"offset":150,"style":"ITALIC"},{"length":15,"offset":204,"style":"ITALIC"}],"text":"После для выполнения приложения извлекается образ файла этапа выполнения aspnet:6.0, предоставляются порты вроде тех 5033 и 7290, которые мы видели в launchsettings.json. И, наконец, задается точка входа HelloDocker.dll приложения.","type":"unstyled","key":"59gbp"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":1,"offset":66,"style":"ITALIC"},{"length":1,"offset":190,"style":"ITALIC"}],"text":"Внимание: этот Dockerfile автогенерируется и при создании проекта. Просто включаем Docker Support, выбираем Linux, и с помощью Visual Studio он добавляется в корневой каталог нового проекта. Интересно вам это или нет, а все-таки придется внести здесь коррективы вместе с другими изменениями структуры проекта.","type":"blockquote","key":"6hcu7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":82,"style":"ITALIC"}],"text":"Теперь создадим образ Docker, выполнив команду из папки, в которой находится файл Dockerfile:","type":"unstyled","key":"ahm4v"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"docker build -t hellodockerfrom6 .","type":"blockquote","key":"2mfj7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":16,"offset":64,"style":"ITALIC"}],"text":"Так инициализируется процесс сборки Docker. По завершении образ hellodockerfrom6 отправляется в локальный экземпляр Docker.","type":"unstyled","key":"8nq8k"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":45,"style":"ITALIC"}],"text":"В Docker Desktop переходим во вкладку Images («Образы»):","type":"unstyled","key":"dksog"},{"data":{"image":{"id":"6511f5c70f5ccd7dfc9f27b0"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"bor6n"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":16,"offset":17,"style":"ITALIC"}],"text":"Отсюда из образа hellodockerfrom6 развертывается контейнер Docker, и при необходимости передаются дополнительные настройки, номера портов, переменные окружения.","type":"unstyled","key":"8nh15"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":16,"offset":207,"style":"ITALIC"}],"text":"Сопоставим локальный порт 5000 с портом 5000 контейнера Docker. Так любой трафик/запрос, отправленный на порт localhost 5000, перенаправляется на внутренний порт 5000 контейнера Docker, то есть в приложение hellofromdocker6:","type":"unstyled","key":"45q9q"},{"data":{"image":{"id":"6511f5c72dfe827535463a27"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"3te9j"},{"data":{},"depth":0,"entityRanges":[{"key":6,"length":39,"offset":43}],"inlineStyleRanges":[],"text":"Вот и все. Запустив контейнер, переходим в http://localhost:5000/WeatherForecast/, и в ответе видим данные о погоде:","type":"unstyled","key":"34ko2"},{"data":{"image":{"id":"6511f5c73ef9a711d06a638a"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"ej58"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Недостатки «Dockerfile»","type":"header-three","key":"4ufme"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":138,"style":"ITALIC"}],"text":"Сам по себе это простой способ создания образов Docker из приложений .NET. Но по мере увеличения размера и сложности проекта на .NET файл Dockerfile становится запутанным.","type":"unstyled","key":"j4q8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":15,"style":"ITALIC"}],"text":"Вот, например, Dockerfile одного из моих решений со ссылками на более чем 10 проектов:","type":"unstyled","key":"68jrg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build\nWORKDIR /\n\n# Копируем «csproj» и восстанавливаем как отдельные слои\nCOPY [\"Directory.Build.props\", \"/\"]\nCOPY [\"Directory.Build.targets\", \"/\"]\nCOPY [\"dotnet.ruleset\", \"/\"]\nCOPY [\"stylecop.json\", \"/\"]\nCOPY [\"src/Host/Host.csproj\", \"src/Host/\"]\nCOPY [\"src/Core/Application/Application.csproj\", \"src/Core/Application/\"]\nCOPY [\"src/Core/Domain/Domain.csproj\", \"src/Core/Domain/\"]\nCOPY [\"src/Core/Shared/Shared.csproj\", \"src/Core/Shared/\"]\nCOPY [\"src/Infrastructure/Infrastructure.csproj\", \"src/Infrastructure/\"]\nCOPY [\"src/Migrators/Migrators.MSSQL/Migrators.MSSQL.csproj\", \"src/Migrators/Migrators.MSSQL/\"]\n \nRUN dotnet restore \"src/Host/Host.csproj\" --disable-parallel\n\n# Копируем все остальное и выполняем сборку\nCOPY . .\nWORKDIR \"/src/Host\"\nRUN dotnet publish \"Host.csproj\" -c Release -o /app/publish\n\n# Собираем образ файла этапа выполнения\nFROM mcr.microsoft.com/dotnet/aspnet:6.0\nWORKDIR /app\n\nCOPY --from=build /app/publish .\n\n# Создается непривилегированный пользователь с явно заданным «UID», добавляется разрешение на доступ к папке «/app»\n# Подробнее — по адресу https://aka.ms/vscode-docker-dotnet-configure-containers\nRUN adduser -u 5678 --disabled-password --gecos \"\" appuser && chown -R appuser /app\nUSER appuser\n\nENV ASPNETCORE_URLS=https://+:5050;http://+:5060\nEXPOSE 5050\nEXPOSE 5060\n\nENTRYPOINT [\"dotnet\", \"Host.dll\"]","type":"blockquote","key":"ca3lj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":101,"style":"ITALIC"}],"text":"Это будет очень неудобно для сопровождения. Особенно в микросервисах, где придется сопровождать один Dockerfile для каждой из служб со ссылками внутри на несколько CSPROJ.","type":"unstyled","key":"ehmuc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":11,"offset":114,"style":"ITALIC"},{"length":10,"offset":196,"style":"ITALIC"}],"text":"Чтобы упростить эту ситуацию и управление ею, в Microsoft доработали поддержку контейнеров, начиная с .NET 7, где Dockerfile для фактической контейнеризации приложения уже не нужен. Однако подход Dockerfile остается рабочим.","type":"unstyled","key":"19b1m"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":97,"style":"ITALIC"}],"text":"Другая потенциальная проблема связана с контекстом сборки Docker. Предполагается, что все нужное Dockerfile находится в одной с ним папке. Однако при создании приложения с несколькими слоями или срезами, очевидно, что это не так.","type":"unstyled","key":"2kf7l"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":91,"style":"ITALIC"},{"length":24,"offset":317,"style":"ITALIC"}],"text":"Допустим, в корневой папке одного из проектов случайного решения для микросервисов имеется Dockerfile. При сборке образа Docker легко пропустить включение других файлов, которые находятся в корневом каталоге. Это весьма распространенный сценарий для Docker — пропускать очень важные для процесса сборки файлы вроде Directory.Packages.props.","type":"unstyled","key":"b64kb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Встроенная поддержка контейнеров для .NET 7","type":"header-three","key":"dqm46"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В Microsoft эти конкретные проблемы устранили. С новым обновлением перестали быть проблемой и пробелы в контекстах, большинство из вас с ними наверняка уже сталкивались.","type":"unstyled","key":"f7k79"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Обратимся к новому подходу.","type":"unstyled","key":"2betg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Создаем в корневом каталоге репозитория папку dotnet7, а также новый веб-API 7.0:","type":"unstyled","key":"5h5er"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"dotnet new webapi --name HelloDocker7 --framework net7.0","type":"blockquote","key":"b74nd"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":33,"style":"ITALIC"}],"text":"Теперь, перейдя в проект, вместо Dockerfile добавляем новый NuGet-пакет:","type":"unstyled","key":"d1ms4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"dotnet add package Microsoft.NET.Build.Containers","type":"blockquote","key":"fb4e9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"По утверждениям Microsoft, это пакет временный: в дальнейших выпусках .NET его включат в SDK-пакет. Это практически ссылка на пакет для создания образа Docker и единственное, что добавляется для получения базового образа.","type":"unstyled","key":"1i7k0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":14,"offset":87,"style":"ITALIC"}],"text":"Получаем доступ к образу Docker локально, запуская в корневом каталоге проекта команду dotnet publish с парой параметров:","type":"unstyled","key":"8vsv4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"dotnet publish --os linux --arch x64 -p:PublishProfile=DefaultContainer -p:ContainerImageName=hellodocker7","type":"blockquote","key":"7o5jd"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":12,"offset":41,"style":"ITALIC"}],"text":"В этом подходе сохраняются все настройки Dockerfile. Разберем сначала передаваемые здесь аргументы и базовые параметры:","type":"unstyled","key":"7joqr"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"–os указывается целевая ОС;","type":"unordered-list-item","key":"eu0lv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"–arch указывается целевая архитектура;","type":"unordered-list-item","key":"fqp3q"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":7,"offset":65,"style":"ITALIC"}],"text":"-p обозначаются конкретные параметры, передаваемые в эту команду publish.","type":"unordered-list-item","key":"3b2qu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Новый образ контейнера доступен в Docker Desktop:","type":"unstyled","key":"928ek"},{"data":{"image":{"id":"6511f5c7358ca621ee5b70f8"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"q8g7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":19,"offset":49,"style":"ITALIC"}],"text":"Упростим команду, добавив параметры прямо в файл HelloDocker7.csproj, открываем его в Visual Code и вставляем код:","type":"unstyled","key":"9t5be"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\n hellodocker7\n DefaultContainer\n 1.1.0;latest \n","type":"blockquote","key":"7moeb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Задав однажды, уже не нужно каждый раз добавлять это в аргументы терминала.","type":"unstyled","key":"8hjbq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь команда стала такой:","type":"unstyled","key":"9g24u"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"dotnet publish --os linux --arch x64","type":"blockquote","key":"3q6m"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Сделаем ее еще проще, добавив это свойство:","type":"unstyled","key":"7b1rj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"linux-x64","type":"blockquote","key":"7rco8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Вот что осталось от команды:","type":"unstyled","key":"ab4md"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"dotnet publish","type":"blockquote","key":"3dii9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":6,"offset":88,"style":"ITALIC"}],"text":"Запустив ее, обнаружим в Docker Desktop новый образ с тегом 1.1.0 — так прямо в файле csproj указываются различные настройки для образа Docker.","type":"unstyled","key":"6g2qv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Дополнительные настройки для встроенной поддержки Docker","type":"header-three","key":"kcjk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":2,"style":"ITALIC"}],"text":"В Dockerfile образ настраивался очень гибко, то же и с новым подходом.","type":"unstyled","key":"b9tur"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Уже искали во встроенной поддержке Docker на .NET дополнительные настройки? Например, как здесь определяется базовый образ, добавляются переменные окружения, изменяются теги?","type":"unstyled","key":"5os6l"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Имеются такие:","type":"unstyled","key":"128ib"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":19,"offset":0,"style":"ITALIC"}],"text":"ContainerBaseImage. С этим свойством мы управляем базовым образом для создания приложения dotnet, по умолчанию SDK принимаются значения mcr.microsoft.com/dotnet/aspnet для проектов ASP.NET Core.","type":"unordered-list-item","key":"fj1k3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":18,"offset":0,"style":"ITALIC"}],"text":"ContainerImageName. Здесь меняем название образа. Если оно не указано, SDK вернется к названию самой сборки.","type":"unordered-list-item","key":"60a8r"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":13,"offset":0,"style":"ITALIC"}],"text":"ContainerPort. Для автоматического сопоставления портов.","type":"unordered-list-item","key":"97ni6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"А так указываются переменные окружения:","type":"unstyled","key":"svjf"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\n \n","type":"blockquote","key":"bd5ns"},{"data":{},"depth":0,"entityRanges":[{"key":7,"length":3,"offset":0}],"inlineStyleRanges":[],"text":"Вот подробная документация по другим параметрам/свойствам для настройки контейнера.","type":"unstyled","key":"3bctt"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Directory.Build.props","type":"header-three","key":"9vola"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":21,"offset":210,"style":"ITALIC"}],"text":"Обычно в одном решении имеется несколько проектов на C#. Чтобы каждым из проектов, на которые ссылаются в решении, использовались все эти свойства, в таких сценариях они включаются и в корневой каталог решения Directory.Build.props.","type":"unstyled","key":"938c4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":21,"offset":37,"style":"ITALIC"}],"text":"Например, вот фрагмент кода из файла Directory.Build.props шаблонного решения для микросервисов dotnet:","type":"unstyled","key":"ccar7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\n DefaultContainer\n 1.3.0;latest\n","type":"blockquote","key":"dti2j"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":6,"offset":10,"style":"ITALIC"}],"text":"На уровне csproj указывается это:","type":"unstyled","key":"coar4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\n fsh-microservices.catalog \n","type":"blockquote","key":"6pbsq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Таким образом очень легко в долгую сопровождать конкретные и общие свойства.","type":"unstyled","key":"6da61"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Для локальной разработки","type":"header-three","key":"9kl2n"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":14,"offset":99,"style":"ITALIC"},{"length":10,"offset":180,"style":"ITALIC"}],"text":"Это очень хорошо для локальной разработки, где приложения .NET контейнеризируются частенько. Одной dotnet publish достаточно для легкого доступа к образу Docker, и без отражения в Dockerfile многочисленных изменений и добавления новых ссылок на проекты.","type":"unstyled","key":"26uvp"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":18,"offset":106,"style":"ITALIC"}],"text":"Кроме того, жизнь облегчается применением задач Visual Code, похожих на этот фрагмент кода из моего файла .vscode/tasks.json:","type":"unstyled","key":"37m4l"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"{\n \"label\": \"publish:catalog-api\",\n \"command\": \"dotnet\",\n \"type\": \"process\",\n \"args\": [\n \"publish\",\n \"${workspaceFolder}/src/services/catalog/Host/Host.csproj\",\n \"--os\",\n \"linux\",\n \"--arch\",\n \"x64\",\n \"-c\",\n \"Release\",\n \"-p:PublishProfile=DefaultContainer\",\n \"-p:ContainerImageTags=latest\",\n \"--self-contained\"\n ],\n \"problemMatcher\": \"$msCompile\"\n},","type":"blockquote","key":"e30ft"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Рабочий процесс «GitHub Actions»","type":"header-three","key":"99tno"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь отправим приложение .NET в репозиторий, для сборки приложения .NET 7 создадим экшен GitHub, опубликуем его со сборкой образа Docker и отправим в общедоступный репозиторий DockerHub.","type":"unstyled","key":"v57s"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":6,"offset":77,"style":"BOLD"}],"text":"Во вкладке Actions репозитория GitHub создаем рабочий процесс с новым файлом ci.yml:","type":"unstyled","key":"cu4mu"},{"data":{"image":{"id":"6511f5c74fbdd11cc5962cee"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"bfqo6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Чтобы создать приложение .NET 7, сгенерировать для него образ Docker и отправить в DockerHub, напишем очень простой рабочий процесс ci экшена конвейера сборки:","type":"unstyled","key":"2mc6i"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"name: ci\non:\n workflow_dispatch: \njobs:\n build:\n name: Build\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v3\n - name: Setup .NET\n uses: actions/setup-dotnet@v3\n with:\n dotnet-version: 7.0.x\n - name: Restore dependencies\n working-directory: ./dotnet7/HelloDocker7/\n run: dotnet restore\n - name: Build\n working-directory: ./dotnet7/HelloDocker7/\n run: dotnet build --no-restore\n docker:\n name: Docker Build & Push\n runs-on: ubuntu-latest\n needs:\n - build\n steps:\n - name: Checkout\n uses: actions/checkout@v3 \n - name: Docker Login\n uses: docker/login-action@v2\n with:\n username: ${{ secrets.DOCKER_USERNAME }}\n password: ${{ secrets.DOCKER_PASSWORD }}\n - name: Build Image\n working-directory: ./dotnet7/HelloDocker7/\n run: dotnet publish -c Release -p:ContainerImageName=${{ secrets.DOCKER_USERNAME }}/hellodockerfromdotnet7\n - name: Push Image\n run: docker push ${{ secrets.DOCKER_USERNAME }}/hellodockerfromdotnet7 --all-tags","type":"blockquote","key":"52onp"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Рассмотрим этот сценарий подробнее.","type":"unstyled","key":"5f4os"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Строки 2–3: здесь указывается, что этот рабочий процесс запускается только вручную. Имеются варианты автоматического его запуска, например при каждом добавлении в репозиторий. В этом демо пока достаточно ручного запуска.","type":"unordered-list-item","key":"dtlo7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":12,"offset":70,"style":"ITALIC"}],"text":"Строки 5–20: на основе .NET 7 в скрипте восстанавливаются зависимости HelloDocker7, выполняется попытка их собрать.","type":"unordered-list-item","key":"284kb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Строки 20–37: все, что связано с Docker.","type":"unordered-list-item","key":"31ibl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Строки 28–32: попытки войти в DockerHub с именем пользователя и паролем, установленными в качестве секретных данных репозитория, скриншот прилагается ниже.","type":"unordered-list-item","key":"eqjv1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":14,"offset":29,"style":"ITALIC"},{"length":7,"offset":60,"style":"ITALIC"}],"text":"Строка 35: запускаем команду dotnet publish с конфигурацией Release, здесь же на основе указанного ContainerImageName генерируется образ Docker.","type":"unordered-list-item","key":"ckofg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Строка 37: собранный на предыдущем этапе образ отправляется здесь в DockerHub.","type":"unordered-list-item","key":"c1g1t"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Чтобы установить секретные данные, во вкладке настроек Settings репозитория GitHub выбираем Secrets и добавляем имя пользователя и пароль Docker для доступа из конвейера:","type":"unstyled","key":"rgmq"},{"data":{"image":{"id":"6511f5c70292430a04179201"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"3aov7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":22,"offset":122,"style":"BOLD"}],"text":"После сохраняем yml-файл и создаем в DockerHub новый общедоступный репозиторий с таким же названием, как в этом файле — hellodockerfromdotnet7. Так из скрипта конвейера все гарантированно отправится в этот репозиторий.","type":"unstyled","key":"f29o1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":2,"offset":76,"style":"BOLD"},{"length":29,"offset":103,"style":"ITALIC"}],"text":"Выбираем во вкладке Actions этого нового репозитория Github рабочий процесс ci и нажимаем Run Workflow («Запустить рабочий процесс»):","type":"unstyled","key":"1lb5t"},{"data":{"image":{"id":"6511f5c98192a7506765ebaa"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"8p25s"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь конвейер готов к работе, выполняется попытка собрать приложение dotnet:","type":"unstyled","key":"50ng1"},{"data":{"image":{"id":"6511f5c996547f01a0c0da0d"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"9r2v2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":30,"offset":29,"style":"ITALIC"},{"length":14,"offset":67,"style":"ITALIC"}],"text":"На этапе Docker Build & Push («Сборка и добавление Docker»): новая dotnet publish в действии.","type":"unstyled","key":"42nbj"},{"data":{"image":{"id":"6511f5c968ef763eb61be051"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"bv1le"},{"data":{"image":{"id":"6511f5c9e5eafe6b73b947f0"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"14ajn"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Если обошлось без неожиданностей, увидите везде галочки в зеленых кружочках, то есть образ Docker отправится в DockerHub.","type":"unstyled","key":"bc6pm"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Небольшие ограничения","type":"header-three","key":"be5f"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":14,"offset":0,"style":"ITALIC"},{"length":10,"offset":39,"style":"ITALIC"},{"length":14,"offset":180,"style":"ITALIC"}],"text":"docker-compose для сборки образа нужен Dockerfile. Сейчас это не поддерживается. Решение — образ Docker отправляется на компьютер локальной разработки, затем указывается в файле docker-compose.","type":"unordered-list-item","key":"3l7bp"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Пока поддерживаются только образы для Linux x64.","type":"unordered-list-item","key":"7kbag"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Нет встроенной поддержки аутентификации для внешних репозиториев образов.","type":"unordered-list-item","key":"7hjk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Проект активно разрабатывается, поэтому в Microsoft все эти ограничения скоро устранят. А кроме них серьезных препятствий для применения этого нового функционала сейчас нет.","type":"unstyled","key":"75m8c"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Заключение","type":"header-three","key":"1j4e8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":143,"style":"ITALIC"},{"length":10,"offset":246,"style":"ITALIC"},{"length":10,"offset":314,"style":"ITALIC"}],"text":"Мы узнали о совершенно новой встроенной поддержке контейнеров для приложений .NET, начиная с SDK-пакета .NET 7. Рассмотрели стандартный подход Dockerfile для приложений .NET 6, еще применимый для более новых SDK-пакетов .NET, обсудили недостатки Dockerfile, ознакомились с функционалом нового SDK-пакета .NET, где Dockerfile для сборки образов Docker уже не нужен.","type":"unstyled","key":"edpod"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Рассмотрели различные доступные настройки и параметры, их применение для целей локальной разработки. Наконец, сделали рабочий процесс GitHub Action для создания приложения, сборки образа Docker и отправки на DockerHub.","type":"unstyled","key":"4g3bt"},{"data":{},"depth":0,"entityRanges":[{"key":8,"length":3,"offset":0}],"inlineStyleRanges":[],"text":"Вот код для этого демо на GitHub.","type":"unstyled","key":"ku7n"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Читайте также:","type":"unstyled","key":"f9vn5"},{"data":{},"depth":0,"entityRanges":[{"key":9,"length":116,"offset":0}],"inlineStyleRanges":[],"text":"AlterNats — эффективный PubSub-клиент среды .NET. Как реализовать оптимизированное программирование сокетов в .NET 6","type":"unordered-list-item","key":"5d1hp"},{"data":{},"depth":0,"entityRanges":[{"key":10,"length":40,"offset":0}],"inlineStyleRanges":[],"text":"Контейнеры Docker и их связывание в сети","type":"unordered-list-item","key":"1uv6l"},{"data":{},"depth":0,"entityRanges":[{"key":11,"length":57,"offset":0}],"inlineStyleRanges":[],"text":"Лёгкое пополнение баз данных в приложениях платформы .NET","type":"unordered-list-item","key":"542na"},{"data":{},"depth":0,"entityRanges":[{"key":12,"length":8,"offset":14},{"key":13,"length":2,"offset":24}],"inlineStyleRanges":[],"text":"Читайте нас в Telegram, VK","type":"unstyled","key":"1eee6"},{"data":{},"depth":0,"entityRanges":[{"key":14,"length":11,"offset":15},{"key":15,"length":87,"offset":28}],"inlineStyleRanges":[{"length":15,"offset":0,"style":"ITALIC"}],"text":"Перевод статьи Nisar Ahmed: Built-In Container Support for .NET 7 — Dockerize .NET Applications without Dockerfile!","type":"unstyled","key":"1vp0c"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"marker","key":"d6bI3ciPuhuUWkjqNn2s"}],"entityMap":{"11":{"data":{"href":"https://nuancesprog.ru/p/4838/","url":"https://nuancesprog.ru/p/4838/"},"mutability":"MUTABLE","type":"LINK"},"12":{"data":{"href":"https://t.me/nuancesprog","url":"https://t.me/nuancesprog"},"mutability":"MUTABLE","type":"LINK"},"13":{"data":{"href":"https://vk.com/nuancesprog","url":"https://vk.com/nuancesprog"},"mutability":"MUTABLE","type":"LINK"},"14":{"data":{"href":"https://medium.com/@mahmednisar?source=post_page-----997d4504ab9d--------------------------------","url":"https://medium.com/@mahmednisar?source=post_page-----997d4504ab9d--------------------------------"},"mutability":"MUTABLE","type":"LINK"},"15":{"data":{"href":"https://medium.com/@mahmednisar/built-in-container-support-for-net-7-dockerize-net-applications-without-dockerfile-997d4504ab9d","url":"https://medium.com/@mahmednisar/built-in-container-support-for-net-7-dockerize-net-applications-without-dockerfile-997d4504ab9d"},"mutability":"MUTABLE","type":"LINK"},"0":{"data":{"url":"https://nuancesprog.ru/p/18888/"},"mutability":"MUTABLE","type":"LINK"},"1":{"data":{"href":"https://dotnet.microsoft.com/en-us/download/dotnet/6.0","url":"https://dotnet.microsoft.com/en-us/download/dotnet/6.0"},"mutability":"MUTABLE","type":"LINK"},"2":{"data":{"href":"https://dotnet.microsoft.com/en-us/download/dotnet/7.0","url":"https://dotnet.microsoft.com/en-us/download/dotnet/7.0"},"mutability":"MUTABLE","type":"LINK"},"3":{"data":{"href":"https://www.docker.com/products/docker-desktop/","url":"https://www.docker.com/products/docker-desktop/"},"mutability":"MUTABLE","type":"LINK"},"4":{"data":{"href":"https://github.com/mahmednisar/built-in-container-support-for-dotnet-7","url":"https://github.com/mahmednisar/built-in-container-support-for-dotnet-7"},"mutability":"MUTABLE","type":"LINK"},"5":{"data":{"href":"http://+:5000/","url":"http://+:5000/"},"mutability":"MUTABLE","type":"LINK"},"6":{"data":{"href":"http://localhost:5000/WeatherForecast/,","url":"http://localhost:5000/WeatherForecast/,"},"mutability":"MUTABLE","type":"LINK"},"7":{"data":{"href":"https://github.com/dotnet/sdk-container-builds/blob/main/docs/ContainerCustomization.md","url":"https://github.com/dotnet/sdk-container-builds/blob/main/docs/ContainerCustomization.md"},"mutability":"MUTABLE","type":"LINK"},"8":{"data":{"href":"https://github.com/mahmednisar/built-in-container-support-for-dotnet-7","url":"https://github.com/mahmednisar/built-in-container-support-for-dotnet-7"},"mutability":"MUTABLE","type":"LINK"},"9":{"data":{"href":"https://nuancesprog.ru/p/16268/","url":"https://nuancesprog.ru/p/16268/"},"mutability":"MUTABLE","type":"LINK"},"10":{"data":{"href":"https://nuancesprog.ru/p/17807/","url":"https://nuancesprog.ru/p/17807/"},"mutability":"MUTABLE","type":"LINK"}}},"mentions":[]}