eng/common/generate-graph-files.ps1

   1 Param(
   2   [Parameter(Mandatory=$true)][string] $barToken,       # Token generated at https://maestro-prod.westus2.cloudapp.azure.com/Account/Tokens
   3   [Parameter(Mandatory=$true)][string] $gitHubPat,      # GitHub personal access token from https://github.com/settings/tokens (no auth scopes needed)
   4   [Parameter(Mandatory=$true)][string] $azdoPat,        # Azure Dev Ops tokens from https://dev.azure.com/dnceng/_details/security/tokens (code read scope needed)
   5   [Parameter(Mandatory=$true)][string] $outputFolder,   # Where the graphviz.txt file will be created
   6   [string] $darcVersion = '1.1.0-beta.19175.6',         # darc's version
   7   [string] $graphvizVersion = '2.38',                   # GraphViz version
   8   [switch] $includeToolset                              # Whether the graph should include toolset dependencies or not. i.e. arcade, optimization. For more about
   9                                                         # toolset dependencies see https://github.com/dotnet/arcade/blob/master/Documentation/Darc.md#toolset-vs-product-dependencies
  10 )
  11
  12 $ErrorActionPreference = "Stop"
  13 . $PSScriptRoot\tools.ps1
  14
  15 Import-Module -Name (Join-Path $PSScriptRoot "native\CommonLibrary.psm1")
  16
  17 function CheckExitCode ([string]$stage)
  18 {
  19   $exitCode = $LASTEXITCODE
  20   if ($exitCode  -ne 0) {
  21     Write-Host "Something failed in stage: '$stage'. Check for errors above. Exiting now..."
  22     ExitWithExitCode $exitCode
  23   }
  24 }
  25
  26 try {
  27   Push-Location $PSScriptRoot
  28
  29   Write-Host "Installing darc..."
  30   . .\darc-init.ps1 -darcVersion $darcVersion
  31   CheckExitCode "Running darc-init"
  32
  33   $engCommonBaseDir = Join-Path $PSScriptRoot "native\"
  34   $graphvizInstallDir = CommonLibrary\Get-NativeInstallDirectory
  35   $nativeToolBaseUri = "https://netcorenativeassets.blob.core.windows.net/resource-packages/external"
  36   $installBin = Join-Path $graphvizInstallDir "bin"
  37
  38   Write-Host "Installing dot..."
  39   .\native\install-tool.ps1 -ToolName graphviz -InstallPath $installBin -BaseUri $nativeToolBaseUri -CommonLibraryDirectory $engCommonBaseDir -Version $graphvizVersion -Verbose
  40
  41   $darcExe = "$env:USERPROFILE\.dotnet\tools"
  42   $darcExe = Resolve-Path "$darcExe\darc.exe"
  43
  44   Create-Directory $outputFolder
  45
  46   # Generate 3 graph descriptions:
  47   # 1. Flat with coherency information
  48   # 2. Graphviz (dot) file
  49   # 3. Standard dependency graph
  50   $graphVizFilePath = "$outputFolder\graphviz.txt"
  51   $graphVizImageFilePath = "$outputFolder\graph.png"
  52   $normalGraphFilePath = "$outputFolder\graph-full.txt"
  53   $flatGraphFilePath = "$outputFolder\graph-flat.txt"
  54   $baseOptions = @( "--github-pat", "$gitHubPat", "--azdev-pat", "$azdoPat", "--password", "$barToken" )
  55
  56   if ($includeToolset) {
  57     Write-Host "Toolsets will be included in the graph..."
  58     $baseOptions += @( "--include-toolset" )
  59   }
  60
  61   Write-Host "Generating standard dependency graph..."
  62   & "$darcExe" get-dependency-graph @baseOptions --output-file $normalGraphFilePath
  63   CheckExitCode "Generating normal dependency graph"
  64
  65   Write-Host "Generating flat dependency graph and graphviz file..."
  66   & "$darcExe" get-dependency-graph @baseOptions --flat --coherency --graphviz $graphVizFilePath --output-file $flatGraphFilePath
  67   CheckExitCode "Generating flat and graphviz dependency graph"
  68
  69   Write-Host "Generating graph image $graphVizFilePath"
  70   $dotFilePath = Join-Path $installBin "graphviz\$graphvizVersion\release\bin\dot.exe"
  71   & "$dotFilePath" -Tpng -o"$graphVizImageFilePath" "$graphVizFilePath"
  72   CheckExitCode "Generating graphviz image"
  73
  74   Write-Host "'$graphVizFilePath', '$flatGraphFilePath', '$normalGraphFilePath' and '$graphVizImageFilePath' created!"
  75 }
  76 catch {
  77   if (!$includeToolset) {
  78     Write-Host "This might be a toolset repo which includes only toolset dependencies. " -NoNewline -ForegroundColor Yellow
  79     Write-Host "Since -includeToolset is not set there is no graph to create. Include -includeToolset and try again..." -ForegroundColor Yellow
  80   }
  81   Write-Host $_
  82   Write-Host $_.Exception
  83   Write-Host $_.ScriptStackTrace
  84   ExitWithExitCode 1
  85 } finally {
  86     Pop-Location
  87 }