Runner self-hosted on-premise

Benvenuti nel mondo dei runner self-hosted. Sono strumenti potenti che consentono di eseguire i workflow di GitHub Actions sulle vostre macchine.

Anziché utilizzare i runner basati sul cloud di GitHub, potete mettere a disposizione il vostro hardware, sistema operativo e ambiente di rete per eseguire i job CI/CD.

Sebbene i runner ospitati da GitHub siano pratici, i runner self-hosted offrono vantaggi specifici:

• Hardware specifico: utilizzare hardware personalizzato, come GPU o architetture CPU specifiche.
• Accesso alla rete: connettersi direttamente a reti private e risorse interne, come database e servizi interni.
• Sicurezza: mantenere gli ambienti di build sensibili all'interno della propria infrastruttura controllata.
• Ottimizzazione dei costi: ridurre potenzialmente i costi per utilizzi intensivi sfruttando l'infrastruttura esistente.

Per configurare un runner self-hosted, la macchina deve soddisfare alcuni requisiti di base:

• Sistema operativo: sono supportati Linux, Windows e macOS.
• Accesso alla rete: la macchina del runner deve poter comunicare con GitHub.com (o GitHub Enterprise Server).
• Risorse: CPU, RAM e spazio su disco sufficienti per gestire i job del workflow.
• Software: tutti gli strumenti o SDK richiesti dai workflow devono essere installati sul runner.

La configurazione di un runner self-hosted prevede alcuni passaggi fondamentali. È come preparare la macchina affinché diventi un worker dedicato per GitHub Actions:

1. Generare un token di registrazione univoco da GitHub.
2. Scaricare ed estrarre l'applicazione del runner sulla macchina.
3. Configurare il runner con l'URL del repository o dell'organizzazione GitHub e il token.
4. Avviare l'applicazione del runner affinché rimanga in ascolto dei job.

Innanzitutto, è necessario comunicare a GitHub che si sta configurando un nuovo runner. A questo scopo serve un token univoco.

Accedere alle impostazioni del repository o dell'organizzazione su GitHub.com:

• Per un repository: Settings > Actions > Runners > New self-hosted runner
• Per un'organizzazione: Settings > Actions > Runners > New self-hosted runner

Seguire le istruzioni per generare un token. Questo token viene utilizzato esclusivamente per la registrazione.

Successivamente, scaricare l'applicazione del runner sulla macchina scelta. L'interfaccia di GitHub fornirà i comandi specifici per il sistema operativo in uso.

Ad esempio, su una macchina Linux, è possibile usare:

Dopo aver estratto i file, configurare il runner. In questo modo lo si collega al repository o all'organizzazione GitHub e si possono impostare le etichette.

Eseguire lo script config.sh (Linux/macOS) oppure config.cmd (Windows). Sarà necessario fornire l'URL GitHub e il token generato in precedenza.

Una volta configurato, è possibile avviare l'applicazione del runner. Questa si collegherà a GitHub e rimarrà in attesa dei job.

Eseguire semplicemente ./run.sh (Linux/macOS) oppure run.cmd (Windows). Negli ambienti di produzione, è consigliabile installare il runner come servizio, in modo che si avvii automaticamente.

Per utilizzare il runner self-hosted, specificarlo nel file YAML del workflow usando la parola chiave runs-on. È possibile usare self-hosted oppure etichette specifiche assegnate durante la configurazione.

I runner self-hosted offrono vantaggi specifici rispetto ai runner ospitati da GitHub. Qual è uno dei principali vantaggi dell'utilizzo di un runner self-hosted?

È stato illustrato il funzionamento dei runner self-hosted. Questi consentono di eseguire i workflow di GitHub Actions sulla propria infrastruttura, offrendo controllo sull'hardware, sull'accesso alla rete e sulla sicurezza.

È stato esaminato il processo di configurazione: generazione di un token, download dell'applicazione, configurazione e avvio del runner. È stato inoltre mostrato come indirizzare i workflow verso runner personalizzati usando runs-on nei file YAML.