GitHub Actions

స్టెప్‌ల టెంప్లేట్‌ను ఉపయోగించి మీ Lock Screen పై CI/CD వర్క్‌ఫ్లో పురోగతిని రియల్-టైమ్‌లో ట్రాక్ చేయండి.

How It Works

The pushward-github bridge container polls the GitHub Actions API for in-progress workflow runs and maps workflow progress to Live Activities using the steps template.

1. Idle polling -- checks all configured repos every 60s for in-progress workflows
2. Active tracking -- when a run is detected, polls jobs every 5s and updates progress
3. Cleanup -- after the workflow completes, the activity is cleaned up after a configurable delay (default 15 min)

Setup

1. Get Your Integration Key

మీ డిఫాల్ట్ hlk_ కీని కనుగొనడానికి PushWard యాప్‌ను తెరవండి → Settings → Integration Key.

ఈ ఇంటిగ్రేషన్ కోసం ఒక ప్రత్యేక కీని సృష్టించడానికి:

1. Settings → Manage Keys కు వెళ్లండి
2. + ను నొక్కండి
3. పేరును సెట్ చేయండి (ఉదా. "GitHub Actions"), ఎంచుకోండి , స్కోప్, మరియు ఐచ్ఛికంగా దీనికి పరిమితం చేయండియాక్టివిటీ స్లగ్‌లు
4. రూపొందించబడిన hlk_ కీని కాపీ చేయండి

2. Create a GitHub Personal Access Token

Create a fine-grained PAT with actions:read permission on the repos you want to track.

3. Deploy the Bridge

services:
  pushward-github:
    image: ghcr.io/mac-lucky/pushward-github:latest
    environment:
      PUSHWARD_URL: https://api.pushward.app
      PUSHWARD_API_KEY: hlk_YOUR_INTEGRATION_KEY
      PUSHWARD_GITHUB_TOKEN: ghp_YOUR_GITHUB_TOKEN
      PUSHWARD_GITHUB_OWNER: your-username  # auto-discovers all repos
      # OR specify repos explicitly:
      # PUSHWARD_GITHUB_REPOS: owner/repo1,owner/repo2
    restart: unless-stopped

Configuration

Activity Slug Format

Activities are created with the slug gh-{repo-name} (e.g. gh-pushward-server). One run is tracked per repository at a time.