🥇 Guida CI/CD in GitLab pro (paene) inceptor absolutum

Vel quomodo ut speciosa insignia pro tuo consilio in uno vespere facili coding

Probabiliter, omnis elit, qui saltem unum delicium in aliquo puncto habet pruritum de insignibus pulchris cum statusibus, codice coverage, involucro versiones in nugete ... Et haec prurigo me ad hunc articulum scribendam duxit. Se ad eam scribendam nactus sum hanc pulchritudinem in uno consiliorum meorum;

Articulus hic te ambulabit per funda- menta fundamentalia continuae integrationis et traditionis pro .Net Core classium bibliothecae in GitLab proiectae, documenta libellorum GitLab Paginae editae, et sarcinas in Azure DevOps privatas innixus aedificavit.

VS Code was used as the development environment with the extension GitLab Workflow (pro certis fundis file directe ex ambitu evolutionis).

breves

CD - an cum impulisti modo, et iam omnia in clientelam inciderunt?

Quid CI/CD et quare hoc tibi opus est - facile google est. Reperire documenta integra in Vestibulum pipelines in GitLab etiam facile. Hic breviter et, si fieri potest, sine mendis describemus processum systematis ab oculo volucris intuitu;

a elit mittit repositorium committe, petitionem merge per locum creat; vel alio modo explicite vel implicite incipit pipeline,
omnia officia ex configuratione seliguntur, quarum condiciones in hoc contextu deduci sinunt;
functiones secundum gradus suos ordinantur;
vices geruntur in vicem — i.e. parallela omnia opera huius scaenae absolvuntur;
si scaena deficit (i.e., saltem una opera scaenicorum) cessat pipeline (i.e.fere semper),
si omnes gradus feliciter consummantur, pipelineum felix habetur.

Sic habemus;

pipeline - statuto officiorum in periodos ordinatos in quibus edificare, temptare, involucrum codicem potes, aedificatum ad nubem operae explicandam, etc.
scaena (tempus) - organizatio pipeline unitas, negotium 1+ continet;
negotium (job) est unitas operis in pipeline. Constat scriptionis (mandatorii) condiciones launch, occasus ad artificia edendi/cavendi, et multo plura.

Proinde, negotium, cum CI/CD constituendum est, descendit ad constituendum negotium conficiendum, quod omnes actiones necessarias ad aedificationem, probationem et codicem evulgandi et artificia conficiendi.

Priusquam incipias: quare?

Quare Gitlab?

Quia cum repositoria privata ad pet incepta creare necesse fuit, in GitHub habiti sunt, et avarus eram. Repositoria libera facta sunt, sed tantum ratio non sufficit ad GitHub.

Cur non caeruleus DevOps Pipelines?

Quia ibi occasus est elementaris — linea mandatorum scientia etiam non requiritur. Integratio cum provisoribus externis git - in duobus clicks, import of clavium SSH mittendi committit repositorium - etiam, pipelineum facile configuratur etiam non ex template.

Incipiens positio: quid habes et quid vis?

Habemus:

repositio in GitLab.

Volumus:

latae sententiae et probationes pro unoquoque merge rogante;
edificandi sarcinas pro unoquoque merge petentibus et impellentibus ad dominum, dummodo linea certa sit in verbo commisso;
mittens sarcinas aedificatas ad pascendum privatum in Azure DevOps;
conventus documentorum et publicationum in Paginae GitLab,
velamenta! 11

Requisita descripta organice cadunt in hoc exemplo pipeline:

Stage 1 - Conventus
- Colgimus codicem, lima outputa ut artificiata evulgamus
Stage 2 - test
- Artificia ex scaena aedificandi dabimus, probationes currunt, codicem notitiae coverage colligere
Stage 3 - Submit
- Negotium 1 - aedificare sarcinam nugetem et mitte caeruleam DevOps
- Negotium 2 - situm ex xmldoc in codice fonte colligimus et in Paginae GitLab divulgamus

Let's get started!

Colligendis configuratione

Praeparans rationes

Creare rationem in Microsoft caeruleum
Ite ad parma caerulea DevOps
Nos novum project creare
1. Nomen - ullus
2. Visibilitas - any
Cum strepita in Bulla Crea, consilium creabitur et ad paginam eius redirectaberis. Hac in pagina, lineamenta supervacua inactivare potes ut occasus propositi (inferior nexus in elencho sinistro -> Overview -> Azure DevOps Services angustos)
Ad Atrifacts, preme crea feed
1. Intra nomen fontis
2. Elige visio-
3. Licens Includit sarcinas de communibus publicis fontibusita ut fons in TUBER nuget clone non convertatur
Click Connect ad pascendum, eligere Visual Studio, effingo Source ex Machina Setup scandalum
Ad rationem occasus, eligere personalis Access Thochen
Novam aditum indicium
1. Nomen - arbitrary
2. Organization - Current
3. Valet ad maximum of I annos
4. Locus - Packaging / Read & Write
Effingo quod signum creatum - postquam fenestra modalis clausa est, valor unavailable erit
Vade ad occasus repositorii in GitLab, elige CI / CD occasus
Expand Variabiles scandalum, unum novum adde
1. Name - any without space (praesto erit in imperio testudo)
2. Valorem - accessum indicium ex articulo IX "
3. Lego larva variabilis

Hoc praefigurationem perficit.

Praeparans configuratione compage

Defalta CI/CD configuratione in GitLab tabella utitur .gitlab-ci.yml ab radice repositio. Huic fasciculi viam arbitrariam in occasus repositorii ponere potes, sed hoc in casu non est necessarium.

Ut videre potes ex extensione, tabella conformationem continet in forma YAML. Singula documenta quae claves contineri possunt in summo gradu configurationis et in singulis gradibus nestis.

Primum, adiciamus nexum ad imaginem scopulorum in file configurationis, in qua opera agenda erunt. Hoc enim invenimus .Net core imagines pagina in Docker Hub. Quod GitHub est dux singillatim in quo imago diversa opera eligere. Imago cum .Net Core 3.1 aptus est nobis aedificare, ut liberum tibi sit primam lineam conformationis addere.

image: mcr.microsoft.com/dotnet/core/sdk:3.1

Nunc, cum pipelinea e repositorio imaginis Microsoft excussum est, imago certa emissa erit, in qua omnia opera ex configuratione exequentur.

Proximum est addere tempusscriptoris. Defalta GitLab 5 gradus definit:

.pre — peractis omnibus gradibus;
.post — peractis omnibus gradibus;
build - primum post .pre scaena;
test — secunda periodus;
deploy — Scaena tertia.

Nihil tamen prohibet te ea expresse declarare. Ordo quo gradus enumerantur, pertinet ad ordinem quo aguntur. Ad perfectionem, ad schematismus addamus:

stages:
  - build
  - test
  - deploy

Ad debugging, sensum praebet notitias de ambitu in quo opera exercentur. Adiciamus statuto globali mandatorum quae coram unoquoque negotio peragentur before_script:

before_script:
  - $PSVersionTable.PSVersion
  - dotnet --version
  - nuget help | select-string Version

Reliquum est ut unum saltem negotium addas ut, commissis missis, fistula incipiet. Nunc enim inane addamus negotium ad demonstrandum:

dummy job:
  script:
    - echo ok

Incipimus sanationem, nuntium accipimus omnia bona esse, committimus, impellimus, eventus in situ intuemur ... Et errorem scriptionem obtinemus - bash: .PSVersion: command not found. Filum?

Omnia logica sunt - per defaltam, cursores (responsabilis ad negotium scriptorum capiendum et a GitLab provisum) usus bash imperata facere. Hoc figere potes per expresse denotans in descriptione operis quod habeat cursorem exsecutionem pipelineorum;

dummy job on windows:
  script:
    - echo ok
  tags:
    - windows

Magna! Pipeline nunc currit.

Lector attentus, indicatis gradibus iteratis, animadvertet negotium in scenico confectum esse testetsi scenam non definivit. Ut ut coniecto test default gradus est.

Configurationem sceleti creare pergamus addendo omnia opera supra scripta:

build job:
  script:
    - echo "building..."
  tags:
    - windows
  stage: build

test and cover job:
  script:
    - echo "running tests and coverage analysis..."
  tags:
    - windows
  stage: test

pack and deploy job:
  script:
    - echo "packing and pushing to nuget..."
  tags:
    - windows
  stage: deploy

pages:
  script:
    - echo "creating docs..."
  tags:
    - windows
  stage: deploy

Venimus non maxime functionem, sed tamen rectam pipelineam.

Profecta triggers

Ob id quod nulla felis columellae specificatae sunt pro quolibet officiorum, fistulae voluntatis plene exsecutioni mandari quotienscumque ad repositorium commissum impellitur. Cum hoc non sit mores desiderati in genere, felis filtra ad opera ponemus.

Filtra configurari possunt in duabus formatis: nisi / nisi и praecepta. Breviter, only/except sino vos configurare Filtra per triggers (merge_requestexempli gratia - negotium conficiendi singulis diebus viverra petitio creatur et omne tempus committit mittuntur ad ramum, qui fons est in merge petitionem) et ramus nomina (including expressions regularibus utens); rules sino vos ut condiciones condiciones customize et, optione, negotium execu- tionis mutetis secundum successum operum priorum (when in GitLab CI/CD).

In memoriam revocemus praescriptum requisitorum - conventus et tantum ad petitionem merge, packaging et mittens ad DevOps caeruleum - pro merge petitione et impellente ad dominum, generationis documentorum - pro impellente ad dominum.

Primum, signum aedificare molis constituamus addendo regulae ignes tantum in verba mergendi:

build job:
  # snip
  only:
    - merge_request

Nunc constituamus negotium sarcinarium ut ignem in merge preces et committit domino addendi:

pack and deploy job:
  # snip
  only:
    - merge_request
    - master

Ut vides, omnia simplicia et aperta sunt.

Negotium igni quoque imponere potes solum si postulatio merge cum certo scopo vel fonte ramo creetur;

  rules:
    - if: $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "master"

Sub conditionibus uti potes variables hic enumerantur; praecepta rules repugnat praecepta only/except.

Salvum Vestibulum Artificium

Per negotium build job artificialia aedificabimus quae in subsequentibus operibus reddi possunt. Ad hoc faciendum, vias ad configurationis negotium addere debes, tabellas per quas servare et reuse in sequentibus operibus clavis debes. artifacts:

build job:
  # snip
  artifacts:
    paths:
      - path/to/build/artifacts
      - another/path
      - MyCoolLib.*/bin/Release/*

Viae wildcards support, quae definite faciliores reddit.

Si negotium artificiosas creaverit, singulae subsequentes partes ad ea accedere poterunt - eaedem semitae collocabuntur ad radicem repositoriam quae ex operis originali collectae erant. Artificia etiam in promptu sunt pro cinematographico ex situ.

Nunc ut conformationem compagem paratam (et probatam) habemus, procedere possumus ad scripta actuaria opera scribenda.

Scripta sumus scribere

Fortasse, olim, in via galaxia longe, procul, incepta aedificium (inclusa in .net) ex linea praecepti dolor erat. Nunc aedificare potes, experire et ede documentum in 3 iugis:

dotnet build
dotnet test
dotnet pack

Naturaliter sunt aliquas nuances ex quibus aliquid iussa complicabimus.

Dimissionem aedificare volumus, non debug aedificare, itaque unicuique mandatum addimus -c Release
Cum probatio, codicem coverage notitias colligere velimus, ergo necesse est ut analysrem coverage in tesseris bibliothecis includere;
1. Addere sarcinam ad omnes examinis libraries coverlet.msbuild: dotnet add package coverlet.msbuild de project folder
2. Add to the test run imperium /p:CollectCoverage=true
3. Clavem ad experimentum operis configuratione ut eventus coverage (vide infra) adde
Cum codicem in fasciculos nugetes stipare, output directorium pro fasciculis constitue: -o .

Collectis codice coverage notitia

Post currendo probationes, cursorium vestigia currunt mutant ad consolatorium:

Calculating coverage result...
  Generating report 'C:Usersxxxsourcereposmy-projectmyProject.testscoverage.json'

+-------------+--------+--------+--------+
| Module      | Line   | Branch | Method |
+-------------+--------+--------+--------+
| project 1   | 83,24% | 66,66% | 92,1%  |
+-------------+--------+--------+--------+
| project 2   | 87,5%  | 50%    | 100%   |
+-------------+--------+--------+--------+
| project 3   | 100%   | 83,33% | 100%   |
+-------------+--------+--------+--------+

+---------+--------+--------+--------+
|         | Line   | Branch | Method |
+---------+--------+--------+--------+
| Total   | 84,27% | 65,76% | 92,94% |
+---------+--------+--------+--------+
| Average | 90,24% | 66,66% | 97,36% |
+---------+--------+--------+--------+

GitLab permittit tibi expressionem regularem denotare ut statistica, quae tunc in insigni forma obtinetur. The regular expression is specified in the task settings with the key coverage; expressio coetus captivorum continere debet, cuius valor ad insigne tradetur;

test and cover job:
  # snip
  coverage: /|s*Totals*|s*(d+[,.]d+%)/

Hic statisticam e linea cum linea summa coverage accipimus.

Fasciculi et documenta publicare

Ambae actiones pro ultimo gradu organi acceduntur - ex quo coetus ac probationes praeterierunt, possumus nostras progressiones cum mundo communicare.

Primum considera libellorum ad fontem involucrum;

Si project non habet file configuratione nuget (nuget.config) novum creare; dotnet new nugetconfig

Quod: imago ad figuras global (usoris et machinae) accessum scribere non potest. Ut errores non capiamus, simpliciter novam conformationem localem creamus et cum eo laboramus.
Addamus novam sarcinam fonte locali conformationis: nuget sources add -name <name> -source <url> -username <organization> -password <gitlab variable> -configfile nuget.config -StorePasswordInClearText
1. name - loci fons nomen, non criticum
2. url - Domicilium fontis e scaena "Rationes Praeparandae", p
3. organization - organization nomen in Azure DevOps
4. gitlab variable - nomen variabilis cum additamento GitLab accessum ("Rationes Praeparans", p. 11). Videlicet in forma $variableName
5. -StorePasswordInClearText - hack ut accessum bypass error negavit (Non sum primus gradus in hac sarculo)
6. In casu errorum, addere utile erit -verbosity detailed
Mittens sarcina ad fontem: nuget push -source <name> -skipduplicate -apikey <key> *.nupkg
1. Omnes sarcinas ex indice currenti mittimus, sic *.nupkg.
2. name — de gradu superiore.
3. key — quavis acie. In DevOpis caeruleo, in Connecte ad fenestram pascendam, exemplum lineae semper est az.
4. -skipduplicate - cum conatur mittere sarcinam iam existentem sine hac clavis, fons errorem reddet 409 Conflict; clavem mittens mittetur.

Nunc creationem documentorum constituamus;

Primum, in reposito, in ramo magistro, initializemus docfx documentum. Ad hoc, ab radice currite mandatum docfx init et interactive pone clavem parametri ad documenta aedificanda. ENARRATIO ad minimum project setup hic.
1. Cum configurans, refert ad output directorium specificare ..public - GitLab per default accipit contenta folder publici in radice repositorii ut fons Paginae. Quod exertus collocabitur in folder in repositorio collocabitur - output adde ad gradum in via.
Detrudamus mutationes GitLab.
Addere negotium ad pipeline configuratione pages (verbum reservatum pro situ publicandi munia in Paginae GitLab);
1. Scriptor:
  1. nuget install docfx.console -version 2.51.0 — instituunt docfx; versio specificatur ut involucrum viae institutionis rectae sint.
  2. .docfx.console.2.51.0toolsdocfx.exe .docfx_projectdocfx.json - colligendis documentis
2. Node artificia;

pages:
  # snip
  artifacts:
    paths:
      - public

Digressio lyrica circa docfx

Antea, cum in re consilium ponerem, codicem fons documentorum tamquam solutionem fasciculi indicavi. Praecipuum incommodum est quod documenta etiam ad experimenta incepta creata sunt. Si hoc non est necessarium, hanc valorem nodi constituere potes metadata.src:

{
  "metadata": [
    {
      "src": [
        {
          "src": "../",
          "files": [
            "**/*.csproj"
          ],
          "exclude":[
            "*.tests*/**"
          ]
        }
      ],
      // --- snip ---
    },
    // --- snip ---
  ],
  // --- snip ---
}

metadata.src.src: "../" - imus uno gradu usque ad locum docfx.json, quod in exemplaria, indagatione arboris indicem non operatur.
metadata.src.files: ["**/*.csproj"] - exemplaris globalis, omnia C # incepta ab omnibus directoriis colligimus.
metadata.src.exclude: ["*.tests*/**"] - global exemplar, excludit omnia a folder cum .tests In titulo

Subtotal

Talis figura simplex creari potest in dimidia hora tantum et in duobus poculis capulus, quod tibi permittet ut inspicias quod signum aedificatum sit et probationes praeterire, novam sarcinam aedificare, documenta renovare et oculis pulchris placere. insignia in README exerti cum singulis rogationibus merge et ad dominum mittendo.

Final .gitlab-ci.yml

image: mcr.microsoft.com/dotnet/core/sdk:3.1

before_script:
  - $PSVersionTable.PSVersion
  - dotnet --version
  - nuget help | select-string Version

stages:
  - build
  - test
  - deploy

build job:
  stage: build
  script:
    - dotnet build -c Release
  tags:
    - windows
  only:
    - merge_requests
    - master
  artifacts:
    paths:
      - your/path/to/binaries

test and cover job:
  stage: test
  tags:
    - windows
  script:
    - dotnet test -c Release /p:CollectCoverage=true
  coverage: /|s*Totals*|s*(d+[,.]d+%)/
  only:
    - merge_requests
    - master

pack and deploy job:
  stage: deploy
  tags:
    - windows
  script:
    - dotnet pack -c Release -o .
    - dotnet new nugetconfig
    - nuget sources add -name feedName -source https://pkgs.dev.azure.com/your-organization/_packaging/your-feed/nuget/v3/index.json -username your-organization -password $nugetFeedToken -configfile nuget.config -StorePasswordInClearText
    - nuget push -source feedName -skipduplicate -apikey az *.nupkg
  only:
    - master

pages:
  tags:
    - windows
  stage: deploy
  script:
    - nuget install docfx.console -version 2.51.0
    - $env:path = "$env:path;$($(get-location).Path)"
    - .docfx.console.2.51.0toolsdocfx.exe .docfxdocfx.json
  artifacts:
    paths:
      - public
  only:
    - master

Loquens de insignibus

Ex eis tamen omnia orta sunt!

Insignia cum statuses pipeline et codice coverage in promptu sunt in GitLab in CI/CD occasus in pipelines Gtntral angustos:

Insigne creavi nexum cum documentis in contionibus shields.io - Omnia ibi prorsus aperta sunt, tuum signum creare potes et per petitionem accipere.

![Пример с Shields.io](https://img.shields.io/badge/custom-badge-blue)

Caeruleus DevOps Artificia etiam dat tibi insignia fasciculorum cum recentiori versione. Facere hoc in fonte in situ DevOparum caeruleo, debes strepere in Crea insigne sarcinae electae et describe notam notam:

addit pulchritudinem

Illuminatio Communia Configurationis Fragmenta

Dum figuram scribens et per documenta scrutans, per interesting notam YAML - fragmenta reusing veni.

Ut videre potes e munere occasus, omnes tag egent windows apud cursorem et utitur cum merge petitio ad dominum mittitur / creatum (exceptis documentis). Addamus hoc fragmento quod reuse erimus:

.common_tags: &common_tags
  tags:
    - windows
.common_only: &common_only
  only:
    - merge_requests
    - master

Nunc autem inserere possumus fragmentum antea in descriptione operis declaratum;

build job:
  <<: *common_tags
  <<: *common_only

Fragmentum nominum a puncto incipiendum est, ne intelligantur negotium.

Package versioning

Cum involucrum creando, compilator virgas lineas imperare coercet, et, absentibus, fasciculi documenti sunt; cum nodi versionem invenerit, valorem suum accipit sicut versio involucrum aedificatur. Evenit ut sarcinam cum nova versione aedificet, necesse est ut vel in lima documenti proiciatur, vel ut argumentum lineae iubeat praeterire.

Unum addere volueris - minor duobus numeris in versione annus sit et tempus sarcinae construat, et versiones praerelease addat. Utique, haec notitia documenti documenti addere potes et ante quamlibet subiectionem deprime - sed etiam in pipelino facere potes, versionem involucrum ex contextu colligens et per argumentum lineae mandatum praeteriens.

Lets assentior quod si mandatum committere ut lineam contineat release (v./ver./version) <version number> (rev./revision <revision>)?ex hac linea versionem involucrum capiemus, eamque hodiernam diem supplebimus et eam tanquam argumentum ad praeceptum transferemus. dotnet pack. In linea deficiente, sarcinam simpliciter non colligemus.

Hoc problema solvit sequens scriptum:

# регулярное выражение для поиска строки с версией
$rx = "releases+(v.?|ver.?|version)s*(?<maj>d+)(?<min>.d+)?(?<rel>.d+)?s*((rev.?|revision)?s+(?<rev>[a-zA-Z0-9-_]+))?"
# ищем строку в сообщении коммита, передаваемом в одной из предопределяемых GitLab'ом переменных
$found = $env:CI_COMMIT_MESSAGE -match $rx
# совпадений нет - выходим
if (!$found) { Write-Output "no release info found, aborting"; exit }
# извлекаем мажорную и минорную версии
$maj = $matches['maj']
$min = $matches['min']
# если строка содержит номер релиза - используем его, иначе - текущий год
if ($matches.ContainsKey('rel')) { $rel = $matches['rel'] } else { $rel = ".$(get-date -format "yyyy")" }
# в качестве номера сборки - текущие месяц и день
$bld = $(get-date -format "MMdd")
# если есть данные по пререлизной версии - включаем их в версию
if ($matches.ContainsKey('rev')) { $rev = "-$($matches['rev'])" } else { $rev = '' }
# собираем единую строку версии
$version = "$maj$min$rel.$bld$rev"
# собираем пакеты
dotnet pack -c Release -o . /p:Version=$version

Addit scriptum ad negotium pack and deploy job et observate congregationem fasciculorum stricte coram aliquo chordarum nuntio commisso.

in summa

Postquam dimidia fere hora vel hora scribebat configurationem, debugging in potestati locali et, fortasse, duo incassum iactus, simplicem conformationem cepimus pro functionibus exercitationis automandi.

Scilicet, GitLab CI / CD est multo latius et multifacetus quam videri posset hoc duce perlectis -. quod omnino non est verum. Est etiam Auto DevOps estpermittens

automatice deprehendere, aedificare, experire, explica et monitor applicationes tuas

Nunc consilia conformare pipelineum ad applicationes ad Azureum explicandas, Pulumi utendo et automatice ad scopum ambitus determinandum, quod proximo articulo operietur.

Source: www.habr.com

A duce ad CI/CD in GitLab pro incipiente absoluto