Docker მრავალსაფეხურიანი გამოყენება Windows-ის სურათების შესაქმნელად

Სალამი ყველას! მე მქვია ანდრეი და ვმუშაობ DevOps-ის ინჟინრად Exness-ში განვითარების გუნდში. ჩემი ძირითადი საქმიანობა დაკავშირებულია Linux ოპერაციული სისტემის ქვეშ დოკერში აპლიკაციების შექმნასთან, დანერგვასთან და მხარდაჭერასთან (შემდგომში OS). ცოტა ხნის წინ მქონდა დავალება იგივე აქტივობებით, მაგრამ პროექტის სამიზნე OS იყო Windows Server და C++ პროექტების ნაკრები. ჩემთვის ეს იყო პირველი მჭიდრო ურთიერთქმედება დოკერის კონტეინერებთან Windows OS-ით და, ზოგადად, C++ აპლიკაციებთან. ამის წყალობით, მე მივიღე საინტერესო გამოცდილება და გავიგე Windows-ში აპლიკაციების კონტეინერიზაციის ზოგიერთი სირთულეების შესახებ.

ამ სტატიაში მინდა გითხრათ, რა სირთულეების გადალახვა მომიწია და როგორ მოვახერხე მათი მოგვარება. ვიმედოვნებ, რომ ეს სასარგებლო იქნება თქვენი მიმდინარე და მომავალი გამოწვევებისთვის. ისიამოვნეთ კითხვით!

რატომ კონტეინერები?

კომპანიას აქვს არსებული ინფრასტრუქტურა Hashicorp Nomad კონტეინერის ორკესტრისთვის და მასთან დაკავშირებული კომპონენტებისთვის - Consul and Vault. ამიტომ, განაცხადის კონტეინერიზაცია არჩეულ იქნა, როგორც ერთიანი მეთოდი სრული გადაწყვეტის მიწოდებისთვის. ვინაიდან პროექტის ინფრასტრუქტურა შეიცავს დოკერ ჰოსტებს Windows Server Core OS ვერსიებით 1803 და 1809, აუცილებელია დოკერის სურათების ცალკეული ვერსიების შექმნა 1803 და 1809 წლებისთვის. 1803 ვერსიაში მნიშვნელოვანია გვახსოვდეს, რომ build docker ჰოსტის რევიზიის ნომერი უნდა შეესაბამებოდეს საბაზისო დოკერის გამოსახულების რევიზიის ნომერს და მასპინძელს, სადაც ამ სურათიდან კონტეინერი გაიშვება. 1809 ვერსიას არ აქვს ასეთი ნაკლი. შეგიძლიათ მეტი წაიკითხოთ აქ.

რატომ მრავალსაფეხურიანი?

განვითარების გუნდის ინჟინრებს არ აქვთ ან ძალიან შეზღუდული წვდომა აქვთ ჰოსტების შექმნაზე; არ არსებობს საშუალება სწრაფად მართოთ კომპონენტების ნაკრები ამ ჰოსტებზე აპლიკაციის შესაქმნელად, მაგალითად, დააინსტალიროთ დამატებითი ხელსაწყოების ნაკრები ან სამუშაო დატვირთვა Visual Studio-სთვის. ამიტომ, ჩვენ მივიღეთ გადაწყვეტილება, დაგვეყენებინა ყველა კომპონენტი, რომელიც აუცილებელია აპლიკაციის ასაშენებლად build Docker სურათში. საჭიროების შემთხვევაში, შეგიძლიათ სწრაფად შეცვალოთ მხოლოდ dockerfile და გაუშვათ მილსადენი ამ სურათის შესაქმნელად.

თეორიიდან მოქმედებამდე

იდეალური Docker მრავალსაფეხურიანი გამოსახულების კონსტრუქციაში, აპლიკაციის შესაქმნელად გარემო მზადდება იმავე Dockerfile სკრიპტით, როგორც თავად აპლიკაციაა აგებული. მაგრამ ჩვენს შემთხვევაში, დაემატა შუალედური ბმული, კერძოდ, დოკერის გამოსახულების წინასწარი შექმნის ეტაპი, ყველა საჭირო აპლიკაციის შესაქმნელად. ეს გაკეთდა იმის გამო, რომ მე მინდოდა გამომეყენებინა დოკერის ქეში ფუნქცია ყველა დამოკიდებულების ინსტალაციის დროის შესამცირებლად.

მოდით გადავხედოთ dockerfile სკრიპტის ძირითად პუნქტებს ამ სურათის შესაქმნელად.

OS-ის სხვადასხვა ვერსიის გამოსახულების შესაქმნელად, შეგიძლიათ განსაზღვროთ არგუმენტი dockerfile-ში, რომლის მეშვეობითაც ვერსიის ნომერი გადაეცემა build-ის დროს და ასევე არის საბაზისო სურათის ტეგი.

Microsoft Windows Server-ის გამოსახულების ტეგების სრული სია შეგიძლიათ ნახოთ აქ.

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

ნაგულისხმევი ბრძანებები ინსტრუქციებში RUN Windows OS-ის dockerfile-ში ისინი შესრულებულია 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'

შოკოლადის გამოყენებით პაკეტების დასაყენებლად, შეგიძლიათ უბრალოდ გადასცეთ ისინი სიის სახით, ან დააინსტალიროთ სათითაოდ, თუ თითოეული პაკეტისთვის უნიკალური პარამეტრების გადაცემა გჭირდებათ. ჩვენს სიტუაციაში, ჩვენ გამოვიყენეთ manifest ფაილი XML ფორმატში, რომელიც შეიცავს საჭირო პაკეტების ჩამონათვალს და მათ პარამეტრებს. მისი შინაარსი ასე გამოიყურება:

<?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++ ინსტრუმენტები
• ინსტრუმენტების ნაკრები v141
• Windows 10 SDK (10.0.17134.0)

შეგიძლიათ დააინსტალიროთ ინსტრუმენტების გაფართოებული ნაკრები ავტომატურად JSON ფორმატში კონფიგურაციის ფაილის გამოყენებით. კონფიგურაციის ფაილის შინაარსი:

ხელმისაწვდომი კომპონენტების სრული სია შეგიძლიათ იხილოთ დოკუმენტაციის საიტზე Microsoft Visual Studio.

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

Dockerfile აწარმოებს ინსტალაციის სკრიპტს და მოხერხებულობისთვის, გარემოს ცვლადში ამატებს გზას build ინსტრუმენტების შესრულებადი ფაილებისკენ 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++ აპლიკაციის კომპილაციის ჩვენი სურათი მზად არის და შეგვიძლია პირდაპირ გავაგრძელოთ აპლიკაციის დოკერის მრავალსაფეხურიანი კონსტრუქციის შექმნა.

მრავალსაფეხურიანი მოქმედება

ჩვენ გამოვიყენებთ შექმნილ სურათს ბორტზე არსებული ყველა ხელსაწყოთი, როგორც build image. როგორც წინა dockerfile სკრიპტში, ჩვენ დავამატებთ ვერსიის ნომრის/სურათის ტეგის დინამიურად განსაზღვრის შესაძლებლობას კოდის ხელახალი გამოყენების გასაადვილებლად. მნიშვნელოვანია ეტიკეტის დამატება 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 კონტეინერში და როგორ გამოვიყენოთ დოკერის მრავალსაფეხურიანი კონსტრუქციების შესაძლებლობები ჩვენი აპლიკაციის სრულფასოვანი სურათების შესაქმნელად.

წყარო: www.habr.com