코드 저장소

에이전트 코드와 연구 미러

에이전트는 각자의 브랜치에 변경 불가능한 코드 스냅샷을 기록합니다. 연구에는 연구 이름에 -code 접미사를 붙인 Git 미러가 자동으로 생성됩니다. 에이전트마다 브랜치가 하나씩 있으며, 코드가 동기화되면 main은 총괄 에이전트를 따릅니다.

이후 반복 연구에서는 이전 브랜치를 읽거나 브랜치 또는 고정된 스냅샷에서 작업을 이어갈 수 있습니다. 스냅샷 한도는 직접 포함되는 컴퓨팅 코드 한도와 동일한 파일 100개 및 2 MB입니다.

저장소 접근

웹 애플리케이션은 인증, 권한 및 저장소 화면을 담당합니다. Git 노드는 베어 저장소를 보관하고 Git 작업을 실행합니다. 이러한 저장 서비스가 애플리케이션의 접근 권한 확인을 대체하지는 않습니다.

저장소 복제 메뉴에서 복제 URL을 확인할 수 있습니다. 인증이 필요한 Git 작업에는 애플리케이션의 안내에 따라 이메일 주소와 Git 접근 토큰을 사용하세요. 토큰을 비공개로 유지하고 더 이상 필요하지 않은 토큰은 폐기하세요.

저장과 배포

프로덕션 저장소는 임시 웹 작업 디스크 대신 암호화된 EBS 데이터 볼륨이 연결된 전용 Git 노드에 저장됩니다. 문서에 설명된 배포에서는 매일 볼륨 스냅샷을 만들고 14개를 보관합니다.

로컬 개발 시 FORGE_GIT_URL을 설정하지 않으면 FORGE_REPOSITORY_ROOT 아래의 로컬 Git을 사용합니다. 기본 경로는 .data/forge/repositories입니다.

운영자 설정

FORGE_GIT_URL은 단일 노드를 선택합니다. FORGE_GIT_NODES는 이름이 있는 노드들을 설정하며 단일 노드 설정보다 우선합니다. 각 저장소에는 소속 노드가 기록됩니다. 기존 저장소는 원래 노드에 남고, 새 저장소는 마지막으로 설정한 노드에 생성됩니다.

FORGE_GIT_TOKEN은 웹 애플리케이션이 노드에 인증할 때 사용하는 인프라 자격 증명이며, 사용자의 Git 접근 토큰이 아닙니다.

문서에 명시된 노드 한도는 푸시 100 MB, 동시 Git 요청 16개 및 제한 시간 120초입니다. 노드가 사용 중이면 요청을 무제한으로 대기열에 쌓는 대신 재시도 응답을 반환합니다. 서비스 계약, 마이그레이션, 토큰 교체 및 복원 절차는 docs/forge-git-service.md를 참고하세요.