Configurare manualmente il flusso di lavoro CI/CD per l'esecuzione di test di carico

• Un'organizzazione e un progetto di Azure DevOps. Se non si ha un'organizzazione di Azure DevOps, è possibile crearne una gratuitamente. Per informazioni su come iniziare a usare Azure Pipelines, vedere Creare la prima pipeline.

• Un account GitHub. Se non si ha un account GitHub, è possibile crearne uno gratuitamente.
• Un repository GitHub per archiviare i file di input del test di carico e creare un flusso di lavoro di GitHub Actions. Per crearne uno, vedere Creazione di un nuovo repository.

• Autorizzazione per creare o modificare una pipeline CI.
• Repository del codice sorgente per archiviare i file di input del test di carico.

Creare una connessione al servizio in Azure Pipelines

In Azure Pipelines si crea una connessione al servizio nel progetto Azure DevOps per accedere alle risorse nella sottoscrizione di Azure. Quando si crea la connessione al servizio, Azure DevOps crea un oggetto entità servizio Microsoft Entra.

1. Accedere all'organizzazione di Azure DevOps (https://dev.azure.com/<your-organization>) e selezionare il progetto.

   Sostituire il segnaposto di testo con l'identificatore <your-organization> del progetto.

2. Selezionare Impostazioni progetto>Connessioni> servizio+ Nuova connessione al servizio.

3. Nel riquadro Nuova connessione al servizio selezionare Azure Resource Manager e quindi selezionare Avanti.

4. Selezionare il metodo di autenticazione dell'entità servizio (automatico) e quindi selezionare Avanti.

5. Immettere i dettagli della connessione al servizio e quindi selezionare Salva per creare la connessione al servizio.

   Campo	Valore
   Livello di ambito	Sottoscrizione.
   Abbonamento	Selezionare la sottoscrizione di Azure che ospita la risorsa di test di carico.
   Gruppo di risorse	Selezionare il gruppo di risorse che contiene la risorsa di test di carico.
   Nome connessione del servizio	Immettere un nome univoco per la connessione al servizio.
   Concedere l'autorizzazione di accesso a tutte le pipeline	Selezionato.

6. Nell'elenco delle connessioni al servizio selezionare quella creata in precedenza e quindi selezionare Gestisci entità servizio.

   

   Il portale di Azure viene aperto in una scheda separata del browser e mostra i dettagli dell'entità servizio.

7. Nella portale di Azure copiare il valore Nome visualizzato.

   Questo valore viene usato nel passaggio successivo per concedere le autorizzazioni per l'esecuzione di test di carico all'entità servizio.

Concedere l'accesso a Test di carico di Azure

Test di carico di Azure usa il controllo degli accessi in base al ruolo di Azure per concedere le autorizzazioni per l'esecuzione di attività specifiche nella risorsa di test di carico. Per eseguire un test di carico dalla pipeline CI/CD, si concede il ruolo Collaboratore test di carico all'entità servizio.

1. Nella portale di Azure passare alla risorsa Test di carico di Azure.

2. Selezionare Controllo di accesso (IAM)>Aggiungi>assegnazione di ruolo.

3. Nella scheda Ruolo selezionare Collaboratore test di carico nell'elenco dei ruoli della funzione del processo.

   

4. Nella scheda Membri selezionare Seleziona membri e quindi usare il nome visualizzato copiato in precedenza per cercare l'entità servizio.

5. Selezionare l'entità servizio e quindi selezionare Seleziona.

6. Nella scheda Rivedi e assegna selezionare Rivedi e assegna per aggiungere l'assegnazione di ruolo.

È ora possibile usare la connessione al servizio nella definizione del flusso di lavoro di Azure Pipelines per accedere alla risorsa di test di carico di Azure.

Per accedere alla risorsa test di carico di Azure dal flusso di lavoro di GitHub Actions, creare prima un'entità servizio Microsoft Entra. Questa entità servizio rappresenta il flusso di lavoro di GitHub Actions in Microsoft Entra ID.

Successivamente, si concedono le autorizzazioni all'entità servizio per creare ed eseguire un test di carico con la risorsa Test di carico di Azure.

Creare un'entità servizio

Creare un'entità servizio nella sottoscrizione di Azure e assegnare il ruolo Collaboratore test di carico in modo che il flusso di lavoro di GitHub Actions abbia accesso alla risorsa test di carico di Azure per eseguire test di carico.

1. Creare un'entità servizio e assegnare il Load Test Contributor ruolo:

   # Get the resource ID for the load testing resource - replace the text place holders.
   loadtest=$(az resource show -g <resource-group-name> -n <load-testing-resource-name> --resource-type "Microsoft.LoadTestService/loadtests" --query "id" -o tsv)
   echo $loadtest
   
   # Create a service principal and assign the Load Test Contributor role - the scope is limited to the load testing resource.
   az ad sp create-for-rbac --name "my-load-test-cicd" --role "Load Test Contributor" \
                            --scopes $loadtest \
                            --json-auth
   

   L'output è un oggetto JSON che rappresenta l'entità servizio. Queste informazioni vengono usate per l'autenticazione con Azure nel flusso di lavoro di GitHub Actions.

   Creating 'Load Test Contributor' role assignment under scope
   {
     "clientId": "00000000-0000-0000-0000-000000000000",
     "clientSecret": "00000000-0000-0000-0000-000000000000",
     "subscriptionId": "00000000-0000-0000-0000-000000000000",
     "tenantId": "00000000-0000-0000-0000-000000000000",
     "activeDirectoryEndpointUrl": "https://login.microsoftonline.com",
     "resourceManagerEndpointUrl": "https://management.azure.com/",
     "activeDirectoryGraphResourceId": "https://graph.windows.net/",
     "sqlManagementEndpointUrl": "https://management.core.windows.net:8443/",
     "galleryEndpointUrl": "https://gallery.azure.com/",
     "managementEndpointUrl": "https://management.core.windows.net/"    
   }
   

   Nota

   È possibile che venga visualizzato un --sdk-auth avviso di deprecazione quando si esegue questo comando. In alternativa, è possibile usare l'autenticazione basata su OpenID Connessione (OIDC) per l'autenticazione di GitHub con Azure. Informazioni su come usare l'azione di accesso di Azure con OpenID Connessione.

2. Copiare l'oggetto JSON di output negli Appunti.

   Nel passaggio successivo si archiviano le informazioni dell'entità servizio come segreto gitHub Actions.

Archiviare le credenziali di Azure nel segreto gitHub Actions

Creare un segreto GitHub Actions per archiviare in modo sicuro le informazioni dell'entità servizio. Questo segreto viene usato nella definizione del flusso di lavoro per connettersi all'autenticazione con Azure e accedere alla risorsa di test di carico di Azure.

Per creare un segreto GitHub Actions:

1. In GitHub passare al repository.

2. Selezionare Impostazioni> Secrets & variables>Actions (Azioni).

3. Selezionare Nuovo segreto del repository, immettere le informazioni segrete e quindi selezionare Aggiungi segreto per creare un nuovo segreto.

   Campo	Valore
   Nome	AZURE_CREDENTIALS
   Segreto	Incollare l'output JSON dal comando di creazione dell'entità servizio copiato in precedenza.

È ora possibile accedere alla sottoscrizione di Azure e alla risorsa di test di carico dal flusso di lavoro di GitHub Actions usando le credenziali archiviate.

Se si usa un altro strumento CI/CD, usare l'interfaccia della riga di comando di Azure per interagire con le risorse di Azure. Seguire questa procedura per autorizzare l'accesso dello strumento di integrazione continua alla risorsa di test di carico:

1. Creare un'entità servizio Microsoft Entra per connettersi alla sottoscrizione di Azure e accedere alla risorsa di test di carico di Azure.
2. Concedere all'entità servizio le autorizzazioni per creare ed eseguire un test di carico assegnando il ruolo Collaboratore test di carico.
3. Archiviare le credenziali di Azure in modo sicuro nello strumento CI.

Per configurare l'autorizzazione del servizio per lo strumento CI, seguire questa procedura:

1. Creare un'entità servizio e assegnare il ruolo Collaboratore test di carico:

   Sostituire i <resource-group-name> segnaposto e <load-testing-resource-name> .

   # Get the resource ID for the load testing resource - replace the text place holders.
   loadtest=$(az resource show -g <resource-group-name> -n <load-testing-resource-name> --resource-type "Microsoft.LoadTestService/loadtests" --query "id" -o tsv)
   echo $loadtest
   
   # Create a service principal and assign the Load Test Contributor role - the scope is limited to the load testing resource.
   az ad sp create-for-rbac --name "my-load-test-cicd" --role "Load Test Contributor" \
                            --scopes $loadtest \
                            --json-auth
   

   L'output è un oggetto JSON che rappresenta l'entità servizio.

   Creating 'Load Test Contributor' role assignment under scope
   {
     "clientId": "00000000-0000-0000-0000-000000000000",
     "clientSecret": "00000000-0000-0000-0000-000000000000",
     "subscriptionId": "00000000-0000-0000-0000-000000000000",
     "tenantId": "00000000-0000-0000-0000-000000000000",
     "activeDirectoryEndpointUrl": "https://login.microsoftonline.com",
     "resourceManagerEndpointUrl": "https://management.azure.com/",
     "activeDirectoryGraphResourceId": "https://graph.windows.net/",
     "sqlManagementEndpointUrl": "https://management.core.windows.net:8443/",
     "galleryEndpointUrl": "https://gallery.azure.com/",
     "managementEndpointUrl": "https://management.core.windows.net/"    
   }
   

2. Copiare i clientIdvalori , clientSecrete tenantId e archiviarli in modo sicuro come segreti nello strumento di integrazione continua.

   Questi valori vengono usati per accedere alla sottoscrizione di Azure con il comando dell'interfaccia della riga di comando di Azure az login .

Installare l'estensione Test di carico di Azure per Azure DevOps

Per creare ed eseguire un test di carico, la definizione del flusso di lavoro di Azure Pipelines usa l'estensione dell'attività Test di carico di Azure da Azure DevOps Marketplace.

1. Aprire l'estensione dell'attività Test di carico di Azure in Azure DevOps Marketplace e selezionare Scarica gratuitamente.

2. Selezionare l'organizzazione Azure DevOps e quindi selezionare Installa per installare l'estensione.

   Se non si hanno privilegi di amministratore per l'organizzazione Azure DevOps selezionata, selezionare Richiedi per richiedere a un amministratore di installare l'estensione.

Aggiornare il flusso di lavoro di Azure Pipelines

Aggiornare il flusso di lavoro di Azure Pipelines per eseguire un test di carico per la risorsa di test di carico di Azure.

1. Accedere all'organizzazione di Azure DevOps (https://dev.azure.com/<your-organization>) e selezionare il progetto.

2. Selezionare Pipeline nel riquadro di spostamento sinistro, selezionare la pipeline e quindi selezionare Modifica per modificare la definizione del flusso di lavoro.

   In alternativa, selezionare Crea pipeline per creare una nuova pipeline in Azure Pipelines.

3. Usare l'attività AzureLoadTest per eseguire il test di carico.

   Specificare il file di configurazione del test di carico esportato in precedenza nella loadTestConfigFile proprietà .

   Sostituire i <load-testing-resource> segnaposto di testo e <load-testing-resource-group> con il nome della risorsa di test di carico di Azure e del gruppo di risorse.

       - task: AzureLoadTest@1
         inputs:
           azureSubscription: $(serviceConnection)
           loadTestConfigFile: 'config.yaml'
           loadTestResource: <load-testing-resource>
           resourceGroup: <load-testing-resource-group>
   

   Facoltativamente, è possibile passare parametri o segreti al test di carico usando la env proprietà o secrets .

4. Usare l'attività publish per pubblicare i risultati del test come artefatti nell'esecuzione del flusso di lavoro di Azure Pipelines.

       - publish: $(System.DefaultWorkingDirectory)/loadTest
         artifact: loadTestResults
   

Aggiornare il flusso di lavoro di GitHub Actions

Aggiornare il flusso di lavoro di GitHub Actions per eseguire un test di carico per la risorsa di test di carico di Azure.

1. In GitHub passare al repository.

2. Modificare il flusso di lavoro di GitHub Actions o creare un nuovo flusso di lavoro nel repository GitHub.

3. Usare l'azione actions/checkout per eseguire il check-out del repository con i file di input del test di carico.

       - name: Checkout
         uses: actions/checkout@v3
   

4. Usare l'azione per eseguire l'autenticazione azure/login con Azure usando le credenziali archiviate.

   Incollare il contenuto YAML seguente nella definizione del flusso di lavoro:

       - name: Login to Azure
         uses: azure/login@v1
         continue-on-error: false
         with:
           creds: ${{ secrets.AZURE_CREDENTIALS }}
   

5. Usare l'azione azure/load-testing per eseguire il test di carico.

   Specificare il file di configurazione del test di carico esportato in precedenza nella loadTestConfigFile proprietà .

   Sostituire i <load-testing-resource> segnaposto di testo e <load-testing-resource-group> con il nome della risorsa di test di carico di Azure e del gruppo di risorse.

       - name: 'Azure Load Testing'
         uses: azure/load-testing@v1
         with:
           loadTestConfigFile: 'config.yaml'
           loadTestResource: <load-testing-resource>
           resourceGroup: <load-testing-resource-group>
   

   Facoltativamente, è possibile passare parametri o segreti al test di carico usando la env proprietà o secrets .

6. Usare l'azione actions/upload-artifact per pubblicare i risultati del test come artefatti nell'esecuzione del flusso di lavoro di GitHub Actions.

       - uses: actions/upload-artifact@v2
         with:
           name: loadTestResults
           path: ${{ github.workspace }}/loadTest
   

Aggiornare il flusso di lavoro ci per eseguire un test di carico per la risorsa di test di carico di Azure usando l'interfaccia della riga di comando di Azure. Usare le specifiche dello strumento ci per aggiungere i comandi seguenti al flusso di lavoro ci:

1. Accedere alla sottoscrizione di Azure usando l'entità servizio.

   Usare i clientIdvalori , clientSecrete tenandId archiviati in precedenza.

   az login --service-principal -u $AZURE_CLIENT_ID -p $AZURE_CLIENT_SECRET -t $AZURE_TENANT_ID
   az account set -s $AZURE_SUBSCRIPTION_ID
   

2. Creare un test di carico usando il file YAML di configurazione del test di carico.

   Sostituire i <load-testing-resource>segnaposto di testo , <load-testing-resource-group>e <load-test-config-yaml> con il nome della risorsa di test di carico, il nome del gruppo di risorse e il nome file del file YAML di configurazione del test di carico aggiunto in precedenza al repository.

   az load test create --load-test-resource <load-testing-resource> --resource-group <load-testing-resource-group> --test-id sample-test-id --load-test-config-file <load-test-config-yaml>
   

3. Eseguire il test di carico.

   testRunId="run_"`date +"%Y%m%d%_H%M%S"`
   displayName="Run"`date +"%Y/%m/%d_%H:%M:%S"`
   
   az load test-run create --load-test-resource <load-testing-resource> --test-id sample-test-id --test-run-id $testRunId --display-name $displayName --description "Test run from CLI"
   

4. Recuperare e visualizzare le metriche lato client per l'esecuzione del test di carico.

   az load test-run metrics list --load-test-resource <load-testing-resource> --test-run-id $testRunId --metric-namespace LoadTestRunMetrics
   

1. Rimuovere le modifiche di Azure Pipelines:

   1. Accedere all'organizzazione di Azure DevOps (https://dev.azure.com/<your-organization>) e selezionare il progetto.

      Sostituire il segnaposto di testo con l'identificatore <your-organization> del progetto.

   2. Se è stata creata una nuova pipeline:If you created a new pipeline":

      1. Selezionare Pipeline e quindi selezionare la pipeline.

      2. Selezionare i puntini di sospensione e quindi selezionare Elimina.

         

      3. Immettere il nome della pipeline e quindi selezionare Elimina per eliminare la pipeline.

   3. Se è stata modificata una definizione del flusso di lavoro esistente, annullare le modifiche per l'esecuzione del test di carico e salvare il flusso di lavoro.

2. Rimuovere la connessione al servizio:

   1. Selezionare Impostazioni progetto>Connessioni al servizio e quindi selezionare la connessione al servizio.
   2. Selezionare Modifica>elimina per rimuovere la connessione al servizio.

1. Rimuovere le modifiche di GitHub Actions:

   1. In GitHub passare al repository.
   2. Se è stata creata una nuova definizione del flusso di lavoro, eliminare il file YAML del .github/workflows flusso di lavoro nella cartella .
   3. Se è stata modificata una definizione del flusso di lavoro esistente, annullare le modifiche per l'esecuzione del test di carico e salvare il flusso di lavoro.

2. Rimuovere l'entità servizio:

   az ad sp delete --id $(az ad sp show --display-name "my-load-test-cicd" -o tsv)
   

1. Annullare le modifiche nel flusso di lavoro ci.

2. Rimuovere l'entità servizio:

   az ad sp delete --id $(az ad sp show --display-name "my-load-test-cicd" -o tsv)