Verzeichnisse

Damit Code Artefakte verarbeitet werden können müssen diese auf dem Build Agent gespeichert werden. Dazu gibt es verschiedene Möglichkeiten diese Artefakte auf den Build Agent zu bekommen. Ein Check-out aus dem Repository oder ein Download aus der Pipeline ist ebenfalls möglich.

OS	Verzeichnissstruktur
Windows	`D:\a\1\s`
Linux	`/home/vsts/work/1/s`
Mac	`/Users/runner/work/1/s`

Best Practice - Verzeichnisse

Wir geben jeden Pfad auf einem Verzeichniss mit dem / Schrägstrich an. Damit stellen wir sicher, dass Pfade auf Windows, Linux und Mac gelesen werden können.

Wie gehen wir mit den Verzeichnissen auf den Verschiedenen Agents um?

Damit wir uns nicht um die verschiedenen Verzeichnisse der Agents kümmern müssen gibt es Variablen welche verwendet werden können. Die wichtigsten im überblick:

Variable	Beschreibung	Verwendung	Pfad
- Agent.BuildDirectory - Pipeline.Workspace	Der lokale Pfad auf dem Agent, in dem alle Ordner für eine bestimmte Buildpipeline erstellt werden.	`$(Agent.BuildDirectory)` `$(Pipeline.Workspace)`	`c:\agent_work\1`
Build.ArtifactStagingDirectory	Der lokale Pfad auf dem Agent, in den Artefakte kopiert werden, bevor sie an ihr Ziel gepusht werden.	`$(Build.ArtifactStagingDirectory)`	`c:\agent_work\1\a`
Build.BinariesDirectory	Der lokale Pfad auf dem Agent, den Sie als Ausgabeordner für kompilierte Binärdateien verwenden können. Standardmäßig sind keine neuen Buildpipelines zum bereinigen dieses Verzeichnisses eingerichtet. Sie können Ihren Build definieren, um ihn auf der Registerkarte Repositoryzu bereinigen.	`$(Build.BinariesDirectory)`	`c:\agent_work\1\b`
Build.Repository.LocalPath	Der lokale Pfad auf dem Agent, in den Ihre Quellcodedateien heruntergeladen werden.	`$(Build.Repository.LocalPath)`	`c:\agent_work\1\s`

Verwendung von Variablen

Syntax	Beispiel
Makro	`$(var)`

Pipeline umbau

Ändert die Build Pipeline wie folgt:

➕ hinzufügen

steps:
- checkout: self

- task: PowerShell@2
  displayName: Print Variable
  inputs:
    targetType: inline
    script: |
      echo $(Pipeline.Workspace)
      echo $(Agent.BuildDirectory)

- task: PowerShell@2
  displayName: Print Tree Path
  inputs:
    targetType: inline
    script: |
      tree $(Pipeline.Workspace) /a

➖ entfernen

- script: echo Hello, world!
  displayName: 'Run a one-line script'```

- script: |
    echo Add other tasks to build, test, and deploy your project.
    echo See https://aka.ms/yaml
  displayName: 'Run a multi-line script'

build.yml

trigger: none

pool:
  vmImage: windows-latest

steps:
- checkout: self

- task: PowerShell@2
  displayName: Print Variable
  inputs:
    targetType: inline
    script: |
      echo $(Pipeline.Workspace)
      echo $(Agent.BuildDirectory)

- task: PowerShell@2
  displayName: Print Tree Path
  inputs:
    targetType: inline
    script: |
      tree $(Pipeline.Workspace) /a

Pipeline Output

Print Variable

- task: PowerShell@2
  displayName: Print Variable
  inputs:
    targetType: inline
    script: |
      echo $(Pipeline.Workspace)
      echo $(Agent.BuildDirectory)

Print Tree Path

- task: PowerShell@2
  displayName: Print Tree Path
  inputs:
    targetType: inline
    script: |
      tree $(Pipeline.Workspace) /a

Zweites Repository

Legt ein zweites Repository mit dem Namen Code an geht dazu wie folgt vor.

Klickt auf Repos
Klickt auf Schulung
Klickt auf + New repository
Vergebt den Namen Code
Legt in dem Repository den ordner scripts an
Legt in dem Ordner das File an Publish-Processes.ps1

<#
    .SYNOPSIS 
        File with Processes
    .DESCRIPTION 
        This .ps1 file can a file with the processes.
    .NOTES
        Author:     [EXT] Benjamin Stehmans       
    .EXAMPLE
        .\Publish-Processes.ps1 -Name "Processes.txt" -Path "C:\Test"  

    .PARAMETER
        Name
            Name of the file to create 
        Path 
            Path to place the file                    

#>
[CmdletBinding()]
Param (
    [Parameter(Mandatory = $true, Position = 1, HelpMessage = "Name of the file.")]
    [String]$Name, 
    [Parameter(Mandatory = $true, Position = 2, HelpMessage = "Path to create file.")]
    [String]$Path 
    )

Get-Process | Out-String | Set-Content -Path $Path\$Name

Pipeline umbau

Ändert die Build Pipeline wie folgt:

➕ hinzufügen

resources:
 repositories:
   - repository: code
     type: git
     name: code

- checkout: code

build.yml

resources:
 repositories:
   - repository: code
     type: git
     name: code

trigger: none

pool:
  vmImage: windows-latest

steps:
- checkout: self
- checkout: code

- task: PowerShell@2
  displayName: Print Variable
  inputs:
    targetType: inline
    script: |
      echo $(Pipeline.Workspace)
      echo $(Agent.BuildDirectory)

- task: PowerShell@2
  displayName: Print Tree Path
  inputs:
    targetType: inline
    script: |
      tree $(Pipeline.Workspace) /a

Leserechte auf das Code repository

Damit die Pipeline auf das Coderepo zugreifen kann, muss eine Genehmigung erteilt werden.

Achtung – Die Falle mit dem Checkout Path

Wenn im Checkout-Schritt kein Pfad angegeben wird, wird der Quellcode in einem Standardverzeichnis abgelegt. Dieses Verzeichnis ist unterschiedlich, je nachdem, ob ein einzelnes Repository oder mehrere Repositories ausgecheckt werden.

Best Practice - Checkout

Damit wir keine Probleme mit dem Check-out oder den Pfaden haben werden wir immer einen Check-out Path angeben.

Pipeline umbau

Ändert die Build Pipeline wie folgt:

🏗️ ändern

steps:
- checkout: self
  path: schulung
- checkout: code
  path: code

build.yml

resources:
 repositories:
   - repository: code
     type: git
     name: code

trigger: none

pool:
  vmImage: windows-latest

steps:
- checkout: self
  path: schulung
- checkout: code
  path: code

- task: PowerShell@2
  displayName: Print Variable
  inputs:
    targetType: inline
    script: |
      echo $(Pipeline.Workspace)
      echo $(Agent.BuildDirectory)

- task: PowerShell@2
  displayName: Print Tree Path
  inputs:
    targetType: inline
    script: |
      tree $(Pipeline.Workspace) /a

Nach dem Umbau sehen wir das die neuen Pfade genutzt werden.

Links

Predefined variables - Azure Pipelines | Microsoft Docs
Define variables - Azure Pipelines | Microsoft Docs