문서

명령

한 페이지에서 CoRoid가 사람 없이 수행할 수 있는 작업을 확인하고, 그동안의 수행 내역을 살펴보며 작업을 중단할 수 있습니다.

이것은명령는 사람의 개입 없이 CoRoid가 수행할 수 있는 작업을 지정하는 곳입니다. 이곳은 품질 관리 옆의 탐색 메뉴에 위치하며 두 부분으로 구성됩니다:개요는 현재 설정된 내용을 알려주고,설정는 이를 변경하는 곳입니다.

개요에서 제공하는 정보

개요는 하나의 질문에 답합니다: 사람의 요청 없이 CoRoid가 무엇을 수행하는가?

시작은 한 문장으로 이루어지며, 예컨대 "CoRoid는 자동으로 보안 수정을 시작하며, 백그라운드에서 병합 작업을 학습 중입니다. 그 외 모든 단계는 사용자의 승인을 기다립니다."와 같습니다. 만약 CoRoid가 직접 풀 리퀘스트를 수정하거나 차단한다면 두 번째 줄에 이 내용이 표시됩니다. 그 아래에는 명령이 결정한 네 단계가 작업 순서대로 나열됩니다:

단계의미
작업 시작CoRoid는 사용자가 지정한 목표에 따라 사람이 요청하지 않은 작업을 시작합니다.
병합CoRoid가 pull request를 병합합니다.
배포CoRoid가 환경에 배포합니다.
롤백CoRoid가 실패한 배포를 취소합니다.

각 단계에는 다음 중 하나의 표시가 나타납니다:

  • 사용자에게 요청합니다.권한이 부여되지 않았으므로 사람이 직접 처리합니다.
  • 백그라운드에서 학습 중입니다.권한이 부여되었지만 수행 내용만 기록할 뿐입니다. 단계에는 시작 시점과 지금까지 수행했을 작업이 표시됩니다.
  • 직접 수행합니다.활성 권한이 부여되어 있으며, 단계에는 해당 작업과 알림 방식이 표시됩니다.
  • **CoRoid에 의해 중단되었습니다.**CoRoid가 해당 단계의 권한을 직접 중단했습니다. 이유를 확인하려면 해당 항목을 열어보세요.
  • 보안 수정 전용(작업 시작) CoRoid는 보안 관련 설정에 따라 보안 수정을 시작하며, 그 외 작업은 사람이 처리합니다.

단계의 권한은 설정에서 열거나, 해당 단계를 위한 새 권한을 생성할 수 있습니다.

단계 아래에는 다음과 같은 내용이 있습니다:

  • 항상 사람의 결정이 필요한 사항:보호 경로와 프로젝트 내에서 CoRoid가 열어둔 가장 많은 풀 리퀘스트 수입니다. 보호 경로에 대한 변경은 권한 설정과 관계없이 CoRoid가 병합하거나 배포하지 않습니다.
  • **목표:**CoRoid가 추구하는 방향, 사용 가능한 예산 및 해당 작업의 결과입니다.
  • 프로젝트:일시 중지되었거나 권한이 제한된 프로젝트는 별도의 행으로 표시되며, 나머지 프로젝트는 조직의 설정을 따릅니다.

소유자와 관리자는 개요 상단에서 자율성을 일시 중지할 수 있습니다.

설정하기

  1. 을 열고명령 → 설정에서사전 설정에서 시작또는새 권한을 통해 특정 단계를 설정할 수 있습니다.
  2. 권한은 백그라운드에서 시작되며, 실제 작업 환경에서 일정 시간 동안 실행되게 하세요.
  3. 권한을 열어 수행했을 작업 내용을 확인하세요. 기록 내용이 만족스럽다면 "활성화하기.
  4. Slack이나 Telegram에서 알림을 받으려면CoRoid의 수행 작업의 하위 항목인설정 → 연결 → 알림 경로.

언제든지 권한을 백그라운드로 되돌리거나 자율성을 일시 중지할 수 있습니다.

설정

설정 화면은 조직 정보를 먼저 표시한 뒤 각 프로젝트별로 나열됩니다. 각 행에는 현재 설정된 내용이 표시되며, 해당 항목을 선택하면 사이드 패널에서 편집기が 열립니다. 페이지 내에서 직접 편집되는 것은 없습니다.

그룹행
자율성일시 중지, 보류 및 중단 사항이 포함되며,복구 예비군
권한각 권한은 별도의 행으로 표시되며사전 설정에서 시작및새 권한
목표각 목표는 별도의 행으로 표시되며새 목표
제한 사항보호 경로, 배포 작업, 열린 풀 리퀘스트, 에이전트
이력명령의 변경 사항과 그에 따른 모든 결정 내용

프로젝트 페이지에는 자체 일시 중지 설정, 각 권한의 적용 상황 및 이력이 포함됩니다. 목표와 제한 사항은 조직 수준에서 관리됩니다.

권한

는권한은 사람의 개입 없이 CoRoid가 수행할 수 있는 작업을 의미합니다. 행에는 예컨대 "사람이 요청한 작업 병합"과 같은 이름이 붙으며, 적용 범위가 명시됩니다:

모든 프로젝트에서 낮은 등급으로 분류되며, 하루에 최대 5회만 적용됩니다. 작업 전에 먼저 알림을 보내고 10분간 중단 요청을 기다립니다.

해당 패널에서 단계, 적용 대상, 포함되는 변경의 위험도, 적용 프로젝트, 제한 사항, 제외 경로 및 알림 방식을 각각 편집할 수 있습니다.

배포 권한은 CoRoid이 배포할 릴리스에 포함될 수 있는 병합된 풀 리퀘스트 수를 제한할 수도 있습니다. 더 큰 릴리스는 사람이 직접 배포하도록 두어, 함께 실패할 수 있는 변경 묶음이 사람의 승인 없이 프로덕션에 도달하지 않도록 합니다.

한 개의 권한은 네 단계 중 하나 또는 CoRoid가 풀 요청에서 수행하는 두 가지 작업 중 하나를 담당합니다:

  • **풀 요청을 수정하기.**CoRoid가 자체적으로 작성한 pull request에서 검증이 실패할 경우, CoRoid는 이를 수정하는 절차를 시작합니다. 해당 작업에 대한 권한이 없으면 실패 내용은 리뷰 담당자에게 넘어갑니다. 사용자가 직접 '실패한 검증 수정' 옵션을 선택하면 권한이 필요하지 않습니다.
  • **풀 요청을 차단하기.**CoRoid 리뷰에서 수정이 필요한 문제가 발견되면 변경을 요청하며, 이로 인해 pull request은 사람의 조치를 기다리게 됩니다. 프로젝트에 대한 권한이 없으면 리뷰는 단순한 코멘트로 남고 검증은 실패로 처리되지 않습니다. 차단 권한은 해당 프로젝트 내의 모든 pull request을 대상으로 하며, 누가 생성했든 위험도와 관계없이 적용되지만 권한에서 제외된 경로는 예외입니다.

이 두 가지 기능은 권한으로 지정되기 전부터 이미 CoRoid가 수행하던 작업이었습니다. 각 조직에서는 이를 활성화된 권한으로 설정했으므로 권한으로 지정되어도 달라지는 것은 없습니다. 특정 프로젝트에만 적용하거나 권한을 취소하면 CoRoid는 해당 작업을 중단합니다. 일시 중지도 동일한 효과를 냅니다.

권한의 설정 화면에는 해당 단계에서 요구하는 항목만 표시됩니다. 작업 시작, 수정 및 롤백 여부는 등급 변경 전에 결정되므로 위험 수준이나 제외 경로 설정은 불필요합니다. 차단 권한에는 '누구의 작업인지'라는 개념이 없으며 모든 pull request를 대상으로 합니다.

CoRoid는 더 이상 작업 구현 여부를 묻지 않습니다. 작업 시작 자체가 그 순간의 결정이기 때문입니다. 작업 구현을 위한 권한이 이를 명시하며, 이 권한은 취소할 수 있습니다.

권한은 '그림자 모드'에서 시작됩니다

새로운 권한은 아무것도 허용하지 않습니다.그림자 모드CoRoid는 권한이 허용했을 법한 내용을 기록하므로 이를 신뢰하기 전에 확인할 수 있습니다.활성화하기이렇게 하면 권한이 바로 적용됩니다.

권한의 범위를 확대하는 편집을 하면 활성화된 권한이 다시 그림자 모드로 전환됩니다. 범위를 축소하는 편집은 그렇지 않습니다.

권한이 허용했을 법한 내용

권한을 열어 확인하세요:

  • CoRoid가 해당 권한을 얼마나 자주 요청했는지와 그림자 모드에서 허용했을 내용;
  • 병합을 담당하는 권한의 경우 최근 30일간 해당 유형의 작업으로 병합된 풀 요청 수, 권한이 병합했을 풀 요청 수, 나머지가 병합되지 않은 이유, 그리고 이후에 되돌려지거나 수정되거나 후속 조치가 취해진 병합된 풀 요청 목록;
  • 권한이 활성화되기 전에 충족해야 할 조건.

등급이낮음에는 추가 요건이 없습니다. 규칙에 따라 해당 등급이 부여됩니다. 등급이중간은 모델에 따라 달라지므로 기록이 있어야만 활성화됩니다. 해당 유형의 검토를 거친 풀 리퀘스트가 오판정 승인 없이 최소 30건 있어야 하며, 의도적으로 심은 잘못된 변경 사항이 최소 10건 모두 차단되어야 합니다. 그전까지는 명령에 아직 충족되지 않은 요건이 표시됩니다.

사전 설정에서 시작하기

사전 설정에서 시작하기명령 영역에 여러 권한을 그림자 모드로 채워넣습니다:

사전 설정추가되는 내용
수정목표에 맞춰 작업 시작하기
병합수정 후 등급이 낮음인 경우 해당 작업을 병합하기
배포병합 후 사용자가 지정한 환경에 배포하기
폐쇄 루프배포 후 배포에 실패하면 해당 환경을 롤백하기
종속성 최신 상태 유지낮음 등급의 종속성 업데이트 병합

사전 설정은 권한을 활성화하지 않으며 이미 갖고 있는 권한을 추가하지도 않습니다.

프로젝트에서 권한을 제한할 수 있습니다

조직의 권한은 모든 프로젝트의 기본 설정입니다. 프로젝트 페이지에서 권한을 선택하여 해당 프로젝트에 대해 비활성화하거나 등급을 낮추고, 제한을 줄이거나 제외할 경로를 추가할 수 있습니다. 프로젝트는 조직이 부여한 권한보다 더 많은 권한을 가질 수 없습니다.

CoRoid가 직접 권한을 중단할 때

  • **보류 중.**CoRoid의 리뷰어나 위험 등급 판정 기준이 변경되어 새 기준으로 권한을 평가하지 못한 경우입니다. 평가가 완료되면 권한은 자동으로 다시 활성화됩니다.
  • 중단기 설정에 의해 일시 중지됨.권한이 허용한 병합 건이 동일 프로젝트에서 사람이 직접 병합한 건보다 더 자주 되돌려지거나 수정되거나 후속 조치가 취해졌습니다. 단 한 번의 실패로는 이런 상황이 발생하지 않습니다. 권한은 두 수치를 모두 표시합니다. 사람이 일시 중지를 해제하고 그 이유를 명시합니다.

명령으로 병합할 수 있는 항목

병합 권한이 있는 명령에는 적용 대상 작업자가 명시됩니다. 그래도 해당 명령의 등급 이하로 평가된 변경 사항에만 적용됩니다.

작업권한이 적용되는 범위
사람이 요청한 작업사람이 요청한 작업을 위해 CoRoid가 생성한 pull request
목표에 따른 작업사용자의 목표에 따라 CoRoid가 시작한 작업을 위한 pull request
종속성 업데이트Dependabot 또는 Renovate가 생성한 pull request(GitLab에서는 프로젝트 또는 그룹의 액세스 토큰 봇이renovate/브랜치에서 생성한 풀 요청으로) npm 패키지를 업데이트하는 것으로, 각 패키지는 동일 버전 라인의 패치 또는 마이너 버전이며 최소 7일 전에 게시되었고 새로운 설치 스크립트가 없으며 잠금 파일과 일치함package.json, 그리고 열린 보안 권고 사항이 없습니다. 7일이 지나면 해당 업데이트는 낮은 등급으로 분류됩니다.
신뢰할 수 있는 사람그랜트 이름의 구성원이 만든 pull request로서, 기준점 이후의 모든 커밋이 해당 구성원이 연결한 GitHub 계정으로 작성되고 커밋되었으며 GitHub가 서명을 확인했습니다. GitLab에서는 해당 구성원이 연결한 GitLab 계정으로 병합 요청이 열리며, GitLab이 모든 커밋의 서명과 각 커밋의 작성자 및 커밋ter 이메일이 구성원이 GitLab에서 확인한 것과 일치하는지 확인합니다. 웹 편집기에서 작성된 커밋이나 다른 사람이 푸시한 커밋은 사람의 검토를 기다립니다.

그랜트의 병합 방식

Factory의 병합 계획은 그랜트가 다루는 pull request를 아래에 배치합니다.CoRoid가 지금 병합할 수 있습니다., 그리고 병합 열차가 이를 병합합니다. 병합되는 순간 CoRoid는 다시 명령을 확인하며, 일시 중지, 보류, 사용량 한도 초과 또는 계획 수립 이후 새로 추가된 커밋으로 인해 병합이 중단될 수 있습니다.

병합 커밋에는 그랜트와 그 버전이 명시됩니다. 이 병합은 히스토리와 그랜트의 한도 내에서 그랜트가 책임을 지는 사람에게 귀속됩니다.

배경에서는 병합 계획이 그랜트가 pull request를 병합할 것이라고 명시하며, 최종 결정은 사람이 내립니다.

알림 보내기 및 중지

그랜트는 병합에 대해 어떻게 알려주는지 정의합니다:

  • 먼저 알림을 보낸 뒤 중지를 기다립니다.병합 열차가 풀 요청을 처리하면, 그랜트의 책임자와 작업을 요청한 사람에게 알림이 전송됩니다. 창이 닫히면(예: 10분 후) CoRoid가 병합하지만, 누군가 "중지"를 누르면 예외입니다.중지알림이나 병합 계획에서 또는 연결된 계정을 사용하는 경우 Slack이나 Telegram의 게시물에서 "중지"를 누르면, 중단된 pull request는 사람의 조치를 기다립니다.
  • 각 단계 이후에.병합이 완료되면 알림을 받습니다.

계정 연동하기

신뢰할 수 있는 사람을 위한 그랜트와 CoRoid 승인 기능은 어떤 GitHub 또는 GitLab 계정이 귀하의 계정인지 알아야 합니다. Slack이나 Telegram에서의 중지 기능도 귀하의 Slack 또는 Telegram 계정을 파악해야 합니다.프로필 → 연동된 계정, 각 계정을 연동하면 플랫폼에서 확인해 줍니다. CoRoid는 계정의 ID와 이름만 저장하며 토큰은 저장하지 않습니다. GitLab의 경우 귀하가 확인한 이메일의 다이제스트(실제 이메일이 아님)도 저장하여 커밋이 귀하의 것인지 판단하며, 이메일을 추가하면 다시 연동해야 합니다.연동 해제모든 연동 정보를 제거합니다. 조직에서 자체 관리형 GitLab를 연결한 경우, 소유자나 관리자가 설정하면 해당 GitLab에 대한 항목이 별도로 생성됩니다(귀하의 GitLab에서 사람들의 계정 연동하기).

목표

“목표는 CoRoid가 독립적으로 추진하는 방향, 적용 프로젝트 및 허용 가능한 비용 범위를 나타냅니다. 이전 버전에서는 목표를 명령이라고 불렀습니다;목표에서 이에 대해 상세히 설명합니다.

목표는 CoRoid에 목적과 예산을 부여합니다. 목표가 담당하는 요청은 다음에 설명된 대로 시작됩니다.작업 시작 시점. CoRoid는 목표 하에서 스스로 파일을 처리하며, 결과가 미달된 변경 사항에 대한 후속 조치 등은 활성 그랜트가 필요합니다.작업 시작; 그전까지는 사람이 시작할 때까지 대기합니다. 보안 관련 수정 사항은 예외로 보안 설정에 따라 즉시 시작됩니다.

한도

CoRoid가 그랜트의 허용 여부와 관계없이 절대 수행할 수 없는 작업:

  • 보호된 경로.이 경로에 대한 모든 변경은 사람이 결정합니다. CoRoid는 로그인 및 접근, 청구 및 결제, 비밀번호 및 인증 정보, 암호화, 데이터베이스 마이그레이션, 잠금 파일, CI 파이프라인, 컨테이너 및 인프라를 보호하며 사용자가 직접 경로를 추가할 수도 있습니다. 소유자만 CoRoid가 설정한 경로를 삭제할 수 있으며, 그 사유는 기록됩니다.
  • 배포 작업.그랜트가 수행할 수 있는 최대 작업: 병합, 배포 및 롤백으로, 각각 허용되거나 거부될 수 있습니다.
  • **열린 풀 요청.**CoRoid가 프로젝트에서 열어둔 자체 풀 요청의 수입니다. 한도에 도달하면 CoRoid가 스스로 시작한 작업은 대기하며, 사람이 요청한 작업은 항상 우선됩니다.
  • 에이전트.에이전트의 작업 깊이와 자동화 및 일정에 따른 작업 생성 여부를 제어하며, CoRoid 리뷰가 pull request을 차단할지 여부도 그랜트로 결정됩니다.

히스토리

명령에 대한 모든 변경과 그에 따른 결정 내용이 최신순으로 기록됩니다: 그랜트를 게시하거나 변경한 사람, CoRoid가 허용되거나 거부된 작업 및 그 이유, CoRoid가 질문했을 때 사람들이 한 답변 등입니다.

CoRoid가 귀하에게 요청할 때

일부 작업은 먼저 사람의 답변을 필요로 합니다. 이는당신의 도움이 필요함에서 확인할 수 있으며: Factory에서 CoRoid가 수행하도록 요청받은 작업, 대상 및 이유가 명시됩니다.한 번 승인하면 해당 작업을 한 번 수행할 수 있습니다.거부하면 해당 작업을 수행하지 못하게 됩니다. 다음을 참조하세요Factory.

누가 변경할 수 있나요

소유자와 관리자는 명령을 변경할 수 있습니다. 멤버는 이를 전부 읽을 수 있죠. CoRoid 자체의 에이전트와 서비스 계정은 이를 전혀 변경할 수 없습니다.

권한 부여 하에 내려진 모든 결정 사항은 해당 권한 부여 및 그 버전 정보와 함께 귀사의 감사 스트림에도 기록됩니다. 이는 CoRoid의 기능이기도 합니다.