gh workflow run – Declanșarea manuală a unui workflow (workflow_dispatch) în Comenzi GitHub CLI (gh)

gh workflow run deploy.yml
gh workflow run deploy.yml --ref staging -f mediu=productie -f fortare=true

Ce face gh workflow run - Declanșarea manuală a unui workflow (workflow_dispatch)

Pentru a lansa un pipeline manual (cum ar fi un deploy de producție sau o generare de release) fără a face un commit fals, fișierul YAML trebuie să conțină evenimentul `on: workflow_dispatch`.

Comanda gh workflow run <nume.yml> pornește execuția pe GitHub direct din terminal.

Opțiunea -f cheie=valoare permite transmiterea de parametri (inputs) către pașii de execuție, iar --ref stabilește ramura Git utilizată.

Exemple

Exemplul 1: Declanșarea unui deploy de producție cu transmiterea mediului țintă

Lansează pipeline-ul pe branch-ul main cu parametri specifici.

gh workflow run deploy.yml -f mediu=productie -f tag=v2.4.0

Ieșire în terminal

✓ Created workflow_dispatch event for deploy.yml at main

To see runs, try: gh run list --workflow=deploy.yml

Greșeli frecvente

• Încercarea de a rula un workflow care NU conține ‘workflow_dispatch:’ în blocul ‘on:’; GitHub va refuza execuția raportând că fluxul nu poate fi declanșat manual.

Comenzi înrudite

• gh run watch - Monitorizarea în timp real cu streaming a execuției pipeline-ului: Menține terminalul deschis și afișează în timp real progresul fiecărui pas din pipeline până la finalizarea completă.
• gh run list - Listarea execuțiilor recente de pipeline Actions: Afișează istoricul execuțiilor de pipeline cu stare (success, failure, in_progress), eveniment declanșator, branch și durată.
• gh workflow list - Listarea fișierelor de workflow GitHub Actions: Afișează toate pipeline-urile de CI/CD definite în directorul .github/workflows/, starea lor (active/disabled) și ID-ul unic.