Aggiungere un'estensione dell'attività pipeline personalizzata

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Informazioni su come installare le estensioni all'organizzazione per attività di compilazione o rilascio personalizzate in Azure DevOps. Per altre informazioni, vedere Che cos'è Azure Pipelines?

Prerequisiti

Per creare estensioni per Azure DevOps, sono necessari il software e gli strumenti seguenti.

|--- README.md    
|--- images                        
    |--- extension-icon.png  
|--- buildandreleasetask            // where your task scripts are placed
|--- vss-extension.json             // extension's manifest

"execution": {
   "Node20_1": {
     "target": "index.js"
   }
 }

1. Creare un'attività personalizzata

Eseguire tutte le parti di questa procedura all'interno della buildandreleasetask cartella .

Creare lo scaffolding delle attività

1. Creare la struttura di cartelle per l'attività e installare le librerie e le dipendenze necessarie.

2. Aprire una finestra di comando di PowerShell, passare alla buildandreleasetask cartella ed eseguire il comando seguente.

   npm init --yes
   

   npm init crea il package.json file. È stato aggiunto il --yes parametro per accettare tutte le opzioni predefinite npm init .

   Suggerimento

   L'agente non installa automaticamente i moduli necessari perché prevede che la cartella attività includa i moduli del nodo. Per attenuare questo problema, copiare in node_modules buildandreleasetask. Man mano che l'attività diventa più grande, è facile superare il limite di dimensioni (50 MB) di un file VSIX. Prima di copiare la cartella del nodo, è possibile eseguire npm install --production o npm prune --productionoppure scrivere uno script per compilare e comprimere tutti gli elementi.

3. Aggiungere azure-pipelines-task-lib alla libreria.

   npm install azure-pipelines-task-lib --save
   

4. Assicurarsi che le digitazioni typeScript siano installate per le dipendenze esterne.

   npm install @types/node --save-dev
   npm install @types/q --save-dev
   

5. Creare un .gitignore file e aggiungervi node_modules. Il processo di compilazione deve eseguire un e npm install un oggetto typings install in modo che node_modules vengano compilati ogni volta e non sia necessario archiviare.

   echo node_modules > .gitignore
   

6. Installare Mocha come dipendenza di sviluppo.

   npm install mocha --save-dev -g
   npm install sync-request --save-dev
   npm install @types/mocha --save-dev
   

7. Scegliere TypeScript versione 2.3.4 o 4.6.3.

   npm install typescript@4.6.3 -g --save-dev
   

   Nota

   Assicurarsi che TypeScript sia installato a livello globale con npm nell'ambiente di sviluppo, in modo che il tsc comando sia disponibile. Se si ignora questo passaggio, TypeScript versione 2.3.4 viene usato per impostazione predefinita e è comunque necessario installare il pacchetto a livello globale per avere il tsc comando disponibile.

8. Creare tsconfig.json le opzioni del compilatore. Questo file garantisce che i file TypeScript vengano compilati in file JavaScript.

   tsc --init --target es2022
   

Creare un'attività

Ora che lo scaffolding è completo, è possibile creare l'attività personalizzata.

1. Creare un task.json file nella buildandreleasetask cartella . Il task.json file descrive l'attività di compilazione/rilascio ed è ciò che il sistema di compilazione/versione usa per eseguire il rendering delle opzioni di configurazione all'utente e per sapere quali script eseguire in fase di compilazione/rilascio.

2. Copiare il codice seguente e sostituire con le {{placeholders}} informazioni dell'attività. Il segnaposto più importante è e taskguiddeve essere univoco.

   {
    "$schema": "https://raw.githubusercontent.com/Microsoft/azure-pipelines-task-lib/master/tasks.schema.json",
    "id": "{{taskguid}}",
    "name": "{{taskname}}",
    "friendlyName": "{{taskfriendlyname}}",
    "description": "{{taskdescription}}",
    "helpMarkDown": "",
    "category": "Utility",
    "author": "{{taskauthor}}",
    "version": {
        "Major": 0,
        "Minor": 1,
        "Patch": 0
    },
    "instanceNameFormat": "Echo $(samplestring)",
    "inputs": [
        {
            "name": "samplestring",
            "type": "string",
            "label": "Sample String",
            "defaultValue": "",
            "required": true,
            "helpMarkDown": "A sample string"
        }
    ],
    "execution": {
        "Node20_1": {
            "target": "index.js"
        }
    }
    }
   

3. Creare un index.ts file usando il codice seguente come riferimento. Questo codice viene eseguito quando viene chiamata l'attività.

   import tl = require('azure-pipelines-task-lib/task');
   
    async function run() {
        try {
            const inputString: string | undefined = tl.getInput('samplestring', true);
            if (inputString == 'bad') {
                tl.setResult(tl.TaskResult.Failed, 'Bad input was given');
                return;
            }
            console.log('Hello', inputString);
        }
        catch (err:any) {
            tl.setResult(tl.TaskResult.Failed, err.message);
        }
    }
   
    run();
   

4. Immettere "tsc" dalla buildandreleasetask cartella per compilare un index.js file da index.ts.

componenti task.json

Vedere le descrizioni seguenti di alcuni componenti del task.json file.

(New-Guid).Guid

Eseguire l'attività

Eseguire l'attività con node index.js da PowerShell.

Nell'esempio seguente l'attività ha esito negativo perché gli input non sono stati forniti (samplestring è un input obbligatorio).

 node index.js
 ##vso[task.debug]agent.workFolder=undefined
 ##vso[task.debug]loading inputs and endpoints
 ##vso[task.debug]loaded 0
 ##vso[task.debug]task result: Failed
 ##vso[task.issue type=error;]Input required: samplestring
 ##vso[task.complete result=Failed;]Input required: samplestring

Come correzione, è possibile impostare l'input samplestring ed eseguire di nuovo l'attività.

$env:INPUT_SAMPLESTRING="Human"
node index.js
##vso[task.debug]agent.workFolder=undefined
##vso[task.debug]loading inputs and endpoints
##vso[task.debug]loading INPUT_SAMPLESTRING
##vso[task.debug]loaded 1
##vso[task.debug]Agent.ProxyUrl=undefined
##vso[task.debug]Agent.CAInfo=undefined
##vso[task.debug]Agent.ClientCert=undefined
##vso[task.debug]Agent.SkipCertValidation=undefined
##vso[task.debug]samplestring=Human
Hello Human

Questa volta, l'attività è riuscita perché samplestring è stata fornita e ha restituito correttamente "Hello Human!"

2. Eseguire unit test degli script delle attività

Eseguire unit test per testare rapidamente lo script attività e non gli strumenti esterni chiamati. Testare tutti gli aspetti dei percorsi di esito positivo e negativo.

1. Installare gli strumenti di test. In questa procedura viene usato Mocha come driver di test.

   npm install mocha --save-dev -g
   npm install sync-request --save-dev
   npm install @types/mocha --save-dev
   

2. Creare una tests cartella contenente un _suite.ts file con il contenuto seguente:

   import * as path from 'path';
   import * as assert from 'assert';
   import * as ttm from 'azure-pipelines-task-lib/mock-test';
   
   describe('Sample task tests', function () {
   
       before( function() {
   
       });
   
       after(() => {
   
       });
   
       it('should succeed with simple inputs', function(done: Mocha.Done) {
           // Add success test here
       });
   
       it('it should fail if tool returns 1', function(done: Mocha.Done) {
           // Add failure test here
       });    
   });
   

   Suggerimento

   La cartella di test deve trovarsi nella cartella buildandreleasetask. Se viene visualizzato un errore di richiesta di sincronizzazione, è possibile aggirarlo aggiungendo la richiesta di sincronizzazione alla cartella buildandreleasetask con il comando npm i --save-dev sync-request.

3. Creare un success.ts file nella directory di test con il contenuto seguente. Questa creazione di file simula l'esecuzione dell'attività e simula tutte le chiamate a metodi esterni.

   import ma = require('azure-pipelines-task-lib/mock-answer');
   import tmrm = require('azure-pipelines-task-lib/mock-run');
   import path = require('path');
   
   let taskPath = path.join(__dirname, '..', 'index.js');
   let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath);
   
   tmr.setInput('samplestring', 'human');
   
   tmr.run();
   

   Il test di esito positivo convalida che con gli input appropriati ha esito positivo senza errori o avvisi e restituisce l'output corretto.

4. Aggiungere il test di esito positivo dell'esempio seguente al _suite.ts file per eseguire lo strumento di esecuzione fittizia dell'attività.

       it('should succeed with simple inputs', function(done: Mocha.Done) {
       this.timeout(1000);
   
       let tp: string = path.join(__dirname, 'success.js');
       let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp);
   
       // tr.run(); //current, old function.
       tr.runAsync().then(() => {
           console.log(tr.succeeded);
           assert.equal(tr.succeeded, true, 'should have succeeded');
           assert.equal(tr.warningIssues.length, 0, "should have no warnings");
           assert.equal(tr.errorIssues.length, 0, "should have no errors");
           console.log(tr.stdout);
           assert.equal(tr.stdout.indexOf('Hello human') >= 0, true, "should display Hello human");
           done();
       }).catch((error) => {
           done(error); // Ensure the test case fails if there's an error
       });
   });
   

5. Creare un failure.ts file nella directory di test come strumento di esecuzione fittizia dell'attività con il contenuto seguente:

   import ma = require('azure-pipelines-task-lib/mock-answer');
   import tmrm = require('azure-pipelines-task-lib/mock-run');
   import path = require('path');
   
   let taskPath = path.join(__dirname, '..', 'index.js');
   let tmr: tmrm.TaskMockRunner = new tmrm.TaskMockRunner(taskPath);
   
   tmr.setInput('samplestring', 'bad');
   
   tmr.run();
   

   Il test di errore verifica che quando lo strumento ottiene un input non valido o incompleto, ha esito negativo nel modo previsto con un output utile.

6. Aggiungere il codice seguente al _suite.ts file per eseguire lo strumento di esecuzione fittizia dell'attività.

   it('it should fail if tool returns 1', function(done: Mocha.Done) {
       this.timeout(1000);
   
       let tp = path.join(__dirname, 'failure.js');
       let tr: ttm.MockTestRunner = new ttm.MockTestRunner(tp);
   
       tr.run();
       console.log(tr.succeeded);
       assert.equal(tr.succeeded, false, 'should have failed');
       assert.equal(tr.warningIssues.length, 0, "should have no warnings");
       assert.equal(tr.errorIssues.length, 1, "should have 1 error issue");
       assert.equal(tr.errorIssues[0], 'Bad input was given', 'error issue output');
       assert.equal(tr.stdout.indexOf('Hello bad'), -1, "Should not display Hello bad");
   
       done();
   });
   

7. Eseguire i test.

   tsc
   mocha tests/_suite.js
   

   Entrambi i test devono superare. Se si vogliono eseguire i test con un output più dettagliato (quello visualizzato nella console di compilazione), impostare la variabile di ambiente: TASK_TEST_TRACE=1.

   $env:TASK_TEST_TRACE=1
   

3. Creare il file manifesto dell'estensione

Il manifesto dell'estensione contiene tutte le informazioni sull'estensione. Include collegamenti ai file, incluse le cartelle delle attività e le cartelle delle immagini. Assicurarsi di aver creato una cartella images con extension-icon.png. L'esempio seguente è un manifesto dell'estensione che contiene l'attività di compilazione o versione.

Copiare il codice .json seguente e salvarlo come vss-extension.json file nella home directory.

Non creare questo file nella cartella buildandreleasetask.

{
    "manifestVersion": 1,
    "id": "build-release-task",
    "name": "Fabrikam Build and Release Tools",
    "version": "0.0.1",
    "publisher": "fabrikam",
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services"
        }
    ],    
    "description": "Tools for building/releasing with Fabrikam. Includes one build/release task.",
    "categories": [
        "Azure Pipelines"
    ],
    "icons": {
        "default": "images/extension-icon.png"        
    },
    "files": [
        {
            "path": "buildandreleasetask"
        }
    ],
    "contributions": [
        {
            "id": "custom-build-release-task",
            "type": "ms.vss-distributed-task.task",
            "targets": [
                "ms.vss-distributed-task.tasks"
            ],
            "properties": {
                "name": "buildandreleasetask"
            }
        }
    ]
}

Contributi

File

4. Creare un pacchetto dell'estensione

Creare un pacchetto di tutti i file per ottenere l'estensione in Visual Studio Marketplace. Tutte le estensioni vengono in pacchetto come file VSIX 2.0 compatibili con vsix. Microsoft offre un'interfaccia della riga di comando multipiattaforma per creare un pacchetto dell'estensione.

Dopo aver creato tfx-cli, passare alla home directory dell'estensione ed eseguire il comando seguente:

tfx extension create --manifest-globs vss-extension.json

Quando l'estensione in pacchetto si trova in un file con estensione vsix, è possibile pubblicare l'estensione nel Marketplace.

5. Pubblicare l'estensione

Per pubblicare l'estensione, creare prima il server di pubblicazione, quindi caricare l'estensione e infine condividerla.

Creare il server di pubblicazione

Tutte le estensioni, incluse le estensioni di Microsoft, vengono identificate come fornite da un editore. Se non si è già membri di un server di pubblicazione esistente, crearne uno.

1. Accedere al portale di pubblicazione di Visual Studio Marketplace.
2. Se non si è già membri di un server di pubblicazione esistente, viene richiesto di creare un server di pubblicazione. Se non viene richiesto di creare un server di pubblicazione, scorrere verso il basso fino alla fine della pagina e selezionare Pubblica estensioni in Siti correlati.
   • Specificare un identificatore per il server di pubblicazione, ad esempio : mycompany-myteam.
     • Questo identificatore viene usato come valore per l'attributo publisher nel file manifesto delle estensioni.
   • Specificare un nome visualizzato per il server di pubblicazione, ad esempio : My Team.
3. Esaminare il Contratto di pubblicazione del Marketplace e selezionare Crea.

Il server di pubblicazione è definito. In una versione futura è possibile concedere le autorizzazioni per visualizzare e gestire le estensioni dell'editore. È più semplice e più sicuro pubblicare le estensioni in un server di pubblicazione comune, senza la necessità di condividere un set di credenziali tra gli utenti.

Caricare l'estensione

Trovare il pulsante Carica nuova estensione, passare al file con estensione vsix in pacchetto e selezionare Carica.

1. È anche possibile caricare l'estensione tramite l'interfaccia della riga di tfx extension create comando usando il tfx extension publish comando anziché per creare un pacchetto e pubblicare l'estensione in un unico passaggio. Facoltativamente, è possibile usare --share-with per condividere l'estensione con uno o più account dopo la pubblicazione.

   tfx extension publish --manifest-globs your-manifest.json --share-with yourOrganization
   

2. Creare un token di accesso personale (PAT).

   • Selezionare l'ambito "Marketplace (pubblicazione)". Questo ambito limita il token solo alla possibilità di pubblicare estensioni nel Marketplace.

Condividere l'estensione

Ora che l'estensione è stata caricata, si trova nel Marketplace, ma nessuno può vederla. Condividerlo con l'organizzazione in modo che sia possibile installarlo e testarlo.

Selezionare con il pulsante destro del computer l'estensione e selezionare Condividi e immettere le informazioni dell'organizzazione. È possibile condividerlo anche con altri account a cui si vuole accedere all'estensione.

Ora che l'estensione è condivisa nel Marketplace, chiunque voglia usarla deve installarla.

6. Creare una pipeline di compilazione e versione per pubblicare l'estensione in Marketplace

Creare una pipeline di compilazione e versione in Azure DevOps per mantenere l'attività personalizzata nel Marketplace.

Prerequisiti

trigger: 
- main
pool:
vmImage: "ubuntu-latest"
variables:
- group: variable-group # Rename to whatever you named your variable group in the prerequisite stage of step 6
stages:
- stage: Run_and_publish_unit_tests
jobs:
- job:
steps:
- task: TfxInstaller@4
inputs:
version: "v0.x"
- task: Npm@1
inputs:
command: 'install'
workingDir: '/TaskDirectory' # Update to the name of the directory of your task
- task: Bash@3
displayName: Compile Javascript
inputs:
targetType: "inline"
script: |
cd TaskDirectory # Update to the name of the directory of your task
tsc
- task: Npm@1
inputs:
command: 'custom'
workingDir: '/TestsDirectory' # Update to the name of the directory of your task's tests
customCommand: 'testScript' # See the definition in the explanation section below - it may be called test
- task: PublishTestResults@2
inputs:
testResultsFormat: 'JUnit'
testResultsFiles: '**/ResultsFile.xml'
- stage: Package_extension_and_publish_build_artifacts
jobs:
- job:
steps:
- task: TfxInstaller@4
inputs:
version: "0.x"
- task: Npm@1
inputs:
command: 'install'
workingDir: '/TaskDirectory' # Update to the name of the directory of your task
- task: Bash@3
displayName: Compile Javascript
inputs:
targetType: "inline"
script: |
cd TaskDirectory # Update to the name of the directory of your task
tsc
- task: QueryAzureDevOpsExtensionVersion@4
name: QueryVersion
inputs:
connectTo: 'VsTeam'
connectedServiceName: 'ServiceConnection' # Change to whatever you named the service connection
publisherId: '$(PublisherID)'
extensionId: '$(ExtensionID)'
versionAction: 'Patch'
- task: PackageAzureDevOpsExtension@4
inputs:
rootFolder: '$(System.DefaultWorkingDirectory)'
publisherId: '$(PublisherID)'
extensionId: '$(ExtensionID)'
extensionName: '$(ExtensionName)'
extensionVersion: '$(QueryVersion.Extension.Version)'
updateTasksVersion: true
updateTasksVersionType: 'patch'
extensionVisibility: 'private' # Change to public if you're publishing to the marketplace
extensionPricing: 'free'
- task: CopyFiles@2
displayName: "Copy Files to: $(Build.ArtifactStagingDirectory)"
inputs:
Contents: "**/*.vsix"
TargetFolder: "$(Build.ArtifactStagingDirectory)"
- task: PublishBuildArtifacts@1
inputs:
PathtoPublish: '$(Build.ArtifactStagingDirectory)'
ArtifactName: '$(ArtifactName)'
publishLocation: 'Container'
- stage: Download_build_artifacts_and_publish_the_extension
jobs:
- job:
steps:
- task: TfxInstaller@4
inputs:
version: "v0.x"
- task: DownloadBuildArtifacts@0
inputs:
buildType: "current"
downloadType: "single"
artifactName: "$(ArtifactName)"
downloadPath: "$(System.DefaultWorkingDirectory)"
- task: PublishAzureDevOpsExtension@4
inputs:
connectTo: 'VsTeam'
connectedServiceName: 'ServiceConnection' # Change to whatever you named the service connection
fileType: 'vsix'
vsixFile: '$(PublisherID).$(ExtensionName)/$(PublisherID)..vsix'
publisherId: '$(PublisherID)'
extensionId: '$(ExtensionID)'
extensionName: '$(ExtensionName)'
updateTasksVersion: false
extensionVisibility: 'private' # Change to public if you're publishing to the marketplace
extensionPricing: 'free'

Per altre informazioni, vedere Specificare gli eventi che attivano le pipeline.

Fasi pipeline

La sezione seguente consente di comprendere il funzionamento delle fasi della pipeline.

Fase 1: Eseguire e pubblicare unit test

Questa fase esegue unit test e pubblica i risultati dei test in Azure DevOps.

Per eseguire unit test, aggiungere uno script personalizzato al file package.json come nell'esempio seguente.

"scripts": {
    "testScript": "mocha ./TestFile --reporter xunit --reporter-option output=ResultsFile.xml"
},

1. Aggiungere "Usare l'interfaccia della riga di comando del nodo per Azure DevOps (tfx-cli)" per installare tfx-cli nell'agente di compilazione.

2. Aggiungere l'attività "npm" con il comando "install" e impostare come destinazione la cartella con il file package.json.

3. Aggiungere l'attività "Bash" per compilare TypeScript in JavaScript.

4. Aggiungere l'attività "npm" con il comando "personalizzato", impostare come destinazione la cartella contenente gli unit test e immettere testScript come comando. Usare gli input seguenti:

   • Comando: personalizzato
   • Cartella di lavoro contenente package.json: /TestsDirectory
   • Comandi e argomenti: testScript

5. Aggiungere l'attività "Pubblica risultati test". Se si usa il reporter Mocha XUnit, assicurarsi che il formato dei risultati sia "JUnit" e non "XUnit". Impostare la cartella di ricerca sulla directory radice. Usare gli input seguenti:

   • Formato dei risultati del test: JUnit
   • File dei risultati dei test: **/ResultsFile.xml
   • Cartella di ricerca: $(System.DefaultWorkingDirectory)

   Dopo la pubblicazione dei risultati del test, l'output nella scheda test dovrebbe essere simile all'esempio seguente.

   

Fase 2: Creare un pacchetto dell'estensione e pubblicare gli artefatti di compilazione

1. Aggiungere "Usare l'interfaccia della riga di comando del nodo per Azure DevOps (tfx-cli)" per installare tfx-cli nell'agente di compilazione.

2. Aggiungere l'attività "npm" con il comando "install" e impostare come destinazione la cartella con il file package.json.

3. Aggiungere l'attività "Bash" per compilare TypeScript in JavaScript.

4. Aggiungere l'attività "Versione estensione query" per eseguire una query sulla versione dell'estensione esistente. Usare gli input seguenti:

   • Connettersi a: Visual Studio Marketplace
   • Visual Studio Marketplace (connessione al servizio): connessione al servizio
   • ID editore: ID dell'editore di Visual Studio Marketplace
   • ID estensione: ID dell'estensione nel file vss-extension.json
   • Aumentare la versione: Patch
   • Variabile di output: Task.Extension.Version

5. Aggiungere l'attività "Estensione pacchetto" per creare un pacchetto delle estensioni in base al file JSON del manifesto. Usare gli input seguenti:

   • Cartella manifesti radice: punta alla directory radice che contiene il file manifesto. Ad esempio, $(System.DefaultWorkingDirectory) è la directory radice
   • File manifesto: vss-extension.json
   • ID editore: ID dell'editore di Visual Studio Marketplace
   • ID estensione: ID dell'estensione nel file vss-extension.json
   • Nome estensione: nome dell'estensione nel file vss-extension.json
   • Versione dell'estensione: $(Task.Extension.Version)
   • Eseguire l'override della versione delle attività: selezionata (true)
   • Tipo di override: Sostituisci solo patch (1.0.r)
   • Visibilità estensione: se l'estensione è ancora in fase di sviluppo, impostare il valore su privato. Per rilasciare l'estensione al pubblico, impostare il valore su public

6. Aggiungere l'attività "Copia file" per copiare i file pubblicati. Usare gli input seguenti:

   • Contenuto: tutti i file da copiare per pubblicarli come artefatto
   • Cartella di destinazione: cartella in cui vengono copiati i file
     • Ad esempio: $(Build.ArtifactStagingDirectory)

7. Aggiungere "Pubblica artefatti di compilazione" per pubblicare gli artefatti da usare in altri processi o pipeline. Usare gli input seguenti:

   • Percorso di pubblicazione: percorso della cartella che contiene i file da pubblicare
     • Ad esempio: $(Build.ArtifactStagingDirectory)
   • Nome artefatto: nome assegnato all'artefatto
   • Percorso di pubblicazione degli artefatti: scegliere "Azure Pipelines" per usare l'artefatto nei processi futuri

Fase 3: Scaricare gli artefatti di compilazione e pubblicare l'estensione

1. Aggiungere "Usare l'interfaccia della riga di comando del nodo per Azure DevOps (tfx-cli)" per installare tfx-cli nell'agente di compilazione.

2. Aggiungere l'attività "Scarica artefatti di compilazione" per scaricare gli artefatti in un nuovo processo. Usare gli input seguenti:

   • Scaricare gli artefatti generati da: se si scarica l'artefatto in un nuovo processo dalla stessa pipeline, selezionare "Build corrente". Se si esegue il download in una nuova pipeline, selezionare "Compilazione specifica".
   • Tipo di download: scegliere "Artefatto specifico" per scaricare tutti i file pubblicati.
   • Nome artefatto: nome dell'artefatto pubblicato.
   • Directory di destinazione: cartella in cui scaricare i file.

3. L'ultima attività necessaria è l'attività "Pubblica estensione". Usare gli input seguenti:

   • Connettersi a: Visual Studio Marketplace
   • Connessione a Visual Studio Marketplace: ServiceConnection
   • Tipo di file di input: file VSIX
   • File VSIX: /Publisher.*.vsix
   • ID editore: ID dell'editore di Visual Studio Marketplace
   • ID estensione: ID dell'estensione nel file vss-extension.json
   • Nome estensione: nome dell'estensione nel file vss-extension.json
   • Visibilità dell'estensione: privata o pubblica

Facoltativo: installare e testare l'estensione

Installare un'estensione condivisa con l'utente in pochi passaggi:

1. Dal pannello di controllo dell'organizzazione (https://dev.azure.com/{organization}/_admin), passare alla pagina di amministrazione della raccolta di progetti.
2. Nella scheda Estensioni trovare l'estensione nel gruppo "Estensioni condivise con l'utente corrente" e selezionare il collegamento di estensione.
3. Installare l'estensione .

Se non è possibile visualizzare la scheda Estensioni , assicurarsi di essere nel pannello di controllo (la pagina di amministrazione a livello di raccolta del progetto, https://dev.azure.com/{organization}/_admin) e non la pagina di amministrazione per un progetto.

Se non viene visualizzata la scheda Estensioni, le estensioni non sono abilitate per l'organizzazione. È possibile ottenere l'accesso anticipato alla funzionalità delle estensioni aggiungendo il Programma Per i partner di Visual Studio.

Per creare un pacchetto e pubblicare le estensioni di Azure DevOps in Visual Studio Marketplace, è possibile scaricare le attività dell'estensione Azure DevOps.

Domande frequenti

Vedere le domande frequenti seguenti sull'aggiunta di attività di compilazione o versione personalizzate nelle estensioni per Azure DevOps.

D: Come è possibile limitare l'utilizzo dei comandi di Azure Pipelines per l'attività?

È possibile limitare l'utilizzo e le variabili dei comandi di Azure Pipelines, che vengono impostati per attività. Questa azione può essere utile per impedire l'accesso illimitato a variabili/comandi vso per script personalizzati eseguiti dall'attività. È consigliabile configurarla per le nuove attività. Per applicare, potrebbe essere necessario aggiungere l'istruzione seguente al file task.json:

  "restrictions": {
    "commands": {
      "mode": "restricted"
    },
    "settableVariables": {
      "allowed": ["variable1", "test*"]
    }
}

Se restricted il valore è specificato per mode , è possibile eseguire solo i comandi seguenti dall'attività:

• logdetail
• logissue
• complete
• setprogress
• setsecret
• setvariable
• debug
• settaskvariable
• prependpath
• publish

Le settableVariables restrizioni consentono di passare un elenco di variabili consentite, che vengono impostate da setvariable o prependpath da comandi. Consente anche espressioni regolari di base. Ad esempio, se l'elenco di elementi consentiti è: ['abc', 'test*'], impostando abc, testo test1 come variabili con qualsiasi valore o anteponendo il percorso, il percorso avrà esito positivo, ma se si tenta di impostare un proxy di variabile, verrà visualizzato un avviso. L'elenco vuoto indica che nessuna variabile viene modificata dall'attività.

Se la settableVariables chiave o commands viene omessa, la restrizione pertinente non viene applicata.

La funzionalità di restrizione è disponibile dalla versione dell'agente 2.182.1 .

D: Come viene gestito il segnale di annullamento da un'attività?

R: L'agente della pipeline invia SIGINT e SIGTERM segnala al processo figlio pertinente. Non esistono mezzi espliciti nella libreria di attività da elaborare. Per altre informazioni, vedere Annullamento dei processi di Agent.

D: Come è possibile rimuovere l'attività dalla raccolta di progetti?

R: Non è supportata l'eliminazione automatica delle attività. L'eliminazione automatica non è sicura e interrompe le pipeline esistenti che già usano tali attività. Tuttavia, è possibile contrassegnare le attività come deprecate. A tale scopo, aggiornare la versione dell'attività e contrassegnare l'attività come deprecata.

D: Come è possibile aggiornare l'attività personalizzata al nodo più recente?

R: È consigliabile eseguire l'aggiornamento alla versione più recente di Node. Per altre informazioni, vedere Aggiornamento delle attività al nodo 20.

Poiché gli agenti ospitati da Microsoft e varie versioni di Azure DevOps Server hanno cicli di vita diversi, possono essere installate versioni di Node Runner diverse a seconda della posizione in cui è in esecuzione un'attività. Per poter eseguire la stessa attività sugli agenti con versioni diverse dello strumento di esecuzione di Node, il file task.json può contenere più sezioni di esecuzione. Nell'esempio seguente, gli agenti di Azure Pipeline che includono lo strumento di esecuzione del nodo 20 lo sceglieranno per impostazione predefinita e quelli che non eseguiranno il fallback all'implementazione del nodo 10.

  "execution": {
    "Node10": {
      "target": "bash.js",
      "argumentFormat": ""
    },
    "Node20_1": {
      "target": "bash.js",
      "argumentFormat": ""
    }

Per aggiornare le attività:

• Testare le attività nelle varie versioni dello strumento di esecuzione dei nodi per assicurarsi che il codice si comporti come previsto.

• Nella sezione esecuzione dell'attività aggiornare da Node o Node10 a Node16 o Node20.

• Per supportare le versioni precedenti del server, è necessario lasciare la Node/Node10 destinazione. Le versioni precedenti di Azure DevOps Server potrebbero non includere la versione più recente dello strumento di esecuzione dei nodi.

• È possibile scegliere di condividere il punto di ingresso definito nella destinazione o avere destinazioni ottimizzate per la versione del nodo usata.

  "execution": {
     "Node10": {
       "target": "bash10.js",
       "argumentFormat": ""
  },
  "Node16": {
     "target": "bash16.js",
     "argumentFormat": ""
  },
  "Node20_1": {
     "target": "bash20.js",
     "argumentFormat": ""
  }
  

Articoli correlati

• Informazioni di riferimento sul manifesto dell'estensione
• Schema JSON attività di compilazione/rilascio
• Esempi di attività di compilazione/rilascio