GitLab 퀵 액션


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

퀵 액션은 일반적으로 GitLab 사용자 인터페이스에서 버튼이나 드롭다운을 선택하여 수행하는 일반적인 작업을 위한 텍스트 기반 단축키입니다. 이러한 명령은 이슈, 에픽, 병합 요청 및 커밋의 설명 또는 주석에 입력할 수 있습니다. 퀵 액션은 새 주석 및 설명뿐 아니라 기존 주석을 편집할 때도 실행됩니다.

많은 퀵 액션은 특정 조건을 충족해야 하는 문맥에 민감합니다. /remove_due_date로 이슈 마감일을 제거하려면 해당 이슈에 마감일이 설정되어 있어야 합니다.

GitLab에서 명령을 올바르게 감지하고 실행하려면 각 퀵 액션을 개별 행에 입력해야 합니다.

Parameters

많은 퀵 액션에는 매개변수가 필요합니다. 예를 들어 /assign 퀵 액션에는 사용자 이름이 필요합니다. GitLab은 퀵 액션과 함께 자동완성 문자을 사용하여 사용자가 매개변수를 입력할 때 가능한 값을 나열하여 매개변수 입력을 돕습니다.

매개변수를 수동으로 입력하는 경우, 이를 큰따옴표(")로 둘러싸야 합니다. 단, 아래 문자만 포함되는 경우는 예외입니다:

  • ASCII 문자
  • 숫자 (0-9)
  • 밑줄(_), 하이픈(-), 물음표(?), 점(.), 앰퍼샌드(&), 또는 at 기호(@)

매개변수는 대소문자를 구분합니다. 자동완성은 이를 처리하고 큰따옴표를 자동으로 삽입합니다.

이슈, 병합 요청 및 에픽

다음 퀵 액션은 설명, 토론 및 스레드에 적용됩니다. 일부 퀵 액션은 모든 구독 계층에서 사용할 수 없을 수 있습니다.

명령어 이슈 병합 요청 에픽 작업
/add_contacts [contact:email1@example.com] [contact:email2@example.com] Yes No No 하나 이상의 활성 CRM 연락처를 추가합니다(GitLab 14.6에서 소개됨).
/add_email email1 email2 Yes No No 최대 여섯 이메일 참가자를 추가합니다. 이 작업은 issue_email_participants 기능 플래그 뒤에 있습니다. 이슈 템플릿에서는 지원되지 않습니다.
/approve No Yes No 병합 요청을 승인합니다.
/assign @user1 @user2 Yes Yes No 한 명 이상의 사용자를 할당합니다.
/assign me Yes Yes No 본인을 할당합니다.
/assign_reviewer @user1 @user2 or /reviewer @user1 @user2 or /request_review @user1 @user2 No Yes No 리뷰어로 한 명 이상의 사용자를 할당합니다.
/assign_reviewer me or /reviewer me or /request_review me No Yes No 리뷰어로 본인을 할당합니다.
/blocked_by <issue1> <issue2> Yes No No 이슈를 다른 이슈에 의해 차단된 것으로 표시합니다. <issue> 값은 #issue, group/project#issue, 또는 전체 이슈 URL의 형식이어야 합니다(GitLab 16.0에서 소개됨).
…        

(이하 생략)

작업 항목

  • 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를 입력할 수 있습니다.
/checkin_reminder <cadence> No Yes No 체크인 알림을 예약합니다. weekly, twice-monthly, monthly, 또는 never (기본값)의 옵션이 있습니다. GitLab 16.4에서 okrs_mvc 및 okr_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 Yes Yes Yes ¯\＿(ツ)＿/¯를 추가합니다.
/subscribe Yes Yes Yes 알림을 구독합니다. GitLab 16.4에서 도입됨.
/tableflip 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을 실행하고 있는 경우입니다.