로컬 설정 - Failproof AI

Failproof AI는 정책 선택과 머신 및 데몬 설정을 분리합니다. 이를 통해 저장소 정책 선택 사항은 검토 가능한 상태로 유지하면서, 자격 증명과 데몬 상태는 저장소 외부에 보관됩니다.

정책 범위 선택

대시보드
CLI

인수 없이 failproofai를 실행하면 로컬 정책 대시보드가 열립니다. 정책을 활성화하기 전에 user, project, 또는 local 범위를 선택하면 변경 사항이 해당 설정 파일에 저장됩니다.

User 범위는 이 머신의 모든 프로젝트에 적용됩니다.
Project 범위는 저장소에 속하며 커밋할 수 있습니다.
Local 범위는 한 명의 사용자에 대해 하나의 프로젝트를 재정의하며, gitignore에 추가해야 합니다.

failproofai policy add block-rm-rf --scope user
failproofai policy add block-force-push --scope project
failproofai policy add warn-large-file-write --scope local
failproofai policies

모든 하네스가 local 범위를 지원하는 것은 아닙니다. CLI는 선택된 하네스가 표현할 수 없는 범위를 거부합니다.

범위	정책 설정 파일
Project	`<project>/.failproofai/policies-config.json`
Local	`<project>/.failproofai/policies-config.local.json`
User	`~/.failproofai/policies-config.json`

활성화된 정책은 합집합으로 병합됩니다. 정책 매개변수는 project → local → user 순서로, 해당 정책의 매개변수를 정의한 첫 번째 범위를 사용합니다. 명시적 커스텀 정책 경로도 이를 정의한 첫 번째 범위를 사용합니다.

정책 매개변수 설정

대시보드
CLI

로컬 대시보드에서 정책을 열고, 지원되는 매개변수를 편집한 후 선택한 범위에 저장합니다. 일치하는 에이전트 액션과 일치하지 않는 에이전트 액션을 각각 실행한 뒤, Observe → policy에서 결정 내용을 확인합니다.

선택한 범위의 policies-config.json을 편집한 후, failproofai policies를 실행하여 알 수 없는 정책 이름이나 매개변수 키를 확인합니다.

{
  "enabledPolicies": ["block-rm-rf", "block-force-push"],
  "policyParams": {
    "block-rm-rf": {
      "allowPaths": ["/tmp/build-output"]
    }
  }
}

failproofai policies

머신 파일 이해하기

~/.failproofai는 신뢰 경계별로 파일을 분리하여 저장합니다:

경로	용도
`config.json`	비밀이 아닌 데몬, 감사, 텔레메트리 설정
`credentials.json`	클라우드 자격 증명; 소유자 전용 권한으로 저장
`policies-config.json`	User 범위 빌트인 선택, 매개변수, 명시적 커스텀 경로
`policies/`	User 규약 정책 및 Cloud 관리 정책 아티팩트
`hook-activity/`	로컬 정책 결정 로그
`state/`	데몬 스풀, 상태 확인, 일시 중지, 런타임 상태

컨테이너 또는 격리된 테스트 환경에서 전체 머신 레이아웃을 재배치하려면 FAILPROOFAI_HOME을 사용하세요. 개별 상태 디렉터리를 독립적으로 재배치하지 마세요.

credentials.json은 절대 커밋하지 마세요. 프로젝트 정책 설정과 프로젝트 규약 정책은 강제 적용 코드로서 검토한 후에만 커밋하세요.

​정책 범위 선택

​정책 매개변수 설정

​머신 파일 이해하기

정책 범위 선택

정책 매개변수 설정

머신 파일 이해하기