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] 예 아니오 아니오 하나 이상의 활성 CRM 연락처를 추가합니다. (GitLab 14.6에서 도입됨).
/add_email email1 email2 예 아니오 아니오 최대 6명의 이메일 참여자를 추가합니다. 이 작업은 기능 플래그 issue_email_participants 뒤에 있습니다. 문제 템플릿에서는 지원되지 않습니다.
/approve 아니오 예 아니오 병합 요청을 승인합니다.
/assign @user1 @user2 예 예 아니오 하나 이상의 사용자를 할당합니다.
/assign me 예 예 아니오 자신을 할당합니다.
/assign_reviewer @user1 @user2 또는 /reviewer @user1 @user2 또는 /request_review @user1 @user2 아니오 예 아니오 하나 이상의 사용자를 리뷰어로 할당합니다.
/assign_reviewer me 또는 /reviewer me 또는 /request_review me 아니오 예 아니오 자신을 리뷰어로 할당합니다.
/blocked_by <issue1> <issue2> 예 아니오 아니오 다른 문제에 의해 차단된 문제로 표시합니다. <issue> 값은 #issue, group/project#issue, 또는 전체 문제 URL 형식이어야 합니다. (GitLab 16.0에서 도입됨).
/blocks <issue1> <issue2> 예 아니오 아니오 다른 문제를 차단하는 문제로 표시합니다. <issue> 값은 #issue, group/project#issue, 또는 전체 문제 URL 형식이어야 합니다. (GitLab 16.0에서 도입됨).
/cc @user 예 예 예 사용자를 언급합니다. 이 명령은 아무 작업도 수행하지 않습니다. 대신 CC @user 또는 단순히 @user를 입력할 수 있습니다.
/child_epic <epic> 아니오 아니오 예 <epic>에 하위 에픽을 추가합니다. <epic> 값은 &epic, group&epic, 또는 에픽에 대한 URL 형식이어야 합니다.
/clear_health_status 예 아니오 아니오 건강 상태를 지웁니다.
/clear_weight 예 아니오 아니오 무게를 지웁니다.
/clone <path/to/project> [--with_notes] 예 아니오 아니오 지정된 프로젝트로 문제를 복제하거나 인수가 없을 경우 현재 프로젝트로 복제합니다. 라벨, 이정표 또는 에픽과 같은 동등한 객체가 있는 경우 가능한 많은 데이터를 복사합니다. --with_notes가 인수로 제공되지 않는 한 댓글이나 시스템 노트는 복사되지 않습니다.
/close 예 예 예 닫습니다.
/confidential 예 아니오 예 문제 또는 에픽을 기밀로 표시합니다. 에픽에 대한 지원은 GitLab 15.6에서 도입됨
/convert_to_ticket <email address> 예 아니오 아니오 문제를 서비스 데스크 티켓으로 변환. GitLab 16.9에서 도입됨
/copy_metadata <!merge_request> 예 예 아니오 프로젝트 내 다른 병합 요청으로부터 라벨 및 이정표를 복사합니다.
/copy_metadata <#issue> 예 예 아니오 프로젝트 내 다른 문제로부터 라벨 및 이정표를 복사합니다.
/create_merge_request <branch name> 예 아니오 아니오 현재 문제에서 시작하여 새로운 병합 요청을 생성합니다.
/done 예 예 예 할 일을 완료로 표시합니다.
/draft 아니오 예 아니오 초안 상태를 설정합니다.
/due <date> 예 아니오 아니오 기한을 설정합니다. 유효한 <date>의 예로는 in 2 days, this Friday, December 31st가 있습니다. Chronic에 대한 더 많은 예를 참고하세요.
/duplicate <#issue> 예 아니오 아니오 이 문제를 닫습니다. <#issue>를 중복 및 관련 문제로 표시합니다.
/epic <epic> 예 아니오 아니오 <epic>에 추가합니다. <epic> 값은 &epic, group&epic, 또는 에픽에 대한 URL 형식이어야 합니다.
/estimate <time> 또는 /estimate_time <time> 예 예 아니오 시간 추정값을 설정합니다. 예: /estimate 1mo 2w 3d 4h 5m. 더 많은 정보는 시간 추적을 참조하세요. 별칭 /estimate_time은 GitLab 15.6에서 도입됨
/health_status <value> 예 아니오 아니오 건강 상태를 설정합니다. <value>의 유효한 옵션은 on_track, needs_attention, at_risk입니다. (GitLab 14.7에서 도입됨)
/iteration *iteration:<iteration ID> 또는 <iteration name> 예 아니오 아니오 반복을 설정합니다. 예를 들어, Late in July 반복을 설정하려면: /iteration *iteration:"Late in July"로 입력합니다.
/iteration [cadence:<iteration cadence ID> 또는 <iteration cadence name>] <--current 또는 --next> 예 아니오 아니오 참조된 반복 주기의 현재 또는 다음 다가오는 반복으로 설정합니다. 예를 들어, /iteration [cadence:"Team cadence"] --current는 Team cadence라는 이름의 반복의 현재 반복으로 설정합니다. GitLab 16.9에서 도입됨.
/iteration <--current 또는 --next> 예 아니오 아니오 그룹에 반복 주기가 하나만 있을 때 현재 또는 다음 다가오는 반복으로 설정합니다. 예를 들어, /iteration --current는 반복 주기의 현재 반복으로 설정합니다. GitLab 16.9에서 도입됨.
/label ~label1 ~label2 또는 /labels ~label1 ~label2 예 예 예 하나 이상의 라벨을 추가합니다. 라벨 이름은 틸드(~) 없이 시작할 수도 있지만 혼합된 구문은 지원되지 않습니다.
/link 예 아니오 아니오 사건의 연결된 리소스에 링크와 설명을 추가합니다. (GitLab 15.5에서 도입됨).
/lock 예 예 아니오 토론을 잠급니다.
/merge 아니오 예 아니오 변경 사항을 병합합니다. 프로젝트 설정에 따라 이는 파이프라인이 성공할 때 수행되거나 병합 기차에 추가하는 작업이 가능합니다.
/milestone %milestone 예 예 아니오 이정표를 설정합니다.
/move <path/to/project> 예 아니오 아니오 이 문제를 다른 프로젝트로 이동합니다. 권한이 다른 프로젝트로 문제를 이동할 때 주의하세요. 문제를 이동하기 전에 민감한 데이터가 포함되어 있지 않은지 확인하세요.
/page <policy name> 예 아니오 아니오 사건의 에스컬레이션을 시작합니다.
/parent_epic <epic> 아니오 아니오 예 <epic>에 부모 에픽을 설정합니다. <epic> 값은 &epic, group&epic, 또는 에픽에 대한 URL 형식이어야 합니다.
/promote_to_incident 예 아니오 아니오 문제를 사건으로 승격합니다. GitLab 15.8 이상에서는 새 문제를 작성할 때도 빠른 작업을 사용할 수 있습니다.
/promote 예 아니오 아니오 문제를 에픽으로 승격합니다.
/publish 예 아니오 아니오 문제를 관련 상태 페이지에 게시합니다.
/react :emoji: 예 예 예 이모지 반응을 전환합니다. GitLab 16.7에서 /award에서 이름이 변경됨. /award는 여전히 별칭 명령어로 사용 가능합니다.
/ready 아니오 예 아니오 준비 상태를 설정합니다. (GitLab 15.1에서 도입됨).
/reassign @user1 @user2 예 예 아니오 현재 할당자를 지정된 사용자로 바꿉니다.
/reassign_reviewer @user1 @user2 아니오 예 아니오 현재 리뷰어를 지정된 사용자로 바꿉니다.
/rebase 아니오 예 아니오 소스 브랜치를 대상 브랜치의 최신 커밋으로 다시 조정합니다. 도움말은 문제 해결 정보를 참조하세요.
/relabel ~label1 ~label2 예 예 예 현재 라벨을 지정된 라벨로 교체합니다.
/relate #issue1 #issue2 예 아니오 아니오 문제를 관련된 문제로 표시합니다.
/remove_child_epic <epic> 아니오 아니오 예 <epic>에서 하위 에픽을 제거합니다. <epic> 값은 &epic, group&epic, 또는 에픽에 대한 URL 형식이어야 합니다.
/remove_contacts [contact:email1@example.com] [contact:email2@example.com] 예 아니오 아니오 하나 이상의 CRM 연락처를 제거합니다.
/remove_due_date 예 아니오 아니오 기한을 제거합니다.
/remove_email email1 email2 예 아니오 아니오 최대 6명의 이메일 참여자를 제거합니다. 이 작업은 기능 플래그 issue_email_participants 뒤에 있습니다. 문제 템플릿, 병합 요청 또는 에픽에서는 지원되지 않습니다.
/remove_epic 예 아니오 아니오 에픽에서 제거합니다.
/remove_estimate 또는 /remove_time_estimate 예 예 아니오 시간 추정값을 제거합니다. 별칭 /remove_time_estimate는 GitLab 15.6에서 도입됨.
/remove_iteration 예 아니오 아니오 반복을 제거합니다.
/remove_milestone 예 예 아니오 이정표를 제거합니다.
/remove_parent_epic 아니오 아니오 예 에픽에서 부모 에픽을 제거합니다.
/remove_time_spent 예 예 아니오 소요 시간을 제거합니다.
/remove_zoom 예 아니오 아니오 이 문제에서 Zoom 회의를 제거합니다.
/reopen 예 예 예 다시 엽니다.
/severity <severity> 예 아니오 아니오 심각도를 설정합니다. 문제 유형은 Incident이어야 합니다. <severity>의 옵션은 S1 … S4, critical, high, medium, low, unknown입니다.
/shrug 예 예 예 ¯\＿(ツ)＿/¯를 추가합니다.
/spend <time> [<date>] 또는 /spend_time <time> [<date>] 예 예 아니오 소요 시간을 추가하거나 뺍니다. 선택적으로, 소요된 날짜를 지정할 수 있습니다. 예: /spend 1mo 2w 3d 4h 5m 2018-08-26 또는 /spend -1h 30m. 더 많은 정보는 시간 추적을 참조하세요. 별칭 /spend_time은 GitLab 15.6에서 도입됨.
/submit_review 아니오 예 아니오 보류 중인 리뷰를 제출합니다.
/subscribe 예 예 예 알림을 구독합니다.
/tableflip 예 예 예 (╯°□°)╯︵ ┻━┻를 추가합니다.
/target_branch <local branch name> 아니오 예 아니오 대상 브랜치를 설정합니다.
/timeline <timeline comment> \| <date(YYYY-MM-DD)> <time(HH:MM)> 예 아니오 아니오 이 사건에 타임라인 이벤트를 추가합니다. 예: /timeline DB load spiked \| 2022-09-07 09:30. (GitLab 15.4에서 도입됨).
/title <new title> 예 예 예 제목을 변경합니다.
/todo 예 예 예 할 일 항목을 추가합니다.
/unapprove 아니오 예 아니오 병합 요청의 승인을 취소합니다.
/unassign @user1 @user2 예 예 아니오 특정 할당자를 제거합니다.
/unassign_reviewer @user1 @user2 또는 /remove_reviewer @user1 @user2 아니오 예 아니오 특정 리뷰어를 제거합니다.
/unassign_reviewer me 아니오 예 아니오 자신을 리뷰어에서 제거합니다.
/unassign_reviewer 또는 /remove_reviewer 아니오 예 아니오 모든 리뷰어를 제거합니다.
/unassign 아니오 예 아니오 모든 할당자를 제거합니다.
/unlabel ~label1 ~label2 또는 /remove_label ~label1 ~label2 예 예 예 지정된 라벨을 제거합니다.
/unlabel 또는 /remove_label 예 예 예 모든 라벨을 제거합니다.
/unlink <issue> 예 아니오 아니오 제공된 문제와의 링크를 제거합니다. <issue> 값은 #issue, group/project#issue, 또는 전체 문제 URL 형식이어야 합니다. (GitLab 16.1에서 도입됨).
/unlock 예 예 아니오 토론을 잠금 해제합니다.
/unsubscribe 예 예 예 알림 구독을 취소합니다.
/weight <value> 예 아니오 아니오 무게를 설정합니다. 유효 값은 정수 0, 1 또는 2입니다.
/zoom <Zoom URL> 예 아니오 아니오 이 문제 또는 사건에 Zoom 회의를 추가합니다. GitLab 15.3 이상 사용자는 사건에 Zoom 링크를 추가할 때 짧은 설명을 추가할 수 있습니다.

작업 항목

  • GitLab 15.10에서 소개된 댓글에서 빠른 작업 실행.

GitLab의 작업 항목에는 작업 및 OKR이 포함됩니다.

작업 항목을 편집하거나 댓글을 달 때 설명 필드를 통해 적용할 수 있는 빠른 작업은 다음과 같습니다.

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

커밋 메시지

다음의 빠른 작업은 커밋 메시지에 적용 가능합니다:

명령 작업
/tag v1.2.3 <message> 선택적 메시지로 커밋에 태그를 추가합니다.

문제 해결

빠른 작업이 실행되지 않음

빠른 작업을 실행했지만 아무 것도 발생하지 않으면, 입력할 때 자동 완성 상자에 빠른 작업이 나타나는지 확인하세요.

그렇지 않다면, 가능한 원인은 다음과 같습니다:

  • 빠른 작업과 관련된 기능이 귀하의 구독 티어 또는 그룹이나 프로젝트에 대한 사용자 역할에 따라 사용 가능하지 않습니다.
  • 빠른 작업을 위한 필수 조건이 충족되지 않았습니다.

예를 들어, 레이블이 없는 이슈에서 /unlabel을 실행하고 있습니다.