GitHubRiferimento buildspec di Action Runner

Questo argomento contiene il riferimento buildspec per le proprietà di GitHub Action runner.

steps

Sequenza opzionale. I passaggi vengono utilizzati per eseguire comandi e azioni inCodeBuild. Per ulteriori informazioni, consulta GitHubAction runner inAWS CodeBuild.

Nota

Ogni fase di compilazione supporta un elenco commands o un elenco disteps, ma entrambi non possono essere utilizzati nella stessa fase.

Ogni fase di costruzione contiene le seguenti proprietà.

id

Facoltativo. L'identificatore della fase che può essere utilizzato per fare riferimento alla fase in altri contesti.

if

Facoltativo. Un'istruzione condizionale che può essere utilizzata per impedire l'esecuzione di un passaggio a meno che non sia soddisfatta una condizione. Questa dichiarazione può utilizzare qualsiasi contesto supportato, ad esempio riferimenti a variabili ambientali daCodeBuild, nonché un'espressione.

name

Facoltativo. Il nome della fase. Se il nome non è specificato, il nome sarà predefinito con il testo specificato nel run comando.

usi

L'azione che viene eseguita per il passaggio. Alcune azioni richiedono di impostare gli input utilizzandowith. Fai riferimento al file README dell'azione per determinare quali input sono necessari. Per ulteriori informazioni, consulta QualiGitHubAzioni posso usare?.

Se uses è specificato nella fase di compilazione, non può essere utilizzato conrun.

Nota

Si consiglia di includere la versione dell'azione che si sta utilizzando. Questo può essere fatto specificando un tag Git ref, SHA o Docker. Per ulteriori informazioni, vedete la sintassi steps.uses.

correre

Comando che esegue programmi da riga di comando. Questi possono essere comandi a riga singola o comandi multilinea. Per impostazione predefinita, questi comandi vengono eseguiti utilizzando shell non connesse all'accesso. Per scegliere un guscio diverso, usashell.

Se run è specificato nella fase di compilazione, non può essere utilizzato conuses.

guscio

Facoltativo. La shell specificata per questa sequenza. Per i parametri della shell supportati, vedete steps.shell. Se non specificata, la shell utilizzata è bash. Se bash non è disponibile, viene usato sh.

con

Facoltativo. Una mappa dei parametri di input definiti dall'azione. Ogni parametro è una coppia chiave/valore.

con.args

Facoltativo. Una stringa che definisce gli input per un contenitore Docker.

con.entrypoint

Facoltativo. Il punto di ingresso Docker specificato per il Dockerfile.

env

Facoltativo. Le variabili specificate per i passaggi da utilizzare nell'ambiente.

continue-on-error

Facoltativo. Un valore booleano che indica se un errore di questa sequenza di passaggi può essere ignorato.

false

Il valore predefinito. Se questa sequenza di passaggi fallisce, la compilazione avrà esito negativo.

true

Se questa sequenza di passaggi fallisce, la compilazione può comunque avere successo.

timeout in minuti

Facoltativo. Il numero massimo di minuti per cui il passaggio può essere eseguito prima di terminare. Per impostazione predefinita, non è previsto alcun timeout. Se il timeout della fase supera il timeout di compilazione, il passaggio si interromperà quando viene raggiunto il timeout di compilazione.

Di seguito è riportato un esempio di utilizzo dell'azione Super-Linter: GitHub

version: 0.2
phases:
  build:
    steps:
      - name: Lint Code Base
        uses: github/super-linter@v5
        env:
          VALIDATE_ALL_CODEBASE: true
          USE_FIND_ALGORITHM: true
          FILTER_REGEX_INCLUDE: '/github/workspace/buildspec.yml'