GitHub Actions-fuskblad – Standardstruktur och en lista över de mest användbara åtgärderna

GitHub Actions är en automatiserings- och CI/CD-plattform inom GitHub, som används för att bygga, testa och distribuera din kod baserat på händelser som pushes, pull requests eller schemalagda tider.

Utöver standard-GitHub kan du använda GitHub Actions i en självärd Gitea-server.

Actions omfattar officiella, community-baserade och tredjepartsverktyg och stödjer automatisering allt från byggprocesser och tester till distribution, versionshantering, QA och notifieringar.

Sammanfattningen täcker GitHub Actions struktur, en kort beskrivning och de vanligaste actions som används i öppna och kommersiella arbetsflöden. Den är en del av [Utvecklarkrav: Den fullständiga guiden till moderna utvecklingsarbetsflöden](https://www.glukhov.org/sv/developer-tools/ “Mastera nödvändiga utvecklarkrav med omfattande guider: Git, Docker, VS Code, bash, Terraform, PostgreSQL, GitHub Actions och Linux-pakethantering. Praktiska felsökningar och arbetsflöden för fullstack-utveckling).

Grundläggande konfigurationsstruktur

GitHub Actions-arbetsflöden definieras i YAML-filer som finns i .github/workflows-katalogen i repositori.

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

• on-blocken anger utlösningshändelser.
• Varje job körs på sin egen runner.
• steps kan köra skalldiktor eller anropa återanvändbara actions.

Huvudkomponenter i arbetsflödet

Utlösningshändelser

• push
• pull_request
• schedule (använder cron-syntax)
• workflow_dispatch (manuell utlösning, tillåter inmatningsparametrar)
• release, issue, etc.

Exempel:

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

Användbara inbyggda Actions

Action-parametrar

Allmänna parametrar för alla action-anrop:

- 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: argument som skickas till actionen (se actionens dokumentation för alla alternativ)
• env: miljövariabler för steget
• if: villkorlig exekvering
• run: skalldiktor (om inte en action används)
• shell: skalldator som används för att köra steget
• continue-on-error: fortsätt även om steget misslyckas

Definiera egna action-inmatningar

I din action-metadata (action.yml):

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

När den används i ett arbetsflöde:

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

Åtkomlig som miljövariabel INPUT_EXAMPLE_INPUT när actionen körs.

Exempel: Arbetsflöde med manuella parametrar

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 }}"

Action Marketplace

• Tusentals återanvändbara actions finns tillgängliga i GitHub Marketplace.
• Kategorier inkluderar: molndistribution, notifieringsverktyg, testramverk, kodanalys och mer.
• Utforska: actions/checkout, actions/setup-node, docker/build-push-action, actions/cache, actions/upload-artifact och många andra.

Snabba tips

• Placera arbetsflödesfiler i .github/workflows.
• Använd workflow_dispatch med inputs för manuella och parametrerade körningar.
• Använd cache-action för att accelerera beroendeinstallationer.
• Använd job matrix för att testa flera OS-/körningstidsversioner.
• Använd hemligheter för känslig data, refererad som ${{ secrets.SECRET_NAME }}.

Denna felsökning täcker grunderna för att använda, konfigurera och utöka GitHub Actions för automatisering, CI/CD och mer. För mer detaljer och uppdateringar, kontrollera alltid den officiella GitHub-dokumentationen och action-repositories.

Vanliga GitHub Actions

Här är en praktisk lista över ofta använda GitHub Actions som hjälper till att automatisera CI/CD, testning, byggprocesser, distribution och arbetsflödesuppgifter:

Huvudofficiella Actions

Populära community- och tredjepartsactions

Testning, QA och rapporteringsactions

Distribution och notifieringsactions

Verktyg och arbetsflödeshantering

Hur man hittar mer

Det finns många GitHub Actions som möjliggör arbetsflödesautomatisering såsom automatisk testning, distribution till produktionsmiljö, notifieringar och integrationer med andra tjänster. GitHub Marketplace listar tusentals actions inom kategorier som testning, säkerhet, distribution, notifieringar, kodkvalitet och integrationer. Kurerade listor som “Awesome Actions” är också utmärkta för inspiration och upptäckt.

Användbara länkar

• 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-felsökning
• Gitea - installation och testning
• Backup och återställning av Gitea-server
• Använd Gitea Actions för att distribuera Hugo-webbplats till AWS S3
• Gitflow: Steg, alternativ, för- och nackdelar
• DevOps med GitOps - Argo CD, Flux, Jenkins X, Weave GitOps och andra