로컬 구성 - 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을 커밋하지 마십시오. 프로젝트 정책 구성과 프로젝트 컨벤션 정책은 시행 코드로서 검토한 후에만 커밋하십시오.

​정책 범위 선택

​정책 파라미터 구성

​머신 파일 이해하기

정책 범위 선택

정책 파라미터 구성

머신 파일 이해하기