jfrog-fastci/fastci

CI 병목 현상을 자동으로 식별하고 수정 사항을 생성하는 GitHub Actions용 드롭인 (drop-in) 에이전트입니다. FastCI는 워크플로 (workflows)를 실시간으로 분석하여 성능 문제를 GitHub Issues로 표시하며, 이를 해결하기 위한 풀 리퀘스트 (pull requests)를 자동으로 생성할 수 있습니다.

CI 유지보수는 종종 심각한 병목 현상이 될 때까지 방치되곤 합니다. FastCI는 CI 파이프라인 (pipeline)을 지속적으로 모니터링하고 최적화함으로써 기술 부채 (technical debt)의 축적을 방지하고, 유지보수를 사후 대응 방식에서 사전 예방 방식으로 전환합니다.

옵션 1: AI를 사용하여 FastCI 설치하기

옵션 2: 수동 설치 지침 보기

중요: 이전에 FastCI를 설치한 적이 있다면, 이전 지침은 무시하고 이 업데이트된 단계를 사용하십시오.

저장소 루트에 fastci.config.json 파일을 생성하십시오:

{
"accept_terms": "yes"
}

FastCI는 각 작업 (job)의 가장 첫 번째 단계여야 합니다 - actions/checkout을 포함한 다른 어떤 단계보다 먼저 실행되어야 합니다.

필수 권한: 이 워크플로 (workflow)는 이슈를 생성하기 위해 워크플로 수준에서 issues: write 권한이 필요합니다.

- uses: jfrog-fastci/fastci@v0

permissions:
contents: read
issues: write # FastCI에 필요함
...

작업 (job)이 컨테이너 (container)에서 실행되는 경우, 볼륨 마운트 (volume mount)를 추가하십시오:

permissions:
contents: read
issues: write
...

단계 2.1: FastCI 에이전트 워크플로 추가하기

FastCI가 표시한 문제를 자동으로 수정하려면 .github/workflows/fastci-agent.yaml 경로에 다음 워크플로 (workflow) 파일을 생성하십시오:

name: FastCI Agent ⚡
on:
issues:
...
```$/p' | sed -n '/```/,/```/p' | sed '1d;$d')
[ -z "$AI_PROMPT" ] && AI_PROMPT="$ISSUE_BODY"
echo "$AI_PROMPT" > /tmp/ai_prompt.txt
# Generate branch name
CLEAN_TITLE=$(echo "$ISSUE_TITLE" | sed 's/^[\[FastCI\] ]//' | tr '[:upper:]' '[:lower:]' | tr ' ' '-' | tr -cd 'a-z0-9-' | cut -c1-40)
echo "branch=${ISSUE_NUMBER}-bugfix/${CLEAN_TITLE}" >> $GITHUB_OUTPUT
name: Fix FastCI insight
env:
CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
GH_TOKEN: ${{ secrets.GH_ACCESS_TOKEN }}
BRANCH: ${{ steps.setup.outputs.branch }}
ISSUE_NUM: ${{ github.event.issue.number }}
REPO: ${{ github.repository }}
run: |
agent -p "Fix CI issue in $REPO. GitHub CLI (`gh`) is authenticated.
Issue #$ISSUE_NUM: ${{ github.event.issue.title }}
Task: $(cat /tmp/ai_prompt.txt)
Steps:
1. Create branch: $BRANCH
2. Implement the fix with minimal, targeted changes
3. Commit with message: 'Fix #$ISSUE_NUM: <description>'
4. Push and create PR with body containing 'Fixes #$ISSUE_NUM'
5. Comment on issue #$ISSUE_NUM with PR link
If fix cannot be automated, comment on the issue explaining why."
--force --model composer-1 --output-format=text

Step 2.2: 필요한 Secret 설정

FastCI Agent 워크플로가 작동하려면 리포지토리에서 다음 secret들을 설정해야 합니다:

Secret	설명
CURSOR_API_KEY	Cursor AI 에이전트용 API 키
GH_ACCESS_TOKEN	repo 및 issues 권한을 가진 개인 액세스 토큰 (PR 생성에 필요)

FastCI는 현재 베타 버전입니다. 이 액션을 사용함으로써 FastCI 베타 계약(Beta Agreement)에 동의하는 것입니다. FastCI를 사용하려면, 비-JFrog 조직은 fastci.config.json 파일에 `

권한이 워크플로우 레벨에서 설정됩니다.Beta Agreement (베타 동의): 설정 파일을 통해 Beta Agreement에 동의해야 합니다 (비-JFrog 조직에 필수)

FastCI가 CI 실행을 분석하여 성능 병목 지점을 식별합니다.이슈가 자동으로 생성됩니다fastci-insight 레이블이 붙거나 [FastCI] 접두사가 붙은 이슈가 생성됩니다.FastCI Agent 워크플로우가 트리거됩니다이러한 기준에 부합하는 새로운 이슈가 발생하면 트리거됩니다.AI 에이전트가 수정 사항을 구현합니다그리고 Pull Request (PR)를 생성합니다.PR을 머지하면 이슈가 자동으로 종료됩니다GitHub의 연결 기능을 통해 이슈가 자동으로 종료됩니다

• 저장소 루트에 fastci.config.json 추가
• 워크플로우의 모든 작업(job)에 FastCI 단계 추가
• fastci-agent.yaml 워크플로우 생성
• CURSOR_API_KEY 및 GH_ACCESS_TOKEN Secret 설정
• CI 파이프라인을 실행하고 FastCI 인사이트를 확인하세요!

문제가 발생하면 FastCI 팀에 문의하거나 이 저장소에 이슈를 등록해 주세요.