विन्डोज छविहरू निर्माण गर्न डकर बहु-चरण प्रयोग गर्दै

सबैलाई नमस्ते! मेरो नाम एन्ड्रे हो, र म Exness मा विकास टोलीमा DevOps इन्जिनियरको रूपमा काम गर्छु। मेरो प्राथमिक ध्यान अपरेटिङ सिस्टममा चल्ने डकर अनुप्रयोगहरू निर्माण, तैनाथ र मर्मत गर्नु हो। Linux (यसपछि OS भनेर उल्लेख गरिएको छ)। केही समय अघि, मेरो पनि त्यस्तै गतिविधिहरू भएको एउटा काम थियो, तर परियोजनाको लक्षित OS बन्यो Windows Server и набор проектов на C++. Для меня это было первое плотное взаимодействие c docker контейнерами под ОС Windows и в целом с приложениями на C++. Благодаря этому я получил интересный опыт и узнал о некоторых тонкостях контейнеризации приложений в ОС Windows.

यस लेखमा म तपाईलाई बताउन चाहन्छु कि मैले कस्ता कठिनाइहरूको सामना गर्नुपरेको थियो र मैले तिनीहरूलाई कसरी समाधान गर्न सकें। मलाई आशा छ कि तपाईंले यो तपाईंको वर्तमान र भविष्यका चुनौतीहरूको लागि उपयोगी पाउनुभयो। पढेर आनन्द लिनुहोस्!

किन कन्टेनरहरू?

В компании есть существующая инфраструктура оркестратора контейнеров Hashicorp Nomad и связанных компонентов — Consul и Vault. Поэтому контейнеризация приложений была выбрана как унифицированный метод доставки готового решения. Так как в инфраструктуре проекта имеются docker-хосты с версиями ОС Windows Server Core 1803 и 1809, то необходимо собирать отдельно версии docker-образов для 1803 и 1809. В версии 1803 важно помнить о том, что номер ревизии сборочного docker-хоста должен совпадать с номером ревизии базового docker-образа и хоста, где контейнер из этого образа будет запущен. Версия 1809 лишена такого недостатка. Подробнее можно прочитать यहाँ.

किन बहु-चरण?

विकास टोली ईन्जिनियरहरूसँग होस्टहरू निर्माण गर्नको लागि कुनै वा धेरै सीमित पहुँच छैन; यी होस्टहरूमा एप्लिकेसन निर्माण गर्नका लागि कम्पोनेन्टहरूको सेट द्रुत रूपमा व्यवस्थित गर्ने कुनै तरिका छैन, उदाहरणका लागि, भिजुअल स्टुडियोको लागि अतिरिक्त उपकरणसेट वा कार्यभार स्थापना गर्नुहोस्। त्यसकारण, हामीले बिल्ड डकर छविमा एप्लिकेसन निर्माण गर्न आवश्यक सबै कम्पोनेन्टहरू स्थापना गर्ने निर्णय गर्यौं। यदि आवश्यक छ भने, तपाइँ चाँडै मात्र डकरफाइल परिवर्तन गर्न सक्नुहुन्छ र यो छवि सिर्जना गर्न पाइपलाइन सुरु गर्न सक्नुहुन्छ।

सिद्धान्त देखि कार्य सम्म

एक आदर्श डकर बहु-चरण छवि निर्माणमा, एप्लिकेसन निर्माणको लागि वातावरण एउटै डकरफाइल लिपिमा एप्लिकेसन आफैं निर्माण गरिएको रूपमा तयार हुन्छ। तर हाम्रो केसमा, एक मध्यवर्ती लिङ्क थपिएको थियो, अर्थात्, अनुप्रयोग निर्माण गर्न आवश्यक सबै चीजको साथ डकर छवि सिर्जना गर्ने प्रारम्भिक चरण। यो गरियो किनभने म सबै निर्भरताहरूको स्थापना समय कम गर्न डकर क्यास सुविधा प्रयोग गर्न चाहन्थे।

यो छवि बनाउनको लागि डकरफाइल लिपिको मुख्य बिन्दुहरू हेरौं।

बिभिन्न OS संस्करणहरूको छविहरू सिर्जना गर्न, तपाईंले डकरफाइलमा एउटा तर्क परिभाषित गर्न सक्नुहुन्छ जसको माध्यमबाट संस्करण नम्बर निर्माणको क्रममा पास हुन्छ, र यो आधार छविको ट्याग पनि हो।

Полный список тэгов образов Microsoft Windows Server पाउन सक्नुहुन्छ यहाँ.

ARG WINDOWS_OS_VERSION=1809
FROM mcr.microsoft.com/windows/servercore:$WINDOWS_OS_VERSION

पूर्वनिर्धारित रूपमा निर्देशनहरूमा आदेशहरू RUN внутри dockerfile в ОС Windows выполняются в консоли cmd.exe. Для удобства написания скриптов и расширения функционала используемых команд переопределим консоль исполнения команд на Powershell через инструкцию SHELL.

SHELL ["powershell", "-Command", "$ErrorActionPreference = 'Stop';"]

अर्को चरण चकलेट प्याकेज प्रबन्धक र आवश्यक प्याकेजहरू स्थापना गर्न हो:

COPY chocolatey.pkg.config .
RUN Set-ExecutionPolicy Bypass -Scope Process -Force ;
    [System.Net.ServicePointManager]::SecurityProtocol = 
    [System.Net.ServicePointManager]::SecurityProtocol -bor 3072 ;
    $env:chocolateyUseWindowsCompression = 'true' ;
    iex ((New-Object System.Net.WebClient).DownloadString( 
      'https://chocolatey.org/install.ps1')) ;
    choco install chocolatey.pkg.config -y --ignore-detected-reboot ;
    if ( @(0, 1605, 1614, 1641, 3010) -contains $LASTEXITCODE ) { 
      refreshenv; } else { exit $LASTEXITCODE; } ;
    Remove-Item 'chocolatey.pkg.config'

chocolatey प्रयोग गरेर प्याकेजहरू स्थापना गर्न, तपाईंले तिनीहरूलाई सूचीको रूपमा पास गर्न सक्नुहुन्छ, वा यदि तपाईंले प्रत्येक प्याकेजको लागि अद्वितीय प्यारामिटरहरू पास गर्न आवश्यक छ भने तिनीहरूलाई एक पटकमा स्थापना गर्नुहोस्। हाम्रो अवस्थामा, हामीले XML ढाँचामा manifest फाइल प्रयोग गर्यौं, जसमा आवश्यक प्याकेजहरू र तिनीहरूको प्यारामिटरहरूको सूची समावेश छ। यसको सामग्री यस प्रकार देखिन्छ:

<?xml version="1.0" encoding="utf-8"?>
<packages>
  <package id="python" version="3.8.2"/>
  <package id="nuget.commandline" version="5.5.1"/>
  <package id="git" version="2.26.2"/>
</packages>

अर्को, हामी एप्लिकेसन निर्माण वातावरण स्थापना गर्छौं, अर्थात्, MS Build Tools 2019 - यो Visual Studio 2019 को हल्का संस्करण हो, जसमा कम्पाइलिङ कोडका लागि आवश्यक पर्ने घटकहरूको न्यूनतम सेट समावेश हुन्छ।
हाम्रो C++ परियोजनासँग पूर्ण रूपमा काम गर्न, हामीलाई थप कम्पोनेन्टहरू चाहिन्छ, अर्थात्:

• कार्यभार C++ उपकरणहरू
• Toolset v141
• Windows 10 SDK (10.0.17134.0)

तपाईं JSON ढाँचामा कन्फिगरेसन फाइल प्रयोग गरी स्वचालित रूपमा उपकरणहरूको विस्तारित सेट स्थापना गर्न सक्नुहुन्छ। कन्फिगरेसन फाइल सामग्री:

उपलब्ध कम्पोनेन्टहरूको पूर्ण सूची कागजात साइटमा फेला पार्न सकिन्छ माइक्रोसफ्ट भिजुअल स्टुडियो.

{
  "version": "1.0",
  "components": [
    "Microsoft.Component.MSBuild",
    "Microsoft.VisualStudio.Workload.VCTools;includeRecommended",
    "Microsoft.VisualStudio.Component.VC.v141.x86.x64",
    "Microsoft.VisualStudio.Component.Windows10SDK.17134"
  ]
}

डकरफाइलले स्थापना स्क्रिप्ट चलाउँछ, र सुविधाको लागि, वातावरण चरमा निर्माण उपकरण कार्यान्वयनयोग्य फाइलहरूमा मार्ग थप्छ। PATH। छविको साइज कम गर्न अनावश्यक फाइलहरू र डाइरेक्टरीहरू हटाउन पनि सल्लाह दिइन्छ।

COPY buildtools.config.json .
RUN Invoke-WebRequest 'https://aka.ms/vs/16/release/vs_BuildTools.exe' 
      -OutFile '.vs_buildtools.exe' -UseBasicParsing ;
    Start-Process -FilePath '.vs_buildtools.exe' -Wait -ArgumentList 
      '--quiet --norestart --nocache --config C:buildtools.config.json' ;
    Remove-Item '.vs_buildtools.exe' ;
    Remove-Item '.buildtools.config.json' ;
    Remove-Item -Force -Recurse 
      'C:Program Files (x86)Microsoft Visual StudioInstaller' ;
    $env:PATH = 'C:Program Files (x86)Microsoft Visual Studio2019BuildToolsMSBuildCurrentBin;' + $env:PATH; 
    [Environment]::SetEnvironmentVariable('PATH', $env:PATH, 
      [EnvironmentVariableTarget]::Machine)

यस चरणमा, C++ अनुप्रयोग कम्पाइल गर्ने हाम्रो छवि तयार छ, र हामी अनुप्रयोगको डकर बहु-चरण निर्माण गर्न सिधै अगाडि बढ्न सक्छौं।

कार्यमा बहु-चरण

हामी निर्माण छविको रूपमा बोर्डमा सबै उपकरणहरूसँग सिर्जना गरिएको छवि प्रयोग गर्नेछौं। अघिल्लो डकरफाइल स्क्रिप्टमा जस्तै, हामी कोड पुन: प्रयोगको सजिलोको लागि संस्करण नम्बर/छवि ट्याग गतिशील रूपमा निर्दिष्ट गर्ने क्षमता थप्नेछौं। यो लेबल थप्न महत्त्वपूर्ण छ as builder निर्देशनहरूमा विधानसभा छविमा FROM.

ARG WINDOWS_OS_VERSION=1809
FROM buildtools:$WINDOWS_OS_VERSION as builder

अब यो अनुप्रयोग निर्माण गर्न समय हो। यहाँ सबै कुरा एकदम सरल छ: स्रोत कोड र यससँग सम्बन्धित सबै कुरा प्रतिलिपि गर्नुहोस्, र संकलन प्रक्रिया सुरु गर्नुहोस्।

COPY myapp .
RUN nuget restore myapp.sln ;
    msbuild myapp.sln /t:myapp /p:Configuration=Release

अन्तिम छवि सिर्जना गर्ने अन्तिम चरण भनेको अनुप्रयोगको आधार छवि निर्दिष्ट गर्नु हो, जहाँ सबै संकलन कलाकृतिहरू र कन्फिगरेसन फाइलहरू अवस्थित हुनेछन्। मध्यवर्ती विधानसभा छविबाट संकलित फाइलहरू प्रतिलिपि गर्न, तपाईंले प्यारामिटर निर्दिष्ट गर्नुपर्छ --from=builder निर्देशनहरूमा COPY.

FROM mcr.microsoft.com/windows/servercore:$WINDOWS_OS_VERSION

COPY --from=builder C:/x64/Release/myapp/ ./
COPY ./configs ./

अब बाँकी रहेको हाम्रो अनुप्रयोगको लागि आवश्यक निर्भरताहरू थप्न र निर्देशनहरू मार्फत प्रक्षेपण आदेश निर्दिष्ट गर्न हो। ENTRYPOINT वा CMD.

निष्कर्षमा

В этой статье я рассказал, как создать полноценную среду компиляции C++ приложений внутри контейнера под Windows и о том, как использовать возможности docker multi-stage сборок для создания полноценных образов нашего приложения.

स्रोत: www.habr.com