Usare il Dev Proxy con Azure Pipelines

A colpo d'occhio
Obiettivo: Usare il proxy di sviluppo in Azure Pipelines
Tempo: 20 minuti
Plugin: Vari
Prerequisiti:ConfigurareIl proxy di sviluppo, Azure DevOps

L'uso di Dev Proxy con Azure Pipelines è un ottimo modo per testare le applicazioni in un ambiente controllato. Seguendo questa procedura, è possibile usare Dev Proxy con Azure Pipelines.

Nota

In questo articolo viene usato un agente Ubuntu per Azure Pipelines.

Installare Dev Proxy e memorizzarlo nella cache

Per iniziare, installare Dev Proxy nell'agente usando un'attività script per installare Dev Proxy.

- script: bash -c "$(curl -sL https://aka.ms/devproxy/setup.sh)"
  displayName: 'Install Dev Proxy'

Per impostazione predefinita, viene installata la versione più recente di Dev Proxy. Se si vuole installare una versione specifica, è possibile specificarla passando una versione alla fine dello script:

- script: bash -c "$(curl -sL https://aka.ms/devproxy/setup.sh)" v1.0.0
  displayName: 'Install Dev Proxy v1.0.0'

Una procedura consigliata consiste nel memorizzare nella cache i file di installazione di Dev Proxy per velocizzare le esecuzioni successive. A questo scopo, è possibile usare l'attività Cache . Ecco come eseguire questa operazione:

variables:
- name: DEV_PROXY_VERSION
  value: v1.0.0
- name: DEV_PROXY_CACHE_RESTORED
  value: 'false'

steps:
- task: Cache@2
  inputs:
    key: '"dev-proxy-$(DEV_PROXY_VERSION)"'
    path: ./devproxy
    cacheHitVar: DEV_PROXY_CACHE_RESTORED
  displayName: Cache Dev Proxy

- script: bash -c "$(curl -sL https://aka.ms/devproxy/setup.sh)" $DEV_PROXY_VERSION
  displayName: 'Install Dev Proxy'
  condition: ne(variables.DEV_PROXY_CACHE_RESTORED, 'true')

Avviare il proxy di sviluppo

Quando si avvia Dev Proxy in una pipeline CI/CD, è possibile avviarlo da uno script o includere lo script inline. Quando lo script è pronto, richiamarlo nel file della pipeline:

- script: bash ./run.sh
  displayName: 'Start Dev Proxy'

Controllare il proxy di sviluppo

Per controllare Dev Proxy, è possibile usare l'API del proxy di sviluppo. Ad esempio, per avviare la registrazione delle richieste, è possibile inviare una richiesta POST all'endpoint /proxy :

- script: |
    curl -X POST http://localhost:8897/proxy -H "Content-Type: application/json" -d '{"recording": true}'
  displayName: 'Start recording'

Caricare i log del proxy di sviluppo come artefatti

Quando si esegue Dev Proxy in una pipeline CI/CD, è possibile analizzare i log in un secondo momento. Per mantenere i log di Dev Proxy, è possibile caricarli come artefatti:

- task: PublishPipelineArtifact@1
  displayName: Upload Dev Proxy logs
  inputs:
    targetPath: $(LOG_FILE)
    artifact: $(LOG_FILE)

Caricare i report del proxy di sviluppo

Se si usa Dev Proxy per analizzare le richieste, è possibile caricare i report anche come artefatti:

- script: |
    mkdir -p $(Build.ArtifactStagingDirectory)/Reports
    for file in *Reporter*; do
      if [ -f "$file" ]; then
        cp "$file" $(Build.ArtifactStagingDirectory)/Reports
      fi
    done
  displayName: 'Copy reports to artifact directory'

- task: PublishPipelineArtifact@1
  displayName: Upload Dev Proxy reports
  inputs:
    targetPath: '$(Build.ArtifactStagingDirectory)/Reports'
    artifact: 'Reports'

File di pipeline di esempio

Ecco un semplice esempio di come usare Dev Proxy in una pipeline di Azure. Questo flusso di lavoro installa Dev Proxy, lo avvia, invia una richiesta tramite curl e quindi visualizza i log.

trigger:
- main
- dev

pool:
  vmImage: ubuntu-latest

variables:
- name: DEV_PROXY_VERSION
  value: v1.0.0

steps:
- script: bash -c "$(curl -sL https://aka.ms/devproxy/setup.sh)" $DEV_PROXY_VERSION
  displayName: 'Install Dev Proxy'

- script: bash ./start.sh
  displayName: 'Start Dev Proxy'

- script: |
     curl -ikx http://127.0.0.1:8000 https://jsonplaceholder.typicode.com/posts
  displayName: 'Send request'

- script: |
    curl -X POST http://localhost:8897/proxy/stop
  displayName: 'Stop Dev Proxy'

- script: |
    echo "Dev Proxy logs:"
    cat devproxy.log
  displayName: 'Show Dev Proxy logs'

Vedere anche

• Utilizzare il proxy di sviluppo negli scenari CI/CD
• Usare Dev Proxy con GitHub Actions
• API del proxy di sviluppo