GitLab 빠른 조치

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

빠른 조치는 GitLab 사용자 인터페이스에서 일반적으로 버튼이나 드롭다운을 선택하여 수행하는 일반적인 작업에 대한 텍스트 기반 단축키입니다. 이 명령은 이슈, 에픽, 병합 요청 및 커밋의 설명 또는 댓글에 입력할 수 있습니다. 빠른 조치는 새로운 댓글 및 설명과 기존 내용을 편집할 때 실행됩니다.

많은 빠른 조치는 상황에 맞게 적용되며 특정 조건을 필요로 합니다. 예를 들어 /remove_due_date로 이슈가 마감일을 제거하려면 해당 이슈에 마감일이 설정되어 있어야 합니다.

GitLab이 명령을 올바르게 감지하고 실행하려면 각 빠른 조치를 개별 라인에 입력해야 합니다.

매개변수

많은 빠른 조치에는 매개변수가 필요합니다. /assign 빠른 조치와 같이 사용자 이름이 필요한 예제가 있습니다. GitLab은 빠른 조치와 함께 자동 완성 문자를 사용하여 사용자가 가능한 값 목록을 제공함으로써 매개변수 입력을 돕습니다.

매개변수를 수동으로 입력하는 경우에는 이중 인용 부호(")로 둘러싸야 하며, ASCII 문자, 숫자(0-9), 밑줄(_), 하이픈(-), 물음표(?), 마침표(.), 앰퍼샌드(&) 또는 at(@) 문자만 포함된 경우에는 자동으로 인용 부호가 삽입됩니다.

매개변수는 대소문자를 구분합니다. 자동 완성은 이를 처리하고, 인용 부호의 삽입은 자동으로 수행합니다.

이슈, 병합 요청 및 에픽

다음 빠른 조치는 설명, 토론 및 스레드에 적용할 수 있습니다. 일부 빠른 조치는 모든 구독 티어에서 사용할 수 없을 수 있습니다.

명령 이슈 병합 요청 에픽 작업
/add_contacts [contact:email1@example.com] [contact:email2@example.com] Yes No No 적극적인 CRM 연락처 하나 이상 추가하기 (GitLab 14.6에서 도입됨).
/approve No Yes No 병합 요청 승인하기.
/assign @user1 @user2 Yes Yes No 한 명 이상의 사용자 지정하기.
       

작업 항목

  • GitLab 15.10에서 소개된 코멘트를 통한 빠른 조치 실행.

GitLab의 작업 항목에는 작업OKR이 포함됩니다. 작업 항목을 편집하거나 코멘트를 통해 설명 필드에서 다음 빠른 조치를 적용할 수 있습니다.

명령어 작업 목표 주요 결과 작업
/assign @user1 @user2 Yes Yes Yes 하나 이상의 사용자를 할당합니다.
/assign me Yes Yes Yes 자신을 할당합니다.
/add_child <work_item> No Yes No <work_item>에 하위 작업을 추가합니다. <work_item> 값은 #iid, group/project#iid, 또는 작업 항목의 URL 형식이어야 합니다. 여러 작업 항목을 동시에 하위 항목으로 추가할 수 있습니다. GitLab 16.5에서 소개되었습니다.
/award :emoji: Yes Yes Yes 이모지 반응을 토글합니다. GitLab 16.5에서 소개되었습니다.
/cc @user Yes Yes Yes 사용자를 멘션합니다. GitLab 15.0부터 이 명령은 동작하지 않습니다. 대신 CC @user 또는 @user만 입력하세요. 이전 버전의 GitLab 14.9에서 사용자를 언급하면 특정 유형의 할 일 항목 알림이 생성됩니다.
/checkin_reminder <cadence> No Yes No 체크인 알림을 예약합니다. weekly, twice-monthly, monthly, 또는 never (기본값) 중 옵션을 사용할 수 있습니다. GitLab 16.4에서 okrs_mvcokr_checkin_reminders라는 플래그와 함께 소개되었습니다.
/clear_health_status Yes Yes Yes 건강 상태를 지웁니다.
/clear_weight Yes No No 가중치를 지웁니다.
/close Yes Yes Yes 닫습니다.
/confidential Yes Yes Yes 작업 항목을 기밀로 표시합니다. GitLab 16.4에서 소개되었습니다.
/done Yes Yes Yes 할 일 항목을 완료로 표시합니다. GitLab 16.2에서 소개되었습니다.
/due <date> Yes No Yes 마감일을 설정합니다. 유효한 <date> 예시로는 in 2 days, this Friday, December 31st 등이 있습니다.
/health_status <value> Yes Yes Yes 건강 상태를 설정합니다. <value>의 유효한 옵션으로는 on_track, needs_attention, 또는 at_risk 등이 있습니다.
/label ~label1 ~label2 or /labels ~label1 ~label2 Yes Yes Yes 하나 이상의 라벨을 추가합니다. 라벨 이름은 물결(~) 없이도 시작할 수 있지만 혼합 구문은 지원되지 않습니다.
/promote_to <type> Yes No Yes 작업 항목을 지정된 유형으로 승격시킵니다. <type>에 대한 사용 가능한 옵션으로는 issue (작업 승격) 또는 objective (주요 결과 승격)이 있습니다. GitLab 16.1에서 소개되었습니다.
/reassign @user1 @user2 Yes Yes Yes 현재 담당자를 지정된 사용자로 대체합니다.
/relabel ~label1 ~label2 Yes Yes Yes 현재 라벨을 지정된 라벨로 대체합니다.
/remove_due_date Yes No Yes 마감일을 제거합니다.
/remove_child <work_item> No Yes No 하위 <work_item>을 제거합니다. <work_item> 값은 #iid, group/project#iid, 또는 작업 항목의 URL 형식이어야 합니다. GitLab 16.10에서 소개되었습니다.
/remove_parent Yes No Yes 상위 작업 항목을 제거합니다. GitLab 16.9에서 소개되었습니다.
/reopen Yes Yes Yes 다시 엽니다.
/set_parent <work_item> Yes No Yes 상위 작업 항목을 <work_item>으로 설정합니다. <work_item> 값은 #iid, group/project#iid, 또는 작업 항목의 URL 형식이어야 합니다. GitLab 16.5에서 소개되었습니다.
/shrug <comment> Yes Yes Yes 코멘트에 ¯\_(ツ)_/¯를 추가합니다.
/subscribe Yes Yes Yes 알림을 구독합니다. GitLab 16.4에서 소개되었습니다.
/tableflip <comment> Yes Yes Yes 코멘트에 (╯°□°)╯︵ ┻━┻을 추가합니다.
/title <new title> Yes Yes Yes 제목을 변경합니다.
/todo Yes Yes Yes 할 일 항목을 추가합니다. GitLab 16.2에서 소개되었습니다.
/type Yes Yes Yes 작업 항목을 지정된 유형으로 변환합니다. <type>에 대한 사용 가능한 옵션으로는 issue, task, objective, key result 등이 있습니다. GitLab 16.0에서 소개되었습니다.
/unassign @user1 @user2 Yes Yes Yes 특정 담당자를 제거합니다.
/unassign No Yes Yes 모든 담당자를 제거합니다.
/unlabel ~label1 ~label2 or /remove_label ~label1 ~label2 Yes Yes Yes 지정된 라벨을 제거합니다.
/unlabel or /remove_label Yes Yes Yes 모든 라벨을 제거합니다.
/unsubscribe Yes Yes Yes 알림을 구독 해제합니다. GitLab 16.4에서 소개되었습니다.
/weight <value> Yes No No 가중치를 설정합니다. <value>의 유효한 옵션으로는 0, 1, 2 등이 있습니다.

커밋 메시지

다음과 같은 퀵 액션은 커밋 메시지에 적용할 수 있습니다:

명령어 동작
/tag v1.2.3 <message> 선택 사항으로 커밋에 태그를 달아줍니다.

문제 해결

퀵 액션이 실행되지 않음

퀵 액션을 실행했지만 아무 일도 일어나지 않는 경우, 퀵 액션이 자동 완성 상자에 나타나는지 확인하세요. 나타나지 않는 경우, 다음 중 하나일 수 있습니다:

  • 귀하는 구독 티어나 그룹이나 프로젝트에서의 사용자 역할에 따라 퀵 액션과 관련된 기능을 사용할 수 없는 상태일 수 있습니다.
  • 퀵 액션에 필요한 조건을 충족하지 못한 상태일 수 있습니다. 예를 들어, 어떤 라벨이 달리지 않은 이슈에 대해 /unlabel을 실행하고 있는 경우입니다.