GitLab 빠른 작업
빠른 작업은 보통 GitLab 사용자 인터페이스의 버튼이나 드롭다운을 선택하여 수행하는 일반적인 작업을 위한 텍스트 기반 바로 가기입니다. 이러한 명령은 이슈, 에픽, 머지 요청 및 커밋의 설명 또는 코멘트에 입력할 수 있습니다. 빠른 작업은 새로운 코멘트 및 설명을 작성하거나 기존 것을 편집할 때 실행됩니다.
많은 빠른 작업은 해당 조건을 충족해야 하며 context-aware(상황에 맞게)합니다. 예를 들어, /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 | 하나 이상의 사용자를 지정합니다. |
/assign me
| 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 :이모지:
| Yes | Yes | Yes | 이모지 반응을 전환합니다. GitLab 16.5에 도입됨. |
/cc @user
| Yes | Yes | Yes | 사용자를 언급합니다. GitLab 15.0 및 이후의 버전에서 이 명령은 아무 작업을 수행하지 않습니다. 대신 CC @user 또는 @user만 입력하세요. 이전 GitLab 14.9 및 그 이전에 사용자를 새 줄로 시작할 때, 특정 유형의 할 일 알림이 작성됩니다.
|
/checkin_reminder <주기>
| No | Yes | No |
체크인 리마인더를 예약합니다. 주기 옵션은 주간, 월 2회, 매월, 또는 없음(기본값)입니다. 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 <날짜>
| Yes | No | Yes | 마감일을 설정합니다. 유효한 <날짜>의 예시로는 2일 후, 이번 금요일, 12월 31일 등이 있습니다.
|
/health_status <값>
| Yes | Yes | Yes |
건강 상태를 설정합니다. <값>의 유효한 옵션은 정상, 주의 필요, 또는 위험입니다.
|
/label ~label1 ~label2 or /labels ~label1 ~label2
| Yes | Yes | Yes | 하나 이상의 라벨을 추가합니다. 라벨명은 물결(~) 없이도 시작할 수 있지만 혼합 구문은 지원하지 않습니다.
|
/promote_to <유형>
| Yes | No | Yes | 작업 항목을 지정한 유형으로 승급합니다. <유형>으로 사용할 수 있는 옵션은 이슈 (작업 승급) 또는 목표 (핵심 결과 승급)입니다. 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 <새 제목>
| Yes | Yes | Yes | 제목을 변경합니다. |
/todo
| Yes | Yes | Yes | 할 일 항목을 추가합니다. GitLab 16.2에 도입됨. |
/type
| Yes | Yes | Yes | 작업 항목을 지정한 유형으로 변환합니다. <유형>으로 사용할 수 있는 옵션은 이슈, 작업, 목표, 및 핵심 결과입니다. 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 <값>
| Yes | No | No | 가중치를 설정합니다. 유효한 <값>으로는 0, 1, 2가 있습니다.
|
커밋 메시지
다음의 빠른 작업은 커밋 메시지에 적용됩니다:
| 명령어 | 작업 |
|---|---|
/tag v1.2.3 <message>
| 선택 사항인 메시지와 함께 커밋에 태그를 지정합니다. |
문제 해결
빠른 작업이 실행되지 않음
빠른 작업을 실행해도 아무 일도 일어나지 않는 경우, 빠른 작업이 자동완성 상자에 표시되는지 확인하세요. 표시되지 않는다면, 다음 중 하나가 가능성이 있습니다:
- 빠른 작업과 관련된 기능이 구독 등급이나 그룹 또는 프로젝트에서 사용자 역할에 따라 사용 가능하지 않습니다.
- 빠른 작업의 필요 조건이 충족되지 않았습니다.
예를 들어, 어떤 라벨이 없는 이슈에
/unlabel을 실행하고 있습니다.
도움말