Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Le sostituzioni delle etichette sono supportate con il runner -hosted Actions CodeBuild GitHub
<a name="sample-github-action-runners-update-labels"></a>

Nel tuo flusso di lavoro GitHub Actions (YAML), puoi fornire una serie di sostituzioni di etichette che modificano la build del tuo runner ospitato autonomamente. Tutte le build non riconosciute da CodeBuild verranno ignorate ma non falliranno la richiesta del webhook. Ad esempio, il seguente flusso di lavoro YAML include sostituzioni per immagine, dimensione dell'istanza, flotta e buildspec:

```
name: Hello World
on: [push]
jobs:
  Hello-World-Job:
    runs-on:
      - codebuild-myProject-${{ github.run_id }}-${{ github.run_attempt }}
        image:${{ matrix.os }}
        instance-size:${{ matrix.size }}
        fleet:myFleet
        buildspec-override:true
    strategy:
      matrix:
        include:
          - os: arm-3.0
            size: small
          - os: linux-5.0
            size: large
    steps:
      - run: echo "Hello World!"
```

**Nota**  
[Se il processo del flusso di lavoro è in sospeso GitHub, consulta [Risolvi i problemi relativi al webhook](action-runner-troubleshoot-webhook.md) e Utilizzo di etichette personalizzate per indirizzare i lavori.](https://docs.github.com/en/enterprise-server@3.12/actions/hosting-your-own-runners/managing-self-hosted-runners/using-self-hosted-runners-in-a-workflow?learn=hosting_your_own_runners&learnProduct=actions#using-custom-labels-to-route-jobs)

`codebuild-<project-name>-${{github.run_id}}-${{github.run_attempt}}`(obbligatorio)
+ Ad esempio: `codebuild-fake-project-${{ github.run_id }}-${{ github.run_attempt }}`
+ Obbligatorio per tutti i flussi di lavoro GitHub Actions YAMLs. *<project name>*deve essere uguale al nome del progetto per il quale è configurato il webhook runner self-hosted.

`image:<environment-type>-<image-identifier>`
+ Ad esempio: `image:arm-3.0`
+ Sostituisce l'immagine e il tipo di ambiente utilizzati quando si avvia la build self-hosted runner con un'immagine curata. Per maggiori informazioni sui valori supportati, consulta. [Immagini di calcolo supportate con il runner -hosted Actions CodeBuild GitHub](sample-github-action-runners-update-yaml.images.md)
  + Per sovrascrivere l'immagine e il tipo di ambiente utilizzati con un'immagine personalizzata, usa `image:custom-<environment-type>-<custom-image-identifier>`
  + Ad esempio: `image:custom-arm-public.ecr.aws/codebuild/amazonlinux-aarch64-standard:3.0`
**Nota**  
Se l'immagine personalizzata si trova in un registro privato, vedi. [Configura una credenziale di registro privata per i corridori ospitati autonomamente](private-registry-sample-configure-runners.md)

`instance-size:<instance-size>`
+ Ad esempio: `instance-size:medium`
+ Sostituisce il tipo di istanza utilizzato all'avvio della build self-hosted runner. Per maggiori informazioni sui valori supportati, consulta. [Immagini di calcolo supportate con il runner -hosted Actions CodeBuild GitHub](sample-github-action-runners-update-yaml.images.md)

`fleet:<fleet-name>`
+ Ad esempio: `fleet:myFleet`
+ Sostituisce le impostazioni del parco veicoli configurate nel progetto per utilizzare il parco veicoli specificato. Per ulteriori informazioni, consulta [Run si basa su flotte a capacità riservata](fleets.md).

`buildspec-override:<boolean>`
+ Ad esempio: `buildspec-override:true`
+ Consente alla build di eseguire i comandi buildspec nelle fasi, e `INSTALL` `PRE_BUILD``POST_BUILD`, se impostata su. `true`

## Sovrascrittura di un'etichetta singola (legacy)
<a name="sample-github-action-runners-update-single-labels"></a>

CodeBuild consente di fornire più sostituzioni in una singola etichetta utilizzando quanto segue:
+ Per sovrascrivere le impostazioni dell'ambiente per una build di calcolo Amazon EC2/Lambda, usa la seguente sintassi:

  ```
  runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-<environment-type>-<image-identifier>-<instance-size>
  ```
+ Per sovrascrivere le impostazioni del tuo parco macchine per la build di calcolo di Amazon EC2, utilizza la seguente sintassi:

  ```
  runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-fleet-<fleet-name>
  ```
+ Per sovrascrivere sia la flotta che l'immagine utilizzate per la build, usa la seguente sintassi:

  ```
  runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-image-<image-version>-fleet-<fleet-name>
  ```
+ Per eseguire i comandi buildspec durante la compilazione, `-with-buildspec` possono essere aggiunti come suffisso all'etichetta:

  ```
  runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-<image>-<image-version>-<instance-size>-with-buildspec
  ```
+ Facoltativamente, puoi fornire un override della dimensione dell'istanza senza sovrascrivere l'immagine. Per le build di Amazon EC2, puoi escludere sia il tipo di ambiente che l'identificatore dell'immagine. Per le build Lambda, puoi escludere l'identificatore dell'immagine.