GitLab 빠른 조치
빠른 조치는 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_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 <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
을 실행하고 있는 경우입니다.