Initial commit
This commit is contained in:
Begona Guereca
@@ -0,0 +1,235 @@
|
||||
param (
|
||||
$project = "ValetBootstrap",
|
||||
$repoName = "ValetBootstrap",
|
||||
$codeFolder= "code,azure_devops/pipelines",
|
||||
$rootFolder= ".",
|
||||
$pipelinesRoot="azure_devops/pipelines",
|
||||
[String]$orgToUse = "..",
|
||||
[String]$userName=$(Throw "Azure DevOps Username required."),
|
||||
[String]$daPassword=$(Throw "Password required.")
|
||||
)
|
||||
|
||||
Write-Host "Start Valet Bootstrap"
|
||||
Write-Host "Azure DevOps Organization to use $orgToUse"
|
||||
Write-Host "Azure DevOps Project to use $project"
|
||||
Write-Host "Repo Name $repoName"
|
||||
Write-Host "Code Folders: $codeFolder"
|
||||
Write-Host "Root Folders: $rootFolder"
|
||||
Write-Host "Pipelines Folders: $pipelinesRoot"
|
||||
Write-Host "Azure DevOps username to authenticate with $userName"
|
||||
Write-Host "Azure DevOps PAT to authenticate with $daPassword"
|
||||
|
||||
function Get-BasicAuthCreds {
|
||||
param([string]$Username,[String]$Password)
|
||||
$AuthString = "{0}:{1}" -f $Username,$Password
|
||||
$AuthBytes = [System.Text.Encoding]::Ascii.GetBytes($AuthString)
|
||||
return [Convert]::ToBase64String($AuthBytes)
|
||||
}
|
||||
|
||||
#Get the creds to use in all GitHub API calls.
|
||||
$BasicCreds = Get-BasicAuthCreds -Username "$userName" -Password $daPassword
|
||||
|
||||
##########################################################################
|
||||
#CREATE THE AZURE DEVOPS PROJECT
|
||||
$createtUrlToUse = [string]::Format("https://dev.azure.com/{0}/_apis/projects?api-version=6.0", $orgToUse)
|
||||
|
||||
$projectToCreate = @{
|
||||
"name"= "$project"
|
||||
"description"= "Project to be used for Valet Demos"
|
||||
"capabilities"= @{
|
||||
"versioncontrol"= @{
|
||||
"sourceControlType"= "Git"
|
||||
}
|
||||
"processTemplate"= @{
|
||||
"templateTypeId"= "6b724908-ef14-45cf-84f8-768b5384da45"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
try{
|
||||
$projectResponse = Invoke-RestMethod -Method 'Post' -Uri $createtUrlToUse -Headers @{"Authorization"="Basic $BasicCreds"} -Body ($projectToCreate|ConvertTo-Json) -ContentType "application/json"
|
||||
$projectResponse | ConvertTo-Json
|
||||
|
||||
Start-Sleep -s 5
|
||||
Write-Host "Yes! Project $project was created!"
|
||||
|
||||
} Catch {
|
||||
Write-Host " "
|
||||
Write-Host "##########################################################################"
|
||||
Write-Host "ERROR during project creation: $project"
|
||||
Write-Host "The API call was: $createtUrlToUse"
|
||||
Write-Host " "
|
||||
|
||||
if($_.ErrorDetails.Message) {
|
||||
Write-Host "See error message below:"
|
||||
Write-Host $_.ErrorDetails.Message
|
||||
} else {
|
||||
Write-Host $_
|
||||
Write-Host "It is likely that the AZURE_DEVOPS_ACCESS_TOKEN is not set correctly in the worflow OR does not have sufficent permissions"
|
||||
}
|
||||
Write-Host " "
|
||||
Write-Host "##########################################################################"
|
||||
throw "Exiting. The Project $project was NOT created in Azure DevOps"
|
||||
}
|
||||
|
||||
##########################################################################
|
||||
# IMPORT THE REPO
|
||||
Set-Location $rootFolder
|
||||
|
||||
[array]$folderArray = $codeFolder.Split(",")
|
||||
|
||||
$addTextFile = @{
|
||||
"refUpdates"= @(
|
||||
@{
|
||||
"name"= "refs/heads/main"
|
||||
"oldObjectId"= "0000000000000000000000000000000000000000"
|
||||
}
|
||||
)
|
||||
"commits"= @(
|
||||
@{
|
||||
"comment"= "Initial commit."
|
||||
"changes"= @(
|
||||
foreach ($folder in $folderArray)
|
||||
{
|
||||
$codeRootFolder = Join-Path -Path $rootFolder -ChildPath $folder
|
||||
Write-Host "codeRootFolder: $codeRootFolder"
|
||||
|
||||
$itemPath = $folder.Substring($folder.lastIndexOf('/') + 1)
|
||||
Write-Host "itemPath: $itemPath"
|
||||
|
||||
$codeFiles = (Get-ChildItem "$codeRootFolder" -Recurse -Attributes !Directory)
|
||||
foreach ($codeFile in $codeFiles ) {
|
||||
$daFullName = $codeFile.FullName
|
||||
$codeBody = (Get-Content "$daFullName" -Raw)
|
||||
#Write-Host "codeBody: $codeBody"
|
||||
#Write-Host "folder: $folder"
|
||||
$relath = $daFullName | Resolve-Path -Relative
|
||||
#Write-Host "relath: $relath"
|
||||
$replaceSlash = $folder.Replace("/", "\")
|
||||
$repoPath = $relath.Substring($relath.lastIndexOf($replaceSlash) + $replaceSlash.Length)
|
||||
$wholeRepoPath = Join-Path -Path $itemPath -ChildPath $repoPath
|
||||
$wholeRepoPath = $wholeRepoPath.Replace("\", "/")
|
||||
#Write-Host "wholeRepoPath: $wholeRepoPath"
|
||||
#Write-Host "repoPath: $repoPath"
|
||||
@{
|
||||
"changeType"= "add"
|
||||
"item"= @{
|
||||
"path"= "/$wholeRepoPath"
|
||||
}
|
||||
"newContent"= @{
|
||||
"content"= "$codeBody"
|
||||
"contentType"= "rawtext"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
)
|
||||
}
|
||||
)
|
||||
}
|
||||
|
||||
try{
|
||||
$repoUrlToUse = [string]::Format("https://dev.azure.com/{0}/{2}/_apis/git/repositories/{1}/pushes?api-version=7.1-preview.2", $orgToUse, $repoName, $project)
|
||||
$pushResponse = Invoke-RestMethod -Method 'Post' -Uri $repoUrlToUse -Headers @{"Authorization"="Basic $BasicCreds"} -Body ($addTextFile|ConvertTo-Json -Depth 5) -ContentType "application/json"
|
||||
$repoIds = $pushResponse.repository.id
|
||||
Write-Host "Yes! Repo Was was created! The repoId is $repoIds"
|
||||
} Catch {
|
||||
Write-Host " "
|
||||
Write-Host "##########################################################################"
|
||||
Write-Host "ERROR during Repo creation:"
|
||||
Write-Host "The API call was: $repoUrlToUse"
|
||||
Write-Host " "
|
||||
|
||||
if($_.ErrorDetails.Message) {
|
||||
Write-Host "See error message below:"
|
||||
Write-Host $_.ErrorDetails.Message
|
||||
} else {
|
||||
Write-Host $_
|
||||
}
|
||||
Write-Host " "
|
||||
Write-Host "##########################################################################"
|
||||
throw "Exiting. The Repo was NOT created. It is likely the Project was created in Azure DevOps."
|
||||
}
|
||||
|
||||
##########################################################################
|
||||
##########################################################################
|
||||
# Create YML Pipelines
|
||||
$plUrlToUse = [string]::Format("https://dev.azure.com/{0}/{1}/_apis/pipelines?api-version=6.0-preview.1", $orgToUse, "$project")
|
||||
|
||||
$files = Get-ChildItem ".\$pipelinesRoot\yml\"
|
||||
foreach ($f in $files)
|
||||
{
|
||||
$nameOfPl = $f.BaseName
|
||||
$fileName = $f.Name
|
||||
Write-Host "basename: $nameOfPl filename: $fileName"
|
||||
|
||||
$pipelineCreateBody = @{
|
||||
"folder"= "pipelines"
|
||||
"name"= "$nameOfPl"
|
||||
"configuration"= @{
|
||||
"type"= "yaml"
|
||||
"path"= "/pipelines/yml/$fileName"
|
||||
"repository"= @{
|
||||
"id"= "$repoIds"
|
||||
"name"= "$repoName"
|
||||
"type"= "azureReposGit"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
try{
|
||||
$repoResponse = Invoke-RestMethod -Method 'Post' -Uri $plUrlToUse -Headers @{"Authorization"="Basic $BasicCreds"} -Body ($pipelineCreateBody|ConvertTo-Json) -ContentType "application/json"
|
||||
} Catch {
|
||||
Write-Host " "
|
||||
Write-Host "##########################################################################"
|
||||
Write-Host "ERROR during Pipeline creation:"
|
||||
Write-Host "The API call was: $plUrlToUse"
|
||||
Write-Host " "
|
||||
|
||||
if($_.ErrorDetails.Message) {
|
||||
Write-Host "See error message below:"
|
||||
Write-Host $_.ErrorDetails.Message
|
||||
} else {
|
||||
Write-Host $_
|
||||
}
|
||||
Write-Host " "
|
||||
Write-Host "The Pipeline $nameOfPl was NOT created."
|
||||
Write-Host "##########################################################################"
|
||||
}
|
||||
}
|
||||
|
||||
##########################################################################
|
||||
#CREATE CLASSIC PIPELINEs
|
||||
|
||||
$classicUrlToUse = [string]::Format("https://dev.azure.com/{0}/{1}/_apis/build/definitions?api-version=7.1-preview.7", $orgToUse, "$project")
|
||||
|
||||
$files = Get-ChildItem ".\$pipelinesRoot\classic\"
|
||||
foreach ($f in $files)
|
||||
{
|
||||
$nameOfPl = $f.BaseName
|
||||
$fileName = $f.Name
|
||||
Write-Host "basename: $nameOfPl filename: $fileName"
|
||||
|
||||
$pclassicreateBody = (Get-Content ./$pipelinesRoot/classic/$fileName).Replace("REPOTOREPLACE", "$repoName")
|
||||
|
||||
try{
|
||||
Invoke-RestMethod -Method 'Post' -Uri $classicUrlToUse -Headers @{"Authorization"="Basic $BasicCreds"} -Body ($pclassicreateBody) -ContentType "application/json"
|
||||
} Catch {
|
||||
Write-Host " "
|
||||
Write-Host "##########################################################################"
|
||||
Write-Host "ERROR during Pipeline creation:"
|
||||
Write-Host "The API call was: $classicUrlToUse"
|
||||
Write-Host " "
|
||||
|
||||
if($_.ErrorDetails.Message) {
|
||||
Write-Host "See error message below:"
|
||||
Write-Host $_.ErrorDetails.Message
|
||||
} else {
|
||||
Write-Host $_
|
||||
}
|
||||
Write-Host " "
|
||||
Write-Host "The Pipeline $nameOfPl was NOT created."
|
||||
Write-Host "##########################################################################"
|
||||
}
|
||||
}
|
||||
Write-Host "End Valet Bootstrap"
|
||||
@@ -0,0 +1,243 @@
|
||||
{
|
||||
"options": [
|
||||
{
|
||||
"enabled": true,
|
||||
"definition": {
|
||||
"id": "5d58cc01-7c75-450c-be18-a388ddb129ec"
|
||||
},
|
||||
"inputs": {
|
||||
"branchFilters": "[\"+refs/heads/*\"]",
|
||||
"additionalFields": "{}"
|
||||
}
|
||||
},
|
||||
{
|
||||
"enabled": false,
|
||||
"definition": {
|
||||
"id": "a9db38f9-9fdc-478c-b0f9-464221e58316"
|
||||
},
|
||||
"inputs": {
|
||||
"workItemType": "Task",
|
||||
"assignToRequestor": "true",
|
||||
"additionalFields": "{}"
|
||||
}
|
||||
}
|
||||
],
|
||||
"variables": {
|
||||
"BuildConfiguration": {
|
||||
"value": "release",
|
||||
"allowOverride": true
|
||||
},
|
||||
"BuildPlatform": {
|
||||
"value": "any cpu",
|
||||
"allowOverride": true
|
||||
},
|
||||
"system.debug": {
|
||||
"value": "false",
|
||||
"allowOverride": true
|
||||
}
|
||||
},
|
||||
"properties": {},
|
||||
"tags": [],
|
||||
"_links": [],
|
||||
"buildNumberFormat": "$(date:yyyyMMdd)$(rev:.r)",
|
||||
"jobAuthorizationScope": 1,
|
||||
"jobTimeoutInMinutes": 60,
|
||||
"jobCancelTimeoutInMinutes": 5,
|
||||
"process": {
|
||||
"phases": [
|
||||
{
|
||||
"steps": [
|
||||
{
|
||||
"environment": {},
|
||||
"enabled": true,
|
||||
"continueOnError": false,
|
||||
"alwaysRun": false,
|
||||
"displayName": "Use NuGet 4.4.1",
|
||||
"timeoutInMinutes": 0,
|
||||
"retryCountOnTaskFailure": 0,
|
||||
"condition": "succeeded()",
|
||||
"task": {
|
||||
"id": "2c65196a-54fd-4a02-9be8-d9d1837b7c5d",
|
||||
"versionSpec": "0.*",
|
||||
"definitionType": "task"
|
||||
},
|
||||
"inputs": {
|
||||
"versionSpec": "4.4.1",
|
||||
"checkLatest": "false"
|
||||
}
|
||||
},
|
||||
{
|
||||
"environment": {},
|
||||
"enabled": true,
|
||||
"continueOnError": false,
|
||||
"alwaysRun": false,
|
||||
"displayName": "NuGet restore",
|
||||
"timeoutInMinutes": 0,
|
||||
"retryCountOnTaskFailure": 0,
|
||||
"condition": "succeeded()",
|
||||
"task": {
|
||||
"id": "333b11bd-d341-40d9-afcf-b32d5ce6f23b",
|
||||
"versionSpec": "2.*",
|
||||
"definitionType": "task"
|
||||
},
|
||||
"inputs": {
|
||||
"command": "restore",
|
||||
"solution": "$(Parameters.solution)",
|
||||
"selectOrConfig": "select",
|
||||
"feedRestore": "",
|
||||
"includeNuGetOrg": "true",
|
||||
"nugetConfigPath": "",
|
||||
"externalEndpoints": "",
|
||||
"noCache": "false",
|
||||
"disableParallelProcessing": "false",
|
||||
"packagesDirectory": "",
|
||||
"verbosityRestore": "Detailed",
|
||||
"searchPatternPush": "$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg",
|
||||
"nuGetFeedType": "internal",
|
||||
"feedPublish": "",
|
||||
"publishPackageMetadata": "true",
|
||||
"allowPackageConflicts": "false",
|
||||
"externalEndpoint": "",
|
||||
"verbosityPush": "Detailed",
|
||||
"searchPatternPack": "**/*.csproj",
|
||||
"configurationToPack": "$(BuildConfiguration)",
|
||||
"outputDir": "$(Build.ArtifactStagingDirectory)",
|
||||
"versioningScheme": "off",
|
||||
"includeReferencedProjects": "false",
|
||||
"versionEnvVar": "",
|
||||
"requestedMajorVersion": "1",
|
||||
"requestedMinorVersion": "0",
|
||||
"requestedPatchVersion": "0",
|
||||
"packTimezone": "utc",
|
||||
"includeSymbols": "false",
|
||||
"toolPackage": "false",
|
||||
"buildProperties": "",
|
||||
"basePath": "",
|
||||
"verbosityPack": "Detailed",
|
||||
"arguments": ""
|
||||
}
|
||||
},
|
||||
{
|
||||
"environment": {},
|
||||
"enabled": true,
|
||||
"continueOnError": false,
|
||||
"alwaysRun": false,
|
||||
"displayName": "PowerShell Script",
|
||||
"timeoutInMinutes": 0,
|
||||
"retryCountOnTaskFailure": 0,
|
||||
"condition": "succeeded()",
|
||||
"task": {
|
||||
"id": "e213ff0f-5d5c-4791-802d-52ea3e7be1f1",
|
||||
"versionSpec": "2.*",
|
||||
"definitionType": "task"
|
||||
},
|
||||
"inputs": {
|
||||
"targetType": "inline",
|
||||
"filePath": "",
|
||||
"arguments": "",
|
||||
"script": "# Write your PowerShell commands here.\n\nWrite-Host \"Hello World\"\n",
|
||||
"errorActionPreference": "stop",
|
||||
"warningPreference": "default",
|
||||
"informationPreference": "default",
|
||||
"verbosePreference": "default",
|
||||
"debugPreference": "default",
|
||||
"failOnStderr": "false",
|
||||
"showWarnings": "false",
|
||||
"ignoreLASTEXITCODE": "false",
|
||||
"pwsh": "false",
|
||||
"workingDirectory": "",
|
||||
"runScriptInSeparateScope": "false"
|
||||
}
|
||||
}
|
||||
],
|
||||
"name": "Agent job 1",
|
||||
"refName": "Job_1",
|
||||
"condition": "succeeded()",
|
||||
"target": {
|
||||
"executionOptions": {
|
||||
"type": 0
|
||||
},
|
||||
"allowScriptsAuthAccessOption": false,
|
||||
"type": 1
|
||||
},
|
||||
"jobAuthorizationScope": 1
|
||||
}
|
||||
],
|
||||
"target": {
|
||||
"agentSpecification": {
|
||||
"identifier": "windows-latest"
|
||||
}
|
||||
},
|
||||
"type": 1
|
||||
},
|
||||
"repository": {
|
||||
"properties": {
|
||||
"cleanOptions": "0",
|
||||
"labelSources": "0",
|
||||
"labelSourcesFormat": "$(build.buildNumber)",
|
||||
"reportBuildStatus": "true",
|
||||
"gitLfsSupport": "false",
|
||||
"skipSyncSource": "false",
|
||||
"checkoutNestedSubmodules": "false",
|
||||
"fetchDepth": "0"
|
||||
},
|
||||
"id": "",
|
||||
"type": "TfsGit",
|
||||
"name": "REPOTOREPLACE",
|
||||
"url": "",
|
||||
"defaultBranch": "refs/heads/main",
|
||||
"clean": "false",
|
||||
"checkoutSubmodules": false
|
||||
},
|
||||
"processParameters": {
|
||||
"inputs": [
|
||||
{
|
||||
"aliases": [],
|
||||
"options": {},
|
||||
"properties": {},
|
||||
"name": "solution",
|
||||
"label": "Solution",
|
||||
"defaultValue": "**\\*.sln",
|
||||
"required": true,
|
||||
"type": "filePath",
|
||||
"helpMarkDown": "The path to the Visual Studio solution file or NuGet packages.config. Wildcards can be used. For example, `**\\\\*.sln` for all sln files in all sub folders."
|
||||
}
|
||||
]
|
||||
},
|
||||
"quality": 1,
|
||||
"authoredBy": {
|
||||
"displayName": "David Kalmin",
|
||||
"url": "https://spsprodcus5.vssps.visualstudio.com/A8ceff4ff-6429-4de3-9c39-fd7f0b1fb05a/_apis/Identities/a886d3a4-5700-6920-a3e4-6dadf46e7614",
|
||||
"_links": {
|
||||
"avatar": {
|
||||
"href": "https://dev.azure.com/microsoft-bootcamp/_apis/GraphProfile/MemberAvatars/aad.YTg4NmQzYTQtNTcwMC03OTIwLWEzZTQtNmRhZGY0NmU3NjE0"
|
||||
}
|
||||
},
|
||||
"id": "a886d3a4-5700-6920-a3e4-6dadf46e7614",
|
||||
"uniqueName": "[email protected]",
|
||||
"imageUrl": "https://dev.azure.com/microsoft-bootcamp/_apis/GraphProfile/MemberAvatars/aad.YTg4NmQzYTQtNTcwMC03OTIwLWEzZTQtNmRhZGY0NmU3NjE0",
|
||||
"descriptor": "aad.YTg4NmQzYTQtNTcwMC03OTIwLWEzZTQtNmRhZGY0NmU3NjE0"
|
||||
},
|
||||
"drafts": [],
|
||||
"queue": {
|
||||
"_links": {
|
||||
"self": {
|
||||
"href": "https://dev.azure.com/microsoft-bootcamp/_apis/build/Queues/126"
|
||||
}
|
||||
},
|
||||
"name": "Azure Pipelines",
|
||||
"url": "https://dev.azure.com/microsoft-bootcamp/_apis/build/Queues/126",
|
||||
"pool": {
|
||||
"name": "Azure Pipelines",
|
||||
"isHosted": true
|
||||
}
|
||||
},
|
||||
"id": 10,
|
||||
"name": "valet-classic-test-import1",
|
||||
"uri": "vstfs:///Build/Definition/10",
|
||||
"path": "\\",
|
||||
"type": 2,
|
||||
"queueStatus": 0,
|
||||
"revision": 1,
|
||||
"createdDate": "2022-02-17T19:05:52.500Z",
|
||||
}
|
||||
@@ -0,0 +1,243 @@
|
||||
{
|
||||
"options": [
|
||||
{
|
||||
"enabled": true,
|
||||
"definition": {
|
||||
"id": "5d58cc01-7c75-450c-be18-a388ddb129ec"
|
||||
},
|
||||
"inputs": {
|
||||
"branchFilters": "[\"+refs/heads/*\"]",
|
||||
"additionalFields": "{}"
|
||||
}
|
||||
},
|
||||
{
|
||||
"enabled": false,
|
||||
"definition": {
|
||||
"id": "a9db38f9-9fdc-478c-b0f9-464221e58316"
|
||||
},
|
||||
"inputs": {
|
||||
"workItemType": "Task",
|
||||
"assignToRequestor": "true",
|
||||
"additionalFields": "{}"
|
||||
}
|
||||
}
|
||||
],
|
||||
"variables": {
|
||||
"BuildConfiguration": {
|
||||
"value": "release",
|
||||
"allowOverride": true
|
||||
},
|
||||
"BuildPlatform": {
|
||||
"value": "any cpu",
|
||||
"allowOverride": true
|
||||
},
|
||||
"system.debug": {
|
||||
"value": "false",
|
||||
"allowOverride": true
|
||||
}
|
||||
},
|
||||
"properties": {},
|
||||
"tags": [],
|
||||
"_links": [],
|
||||
"buildNumberFormat": "$(date:yyyyMMdd)$(rev:.r)",
|
||||
"jobAuthorizationScope": 1,
|
||||
"jobTimeoutInMinutes": 60,
|
||||
"jobCancelTimeoutInMinutes": 5,
|
||||
"process": {
|
||||
"phases": [
|
||||
{
|
||||
"steps": [
|
||||
{
|
||||
"environment": {},
|
||||
"enabled": true,
|
||||
"continueOnError": false,
|
||||
"alwaysRun": false,
|
||||
"displayName": "Use NuGet 4.4.1",
|
||||
"timeoutInMinutes": 0,
|
||||
"retryCountOnTaskFailure": 0,
|
||||
"condition": "succeeded()",
|
||||
"task": {
|
||||
"id": "2c65196a-54fd-4a02-9be8-d9d1837b7c5d",
|
||||
"versionSpec": "0.*",
|
||||
"definitionType": "task"
|
||||
},
|
||||
"inputs": {
|
||||
"versionSpec": "4.4.1",
|
||||
"checkLatest": "false"
|
||||
}
|
||||
},
|
||||
{
|
||||
"environment": {},
|
||||
"enabled": true,
|
||||
"continueOnError": false,
|
||||
"alwaysRun": false,
|
||||
"displayName": "NuGet restore",
|
||||
"timeoutInMinutes": 0,
|
||||
"retryCountOnTaskFailure": 0,
|
||||
"condition": "succeeded()",
|
||||
"task": {
|
||||
"id": "333b11bd-d341-40d9-afcf-b32d5ce6f23b",
|
||||
"versionSpec": "2.*",
|
||||
"definitionType": "task"
|
||||
},
|
||||
"inputs": {
|
||||
"command": "restore",
|
||||
"solution": "$(Parameters.solution)",
|
||||
"selectOrConfig": "select",
|
||||
"feedRestore": "",
|
||||
"includeNuGetOrg": "true",
|
||||
"nugetConfigPath": "",
|
||||
"externalEndpoints": "",
|
||||
"noCache": "false",
|
||||
"disableParallelProcessing": "false",
|
||||
"packagesDirectory": "",
|
||||
"verbosityRestore": "Detailed",
|
||||
"searchPatternPush": "$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg",
|
||||
"nuGetFeedType": "internal",
|
||||
"feedPublish": "",
|
||||
"publishPackageMetadata": "true",
|
||||
"allowPackageConflicts": "false",
|
||||
"externalEndpoint": "",
|
||||
"verbosityPush": "Detailed",
|
||||
"searchPatternPack": "**/*.csproj",
|
||||
"configurationToPack": "$(BuildConfiguration)",
|
||||
"outputDir": "$(Build.ArtifactStagingDirectory)",
|
||||
"versioningScheme": "off",
|
||||
"includeReferencedProjects": "false",
|
||||
"versionEnvVar": "",
|
||||
"requestedMajorVersion": "1",
|
||||
"requestedMinorVersion": "0",
|
||||
"requestedPatchVersion": "0",
|
||||
"packTimezone": "utc",
|
||||
"includeSymbols": "false",
|
||||
"toolPackage": "false",
|
||||
"buildProperties": "",
|
||||
"basePath": "",
|
||||
"verbosityPack": "Detailed",
|
||||
"arguments": ""
|
||||
}
|
||||
},
|
||||
{
|
||||
"environment": {},
|
||||
"enabled": true,
|
||||
"continueOnError": false,
|
||||
"alwaysRun": false,
|
||||
"displayName": "PowerShell Script",
|
||||
"timeoutInMinutes": 0,
|
||||
"retryCountOnTaskFailure": 0,
|
||||
"condition": "succeeded()",
|
||||
"task": {
|
||||
"id": "e213ff0f-5d5c-4791-802d-52ea3e7be1f1",
|
||||
"versionSpec": "2.*",
|
||||
"definitionType": "task"
|
||||
},
|
||||
"inputs": {
|
||||
"targetType": "inline",
|
||||
"filePath": "",
|
||||
"arguments": "",
|
||||
"script": "# Write your PowerShell commands here.\n\nWrite-Host \"Hello World\"\n",
|
||||
"errorActionPreference": "stop",
|
||||
"warningPreference": "default",
|
||||
"informationPreference": "default",
|
||||
"verbosePreference": "default",
|
||||
"debugPreference": "default",
|
||||
"failOnStderr": "false",
|
||||
"showWarnings": "false",
|
||||
"ignoreLASTEXITCODE": "false",
|
||||
"pwsh": "false",
|
||||
"workingDirectory": "",
|
||||
"runScriptInSeparateScope": "false"
|
||||
}
|
||||
}
|
||||
],
|
||||
"name": "Agent job 1",
|
||||
"refName": "Job_1",
|
||||
"condition": "succeeded()",
|
||||
"target": {
|
||||
"executionOptions": {
|
||||
"type": 0
|
||||
},
|
||||
"allowScriptsAuthAccessOption": false,
|
||||
"type": 1
|
||||
},
|
||||
"jobAuthorizationScope": 1
|
||||
}
|
||||
],
|
||||
"target": {
|
||||
"agentSpecification": {
|
||||
"identifier": "windows-latest"
|
||||
}
|
||||
},
|
||||
"type": 1
|
||||
},
|
||||
"repository": {
|
||||
"properties": {
|
||||
"cleanOptions": "0",
|
||||
"labelSources": "0",
|
||||
"labelSourcesFormat": "$(build.buildNumber)",
|
||||
"reportBuildStatus": "true",
|
||||
"gitLfsSupport": "false",
|
||||
"skipSyncSource": "false",
|
||||
"checkoutNestedSubmodules": "false",
|
||||
"fetchDepth": "0"
|
||||
},
|
||||
"id": "",
|
||||
"type": "TfsGit",
|
||||
"name": "REPOTOREPLACE",
|
||||
"url": "",
|
||||
"defaultBranch": "refs/heads/main",
|
||||
"clean": "false",
|
||||
"checkoutSubmodules": false
|
||||
},
|
||||
"processParameters": {
|
||||
"inputs": [
|
||||
{
|
||||
"aliases": [],
|
||||
"options": {},
|
||||
"properties": {},
|
||||
"name": "solution",
|
||||
"label": "Solution",
|
||||
"defaultValue": "**\\*.sln",
|
||||
"required": true,
|
||||
"type": "filePath",
|
||||
"helpMarkDown": "The path to the Visual Studio solution file or NuGet packages.config. Wildcards can be used. For example, `**\\\\*.sln` for all sln files in all sub folders."
|
||||
}
|
||||
]
|
||||
},
|
||||
"quality": 1,
|
||||
"authoredBy": {
|
||||
"displayName": "David Kalmin",
|
||||
"url": "https://spsprodcus5.vssps.visualstudio.com/A8ceff4ff-6429-4de3-9c39-fd7f0b1fb05a/_apis/Identities/a886d3a4-5700-6920-a3e4-6dadf46e7614",
|
||||
"_links": {
|
||||
"avatar": {
|
||||
"href": "https://dev.azure.com/microsoft-bootcamp/_apis/GraphProfile/MemberAvatars/aad.YTg4NmQzYTQtNTcwMC03OTIwLWEzZTQtNmRhZGY0NmU3NjE0"
|
||||
}
|
||||
},
|
||||
"id": "a886d3a4-5700-6920-a3e4-6dadf46e7614",
|
||||
"uniqueName": "[email protected]",
|
||||
"imageUrl": "https://dev.azure.com/microsoft-bootcamp/_apis/GraphProfile/MemberAvatars/aad.YTg4NmQzYTQtNTcwMC03OTIwLWEzZTQtNmRhZGY0NmU3NjE0",
|
||||
"descriptor": "aad.YTg4NmQzYTQtNTcwMC03OTIwLWEzZTQtNmRhZGY0NmU3NjE0"
|
||||
},
|
||||
"drafts": [],
|
||||
"queue": {
|
||||
"_links": {
|
||||
"self": {
|
||||
"href": "https://dev.azure.com/microsoft-bootcamp/_apis/build/Queues/126"
|
||||
}
|
||||
},
|
||||
"name": "Azure Pipelines",
|
||||
"url": "https://dev.azure.com/microsoft-bootcamp/_apis/build/Queues/126",
|
||||
"pool": {
|
||||
"name": "Azure Pipelines",
|
||||
"isHosted": true
|
||||
}
|
||||
},
|
||||
"id": 10,
|
||||
"name": "valet-classic-test-import2",
|
||||
"uri": "vstfs:///Build/Definition/10",
|
||||
"path": "\\",
|
||||
"type": 2,
|
||||
"queueStatus": 0,
|
||||
"revision": 1,
|
||||
"createdDate": "2022-02-17T19:05:52.500Z",
|
||||
}
|
||||
@@ -0,0 +1,10 @@
|
||||
# pipelines folder
|
||||
This folder contains Azure DevOps pipelines that gets migrated to the Azure DevOps instance.
|
||||
|
||||
### Note any file added to this folder or sub folders will get migrated to the Azure DevOps instance when the GitHub Action runs to create and bootstrap the Azure DevOps project
|
||||
|
||||
## classic folder
|
||||
The classic folder contains classic style Azure DevOps pipelines that are pure JSON files.
|
||||
|
||||
## yml folder
|
||||
The yml folder contains yml Azure DevOps pipelines.
|
||||
@@ -0,0 +1,29 @@
|
||||
---
|
||||
variables:
|
||||
- name: BuildParameters.RESTOREBUILDPROJECTS
|
||||
value: "**/*.csproj"
|
||||
- name: BUILDCONFIGURATION
|
||||
value: Release
|
||||
name: "$(date:yyyyMMdd)$(rev:.r)"
|
||||
jobs:
|
||||
- job: Job_1
|
||||
displayName: Agent job 1
|
||||
pool:
|
||||
vmImage: windows-latest
|
||||
steps:
|
||||
- checkout: self
|
||||
- task: NodeTool@0
|
||||
displayName: Use Node 10.16.3
|
||||
inputs:
|
||||
versionSpec: 10.16.3
|
||||
- task: DotNetCoreCLI@2
|
||||
displayName: Restore
|
||||
inputs:
|
||||
command: restore
|
||||
projects: "$(BuildParameters.RESTOREBUILDPROJECTS)"
|
||||
- task: DotNetCoreCLI@2
|
||||
displayName: Build
|
||||
inputs:
|
||||
projects: "$(BuildParameters.RESTOREBUILDPROJECTS)"
|
||||
arguments: "--configuration $(BUILDCONFIGURATION)"
|
||||
|
||||
@@ -0,0 +1,19 @@
|
||||
# Bootcap Starter pipeline
|
||||
# Start with a minimal pipeline that you can customize to build and deploy your code.
|
||||
# Add steps that build, run tests, deploy, and more:
|
||||
# https://aka.ms/yaml
|
||||
|
||||
trigger:
|
||||
- main
|
||||
|
||||
pool:
|
||||
vmImage: windows-latest
|
||||
|
||||
steps:
|
||||
- script: echo Hello, I am pipeline 1!
|
||||
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'
|
||||
@@ -0,0 +1,19 @@
|
||||
# Bootcap Starter pipeline
|
||||
# Start with a minimal pipeline that you can customize to build and deploy your code.
|
||||
# Add steps that build, run tests, deploy, and more:
|
||||
# https://aka.ms/yaml
|
||||
|
||||
trigger:
|
||||
- main
|
||||
|
||||
pool:
|
||||
vmImage: windows-latest
|
||||
|
||||
steps:
|
||||
- script: echo Hello, I am pipeline 2!
|
||||
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'
|
||||
@@ -0,0 +1,133 @@
|
||||
# Valet labs for Azure DevOps
|
||||
|
||||
This lab bootstraps a Valet environment using GitHub Codespaces and enables you to create an Azure DevOps project against which to run the Valet CI/CD migration tool.
|
||||
|
||||
- [Use this Repo as a template](#repo-template)
|
||||
- [Prerequisites](#prerequisites)
|
||||
- [Codespace secrets](#codespace-secrets)
|
||||
- [Action secrets](#action-secrets)
|
||||
- [Azure DevOps project creation](#azure-devops-project-creation)
|
||||
- [Use Valet with a codespace](#use-valet-with-a-codespace)
|
||||
- [Labs for Azure DevOps](#labs-for-azure-devops)
|
||||
|
||||
## Repo template
|
||||
|
||||
1. Verify you are in your own Repository created from the landing page [Valet Labs](https://github.com/valet-customers/labs).
|
||||
|
||||
## Prerequisites
|
||||
1. Azure DevOps organization. Please identify or create an Azure DevOps organization to use: [Click to create an Azure DevOps Org](https://docs.microsoft.com/en-us/azure/devops/organizations/accounts/create-organization?toc=%2Fazure%2Fdevops%2Fget-started%2Ftoc.json&bc=%2Fazure%2Fdevops%2Fget-started%2Fbreadcrumb%2Ftoc.json&view=azure-devops)
|
||||
- Note and store the Azure DevOp sorganization name for later.
|
||||
- Note and store the user name you use for your Azure DevOps Organization. It will be an email address.
|
||||
2. Azure DevOps Project. The default project name for this lab is `ValetBootstrap` There is an Action workflow that will create and populate the Azure DevOps project. No need to create it yourself. Note: The project has to be unique in the Azure DevOps organization. If you already have a project name `ValetBootstrap` please pick a different unique project name.
|
||||
- Note and store the Azure DevOps project name for later.
|
||||
3. Create an Azure DevOps personal access token with the following scopes:
|
||||
- To do so, navigate to Sign in to your organization `https://dev.azure.com/{yourorganization}`.
|
||||
- Click your `Account management` icon
|
||||
- Click `user settings`
|
||||
- Click `Personal access tokens`.
|
||||
- Select `+ New Token`
|
||||
- Name your token, select the organization where you want to use the token, and then set your token to automatically expire after a set number of days.
|
||||
- Select the following scopes (Click `Show more scopes` if you don't see all of the below):
|
||||
- Agents Pool: `Read`
|
||||
- Build: `Read & Execute`
|
||||
- Code: `Read & Write`
|
||||
- Project and Team: `Read, Write, & Manage`
|
||||
- Release: `Read`
|
||||
- Service Connections: `Read`
|
||||
- Task Groups: `Read`
|
||||
- Variable Groups: `Read`
|
||||
- Click `Create`
|
||||
- Copy the PAT somewhere safe and temporary.
|
||||
4. Create a GitHub personal access token.
|
||||
- To do so, navigate to your GitHub `Settings` - click your profile photo and then click `Settings`.
|
||||
- Go to `Developer Settings`
|
||||
- Go to `Personal Access Tokens` -> `Legacy tokens (if present)`
|
||||
- Click `Generate new token` -> `Legacy tokens (if present)`. If required, provide your password.
|
||||
- Select at least these scopes: `read packages` and `workflow`. Optionally, provide a text in the **Note** field and change the expiration.
|
||||
- Click `Generate token`
|
||||
- Copy the PAT somewhere safe and temporary.
|
||||
|
||||
## Codespace secrets
|
||||
Please add the following Codespace secrets.
|
||||
|
||||
- `VALET_GHCR_PASSWORD`: Add `VALET_GHCR_PASSWORD` as the `Name` and the GitHub personal access token created above as the value.
|
||||
- `AZURE_DEVOPS_ACCESS_TOKEN`: Add `AZURE_DEVOPS_ACCESS_TOKEN` as the `Name` and the Azure DevOps personal access token created above as the value.
|
||||
- `AZURE_DEVOPS_ORGANIZATION`: Add `AZURE_DEVOPS_ORGANIZATION` as the `Name` and the Azure DevOps organization noted above as the value.
|
||||
- `AZURE_DEVOPS_PROJECT`: Add `AZURE_DEVOPS_PROJECT` as the `Name` and the Azure DevOps project noted above as the value.
|
||||
|
||||
Steps to create the Codespace secrets. Complete for secret noted above:
|
||||
|
||||
- Navigate to the `Settings` tab in this repo
|
||||
- Find `Secrets` and click the down arrow
|
||||
- Click `Codespaces`
|
||||
- Click `New Repository Secret` to create a new secret
|
||||
- Name the secret as noted above
|
||||
- Paste in the value noted above
|
||||
- Click `Add Secret`
|
||||
|
||||
## Action secrets
|
||||
Please add the following Action secrets.
|
||||
|
||||
- `AZURE_DEVOPS_ACCESS_TOKEN`: Add `AZURE_DEVOPS_ACCESS_TOKEN` as the `Name` and the Azure DevOps personal access token created above as the value.
|
||||
|
||||
Steps to create the Actions secret. Complete for secret noted above:
|
||||
|
||||
- Navigate to the `Settings` tab in this repo
|
||||
- Find `Secrets` and click the down arrow
|
||||
- Click `Actions`
|
||||
- Click `New Repository Secret` to create a new secret
|
||||
- Name the secret as noted above
|
||||
- Paste in the value noted above
|
||||
- Click `Add Secret`
|
||||
|
||||
## Azure DevOps project creation
|
||||
|
||||
Run the Actions workflow:
|
||||
- CLick the `Actions` tab
|
||||
- Select the `Valet Bootstrap for Azure DevOps` action
|
||||
- Click `Run Workflow`
|
||||
- Input the Azure DevOps Organization name identified above
|
||||
- Input the Azure DevOps user name of the user that created the Azure DevOps PAT above. This will be an email address
|
||||
- Accept the default Azure DevOps project name or change it to one of your preference
|
||||
- NOTE: The default project name is `ValetBootstrap`. This must be unique in your Azure DevOps Organization. If not, please choose a unique name.
|
||||
- Click `Run Workflow`
|
||||
- Verify the workflow completed successfully. If the workflow did not run successfully you will see a detailed error message.
|
||||
|
||||
### Example ###
|
||||
|
||||
|
||||
|
||||
## Use Valet with a codespace
|
||||
|
||||
1. Start the codespace
|
||||
- Click the `Code` with button down arrow above repository on the repository's landing page.
|
||||
- Click the `Codespaces` tab
|
||||
- Click `Create codespaces on main` to create the codespace. If you are in another branch then the `main` branch, the codespace will button will have the current branch specified.
|
||||
- Wait a couple minutes, then verify that the codespace starts up. Once it is fully booted up, the termininal should be present.
|
||||
2. Verify Valet CLI is installed and working. More information on the [GitHub Valet CLI extension](https://github.com/github/gh-valet)
|
||||
- Verify Valet CLI is installed and working
|
||||
- Run `gh valet version` in the Visual Studio Code terminal and verify the output looks like the below image. Note the valet version will be different than below as the latest version gets pulled down.
|
||||
- If `gh valet version` did not produce a similar image with a version please follow these instructions [Troubleshoot GH Valet extension](#troubleshoot-gh-valet-extension)
|
||||
- Start using Valet by following along with the [Labs for Azure DevOps](#labs-for-azure-devops)
|
||||
|
||||
### Example ###
|
||||
|
||||
|
||||
## Labs for Azure DevOps
|
||||
Perform the following labs to test-drive Valet
|
||||
- [Audit Azure DevOps pipelines using the Valet audit command](valet-audit-lab.md)
|
||||
- [Dry run the migration of an Azure DevOps pipeline to GitHub Actions](valet-dry-run-lab.md)
|
||||
- [Migrate an Azure DevOps pipeline to GitHub Actions](valet-migrate-lab.md)
|
||||
- [Migrate an Azure DevOps pipeline to GitHub Actions with a custom transformer](valet-migrate-custom-lab.md)
|
||||
- [Forecast: Valet forecast lab](valet-forecast-lab.md)
|
||||
|
||||
## Troubleshoot GH Valet extension
|
||||
Manually Install the GitHub CLI Valet extension. More information on the [GitHub Valet CLI extension](https://github.com/github/gh-valet)
|
||||
- Verify you are in the Visual Studio Code terminal
|
||||
- Run this command to install the GitHub Valet extension
|
||||
- `gh extension install github/gh-valet`
|
||||
- Verify the result of the install is: `✓ Installed extension github/gh-valet`
|
||||
- If you get a similiar error to the following, click the link to authorize the token
|
||||
|
||||
- Restart Codespace after clicking the link
|
||||
- Verify Valet CLI is installed and working
|
||||
@@ -0,0 +1,52 @@
|
||||
# Audit Azure DevOps pipelines using the Valet audit command
|
||||
In this lab, you will use Valet to `audit` an Azure DevOps organization. The `audit` command can be used to scan a CI server and output a summary of the current pipelines. This summary can then be used to plan the timeline and effort required to migrate to GitHub Actions.
|
||||
|
||||
- [Prerequisites](#prerequisites)
|
||||
- [Perform an audit](#perform-an-audit)
|
||||
- [View audit output](#view-audit-output)
|
||||
- [Review the pipelines](#review-the-pipelines)
|
||||
- [Next Lab](#next-lab)
|
||||
|
||||
## Prerequisites
|
||||
|
||||
1. Follow all steps [here](../azure_devops#readme) to set up your environment
|
||||
2. Create or start a codespace in this repository (if not started)
|
||||
|
||||
## Perform an audit
|
||||
You will use the codespace preconfigured in this repository to perform the audit.
|
||||
|
||||
1. Navigate to the codespace Visual Studio Code terminal
|
||||
2. Verify you are in the `valet` directory
|
||||
3. Now, from the `valet` folder in your repository, run Valet to verify your Azure DevOps configuration:
|
||||
|
||||
```
|
||||
gh valet audit azure-devops --output-dir audit
|
||||
```
|
||||
### Example
|
||||
|
||||
|
||||
4. Valet displays green log files to indicate a successful audit
|
||||
|
||||
### Example
|
||||
|
||||
|
||||
## View audit output
|
||||
The audit summary, logs, Azure DevOps yml, and GitHub yml should all be located in the `valet` folder.
|
||||
|
||||
1. Under the `valet` folder find the `audit_summary.md`
|
||||
2. Right-click the `audit_summary.md` file and select `Open Preview`
|
||||
3. The file contains details about your current pipelines and what can be migrated 100% automatically vs. what will need some manual intervention or aren't supported by GitHub Actions.
|
||||
4. Review the file.
|
||||
|
||||
### Example
|
||||
|
||||
|
||||
## Review the pipelines
|
||||
The `audit` command grabs the yml, classic, and release pipelines from Azure DevOps and converts them to GitHub Actions.
|
||||
|
||||
### Example
|
||||
View the source yml and the proposed GitHub yml
|
||||
|
||||
|
||||
### Next Lab
|
||||
[Dry run the migration of an Azure DevOps pipeline to GitHub Actions](valet-dry-run-lab.md)
|
||||
@@ -0,0 +1,52 @@
|
||||
# Dry run the migration of an Azure DevOps pipeline to GitHub Actions
|
||||
In this lab, you will use the `valet dry-run` command to convert an Azure DevOps pipeline to it's equivalent GitHub Actions workflow and write the workflow to your local filesystem.
|
||||
|
||||
- [Prerequisites](#prerequisites)
|
||||
- [Identify the Azure DevOps pipeline ID to use](#identify-the-azure-devops-pipeline-id-to-use)
|
||||
- [Perform a dry run](#perform-a-dry-run)
|
||||
- [View dry-run output](#view-dry-run-output)
|
||||
- [Next Lab](#next-lab)
|
||||
|
||||
## Prerequisites
|
||||
|
||||
1. Follow all steps [here](../azure_devops#readme) to set up your environment
|
||||
2. Create or start a codespace in this repository (if not started)
|
||||
3. You have completed the [Valet audit lab](valet-audit-lab.md).
|
||||
|
||||
## Identify the Azure DevOps pipeline ID to use
|
||||
You will need a pipeline ID to perform the dry run
|
||||
1. Go to the `valet/ValetBootstrap/pipelines` folder
|
||||
2. Open the `valet/ValetBootstrap/pipelines/valet-pipeline1.config.json` file
|
||||
3. Look for the `$.web.href` link
|
||||
4. At the end of the link is the pipeline ID. Copy or note the ID.
|
||||
|
||||
### Example
|
||||
|
||||
|
||||
## Perform a dry run
|
||||
You will use the codespace preconfigured in this repository to perform the dry run.
|
||||
|
||||
1. Navigate to the codespace Visual Studio Code terminal
|
||||
2. Verify you are in the `valet` directory
|
||||
|
||||
```
|
||||
gh valet dry-run azure-devops pipeline --pipeline-id PIPELINE-ID --output-dir dry-run
|
||||
```
|
||||
3. Now, from the `valet` folder in your repository, run `gh valet dry-run` to see the output:
|
||||
|
||||
### Example
|
||||
|
||||
|
||||
4. Valet will create a folder called `dry-runs` under the `valet` folder that shows what will be migrated.
|
||||
|
||||
### Example
|
||||
|
||||
|
||||
## View dry-run output
|
||||
The dry-run output will show you the GitHub Actions yml that will be migrated to GitHub.
|
||||
|
||||
### Example
|
||||
|
||||
|
||||
### Next Lab
|
||||
[Migrate an Azure DevOps pipeline to GitHub Actions](valet-migrate-lab.md)
|
||||
@@ -0,0 +1,3 @@
|
||||
# Forecast Azure DevOps to GitHub using Valet forecast command
|
||||
|
||||
### Coming soon
|
||||
@@ -0,0 +1,87 @@
|
||||
# Migrate an Azure DevOps pipeline to GitHub Actions with a custom transformer
|
||||
In this lab, you will create a custom plugin that transforms some of the existing migration mapping and replaces it with your own mapping. Then use the `migrate` subcommand to migrate the pipeline. The `migrate` subcommand can be used to convert a pipeline to its GitHub Actions equivalent and then create a pull request with the contents.
|
||||
|
||||
- [Prerequisites](#prerequisites)
|
||||
- [Identify the Azure DevOps pipeline ID to use](#identify-the-azure-devops-pipeline-id-to-use)
|
||||
- [Create a custom transformer](#create-a-custom-transformer)
|
||||
- [Migrate with a custom transformer](#migrate-with-a-custom-transformer)
|
||||
- [View the pull request](#view-the-pull-request)
|
||||
|
||||
## Prerequisites
|
||||
|
||||
1. Follow all steps [here](../azure_devops#readme) to set up your environment
|
||||
2. Create or start a codespace in this repository (if not started)
|
||||
3. Complete the [Valet audit lab](valet-audit-lab.md).
|
||||
4. Complete the [Valet migrate lab](valet-migrate-lab.md).
|
||||
|
||||
## Identify the Azure DevOps pipeline ID to use
|
||||
You will need the `valet-mapper-example` Azure DevOps pipeline ID to perform the migration
|
||||
1. Go to the `valet/ValetBootstrap/pipelines` folder
|
||||
2. Open the `valet/ValetBootstrap/pipelines/valet-mapper-example.config.json` file
|
||||
3. Look for the `web - href` link
|
||||
4. At the end of the link is the pipeline ID. Copy or note the ID.
|
||||
|
||||
### Example
|
||||
|
||||
|
||||
## Create a custom transformer
|
||||
|
||||
To create a transformer, you need to create a Ruby file that looks as follows:
|
||||
``` ruby
|
||||
transform "azuredevopstaskname" do |item|
|
||||
# your ruby code here that produces output
|
||||
end
|
||||
```
|
||||
|
||||
We start by creating a new folder called `plugin` under the `valet` folder in your repository. In there create a file called `DotNetCoreCLI.rb`.
|
||||
|
||||
Next change the function name to match the Azure DevOps task name `DotNetCoreCLI@2`.
|
||||
The way you find this name is by clicking the **view yaml** button at a task in the pipeline:
|
||||
|
||||
This results in the following code:
|
||||
``` ruby
|
||||
transform "DotNetCoreCLI@2" do |item|
|
||||
# your ruby code here that produces output
|
||||
end
|
||||
```
|
||||
The parameter item is a collection of items than contain the properties of the original task that was retrieved from Azure DevOps.
|
||||
In this case we can see in the yaml that the properties that are set are `command` and `projects`.
|
||||
|
||||
Add the following code to the ruby file:
|
||||
``` Ruby
|
||||
transform "DotNetCoreCLI@2" do |item|
|
||||
projects = item["projects"]
|
||||
command = item["command"]
|
||||
run_command = []
|
||||
|
||||
if projects.include?("$")
|
||||
command = "build" if command.nil?
|
||||
run_command << "shopt -s globstar; for f in ./**/*.csproj; do dotnet #{command} $f #{item['arguments']} ; done"
|
||||
else
|
||||
run_command << "dotnet #{command} #{item['projects']} #{item['arguments']}"
|
||||
end
|
||||
|
||||
{
|
||||
shell: "bash",
|
||||
run: run_command.join("\n")
|
||||
}
|
||||
end
|
||||
```
|
||||
|
||||
## Migrate with a custom transformer
|
||||
|
||||
Run the `gh valet migrate` command from the `valet` directory with the transformer again and pass it the custom plugin. Look at the result and see if it results in a successful build.
|
||||
|
||||
```
|
||||
gh valet migrate azure-devops pipeline --target-url https://github.com/GITHUB-ORG/GITHUB-REPO --pipeline-id PIPELINE-ID --custom-transformers plugin/DotNetCoreCLI.rb --output-dir migrate
|
||||
```
|
||||
|
||||
### Example
|
||||
|
||||
|
||||
## View the pull request
|
||||
The migrate output will show you the pull request on GitHub. Note here that the checks on the pull request all passed!
|
||||
|
||||
### Example
|
||||
|
||||
|
||||
@@ -0,0 +1,59 @@
|
||||
# Migrate an Azure DevOps pipeline to GitHub Actions
|
||||
In this lab, you will use the Valet `migrate` command to migrate an Azure DevOps pipeline to GitHub Actions. The `migrate` subcommand can be used to convert a pipeline to its GitHub Actions equivalent and then create a pull request with the contents.
|
||||
|
||||
- [Prerequisites](#prerequisites)
|
||||
- [Identify the Azure DevOps pipeline ID to use](#identify-the-azure-devops-pipeline-id-to-use)
|
||||
- [Perform a migration](#perform-a-migration)
|
||||
- [View the pull request](#view-the-pull-request)
|
||||
- [Next Lab](#next-lab)
|
||||
|
||||
## Prerequisites
|
||||
|
||||
1. Follow all steps [here](../azure_devops#readme) to set up your environment
|
||||
2. Create or start a codespace in this repository (if not started)
|
||||
3. Completed the [Valet audit lab](valet-audit-lab.md).
|
||||
|
||||
## Identify the Azure DevOps pipeline ID to use
|
||||
You will need a pipeline ID to perform the migration
|
||||
1. Go to the `valet/ValetBootstrap/pipelines` folder
|
||||
2. Open the `valet/ValetBootstrap/pipelines/valet-pipeline1.config.json` file
|
||||
3. Look for the `web - href` link
|
||||
4. At the end of the link is the pipeline ID. Copy or note the ID.
|
||||
|
||||
### Example
|
||||
|
||||
|
||||
|
||||
## Perform a migration
|
||||
You will use the codespace preconfigured in this repository to perform the migration.
|
||||
|
||||
1. Navigate to the codespace Visual Studio Code terminal
|
||||
2. Verify you are in the valet directory
|
||||
3. Copy the following command and replace:
|
||||
- `GITHUB-ORG` with the name of your organization.
|
||||
- `GITHUB-REPO` with the name of your repository.
|
||||
- `PIPELINE-ID` with your pipeline ID.
|
||||
4. Run `gh valet migrate` from the `valet` directory to migrate the pipeline to GitHub Actions..
|
||||
```
|
||||
gh valet migrate azure-devops pipeline --target-url https://github.com/GITHUB-ORG/GITHUB-REPO --pipeline-id PIPELINE-ID --output-dir migrate
|
||||
```
|
||||
|
||||
### Example
|
||||
|
||||
|
||||
|
||||
5. Valet will create a pull request directly to your GitHub repository.
|
||||
6. Click the green pull request link in the output of the migrate command. See below.
|
||||
|
||||
### Example
|
||||
|
||||
|
||||
|
||||
## View the pull request
|
||||
The migrate output will show you the pull request on GitHub.
|
||||
|
||||
### Example
|
||||
|
||||
|
||||
### Next Lab
|
||||
[Migrate an Azure DevOps pipeline to GitHub Actions with a custom transformer](valet-migrate-custom-lab.md)
|
||||
Reference in New Issue
Block a user