Scheda di riferimento di GitHub Actions - Struttura standard ed elenco delle azioni più utili

GitHub Actions è una piattaforma di automazione e CI/CD all’interno di GitHub, utilizzata per costruire, testare e distribuire il codice in base a eventi come push, pull request o in base a una pianificazione.

Oltre al servizio standard GitHub, è possibile utilizzare GitHub Actions in un server Gitea self-hosted.

Le Actions coprono strumenti ufficiali, della community e di terze parti, supportando l’automazione dalla costruzione e i test fino alla distribuzione, gestione del rilascio, QA e notifiche.

Questo riepilogo copre la struttura delle GitHub Actions, una breve descrizione e le azioni più comuni utilizzate nei flussi di lavoro open source e commerciali. Fa parte di Strumenti per Sviluppatori: La Guida Completa ai Flussi di Lavoro di Sviluppo Moderni.

Struttura di Configurazione di Base

I flussi di lavoro (Workflows) di GitHub Actions sono definiti in file YAML situati nel directory .github/workflows all’interno del repository.

name: Workflow Name
on:
  push:
    branches: [ main ]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Set up Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '18'
      - name: Run tests
        run: npm test

• Il blocco on specifica gli eventi di attivazione.
• Ogni job viene eseguito su un runner dedicato.
• I steps possono eseguire comandi shell o chiamare azioni riutilizzabili.

Componenti Principali del Workflow

Eventi di Attivazione

• push
• pull_request
• schedule (usando la sintassi cron)
• workflow_dispatch (attivazione manuale, consente parametri di input)
• release, issue, ecc.

Esempio:

on:
  push:
    branches: [ main ]
  workflow_dispatch:
    inputs:
      environment:
        description: 'Deployment Environment'
        required: true
        default: 'production'
        type: string

Azioni Integrati Utili

Parametri delle Azioni

Parametri Generali per Qualsiasi Chiamata all’Azione:

- name: Some Action or Step
  uses: owner/repo@ref
  with:
    param1: value
    param2: value
  env:
    ENV_VAR: value
  if: ${{ condition }}
  run: command_to_run
  shell: bash|pwsh|python|sh
  continue-on-error: true|false

• with: argomenti passati all’azione (vedere la documentazione dell’azione per tutte le opzioni)
• env: variabili di ambiente per lo step
• if: esecuzione condizionale
• run: comandi shell (se non si sta usando un’azione)
• shell: shell utilizzata per eseguire lo step
• continue-on-error: procedere anche se lo step fallisce

Definizione di Input Personalizzati per le Azioni

Nel metadato della tua azione (action.yml):

inputs:
  example-input:
    description: 'An example input'
    required: false
    default: 'default-value'

Quando viene usato in un workflow:

- uses: my/action@v1
  with:
    example-input: 'custom-value'

Accessibile come variabile di ambiente INPUT_EXAMPLE_INPUT quando l’azione viene eseguita.

Esempio: Workflow con Parametri Manuali

name: Deploy
on:
  workflow_dispatch:
    inputs:
      environment:
        description: 'Deployment Environment'
        required: true
        default: 'production'
        type: string
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Deploy to environment
        run: echo "Deploying to ${{ github.event.inputs.environment }}"

Marketplace delle Azioni

• Migliaia di azioni riutilizzabili sono disponibili nel GitHub Marketplace.
• Le categorie includono: deployment cloud, strumenti di notifica, framework di test, analisi del codice e altro ancora.
• Esplora: actions/checkout, actions/setup-node, docker/build-push-action, actions/cache, actions/upload-artifact, e molti altri.

Suggerimenti Rapidi

• Posiziona i file del workflow in .github/workflows.
• Usa workflow_dispatch con inputs per esecuzioni manuali e parametriche.
• Usa l’azione cache per accelerare l’installazione delle dipendenze.
• Usa la matrix del job per testare più versioni di OS/runtime.
• Usa i segreti per i dati sensibili, riferiti come ${{ secrets.SECRET_NAME }}.

Questo cheatsheet copre gli aspetti essenziali dell’uso, configurazione ed estensione di GitHub Actions per l’automazione, CI/CD e altro ancora. Per maggiori dettagli e aggiornamenti, consulta sempre la documentazione ufficiale di GitHub e i repository delle azioni.

Azioni GitHub Comuni

Ecco un elenco pratico di GitHub Actions frequentemente utilizzate per automatizzare CI/CD, testing, build, deployment e compiti del flusso di lavoro:

Azioni Ufficiali Principali

Azioni Popolari della Community e di Terze Parti

Azioni per Testing, QA e Reporting

Azioni per Deployment e Notifiche

Utilità e Gestione del Workflow

Come Trovare Altre Azioni

Esistono molte azioni GitHub che abilitano l’automazione del flusso di lavoro, come test automatizzati, deployment in produzione, notifiche e integrazioni con altri servizi. Il GitHub Marketplace elenca migliaia di azioni in categorie come testing, sicurezza, deployment, notifiche, qualità del codice e integrazioni. Elenco curati come “Awesome Actions” sono anche ottimi per ispirazione e scoperta.

Link Utili

• https://docs.github.com/actions
• https://github.com/marketplace
• https://docs.github.com/en/actions/get-started/quickstart
• https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions
• GIT Cheatsheet
• Gitea - installazione e test
• Backup e ripristino server Gitea
• Utilizzo Gitea Actions per distribuire un sito Hugo su AWS S3
• Gitflow: Passaggi, Alternative, Pro e Contro
• DevOps con GitOps - Argo CD, Flux, Jenkins X, Weave GitOps e altri