Passa al contenuto principale

GitHub Runner

Ecco una guida passo-passo per configurare un runner self-hosted di GitHub sulla tua macchina Windows che automaticamente scaricherà le modifiche ed eseguirà il tuo file batch ogni volta che c'è un push sul branch principale:

Step 1: Creare il File di Workflow per GitHub Actions​

  1. Nel tuo repository, crea una directory ".github/workflows" se non esiste già.
  2. Crea un file chiamato auto-pull-build.yml con il seguente contenuto:
    name: Auto Pull and Build

    on:
    push:
        branches: [ main ]  # Cambia questo se usi un branch predefinito diverso

    jobs:
    build:
        runs-on: self-hosted

        steps:
        - name: Pull latest changes
        run: |
            cd ${{ github.workspace }}
            git fetch origin
            git reset --hard origin/main
        
        - name: Run batch file
        run: |
            cd ${{ github.workspace }}
            .\il-tuo-script-da-eseguire

  1. Esegui commit e push di questo file al tuo repository

Step 2: Configurare il Runner Self-hosted sulla Tua Macchina Windows​

  1. Accedi a GitHub e naviga al tuo repository
  2. Vai su Settings → Actions → Runners
  3. Clicca su New self-hosted runner
  4. Seleziona Windows come sistema operativo
  5. Segui i comandi mostrati nella pagina.
  6. Durante la configurazione:
    • Quando ti viene chiesto dei gruppi di runner, premi Invio per l'impostazione predefinita
    • Quando ti viene chiesto del nome del runner, puoi personalizzarlo o premere Invio per l'impostazione predefinita
    • Quando ti viene chiesto delle etichette aggiuntive, puoi aggiungere "windows" o premere Invio
    • Quando ti viene chiesto della cartella di lavoro, premi Invio per l'impostazione predefinita

Step 3: Installare e Avviare il Runner come Servizio​

Dopo aver configurato il runner, installalo come servizio Windows in modo che venga eseguito automaticamente:

# Installa come servizio
./svc.cmd install

# Avvia il servizio
./svc.cmd start

Step 4: Preparare il Repository sulla Macchina Windows​

  1. Se non hai già clonato il tuo repository su questa macchina:
cd C:\percorso\per\la\posizione\desiderata
git clone https://github.com/tuousername/tuo-repository.git

Step 5: Testare la Configurazione​

  1. Apporta una piccola modifica al tuo repository e fai il push sul branch principale
  2. Vai al tuo repository su GitHub → scheda Actions
  3. Dovresti vedere il tuo workflow in esecuzione sul tuo runner self-hosted
  4. Verifica che le modifiche siano state scaricate e il comando eseguito