InfoGrab DocsInfoGrab Docs

프로필 환경 설정

요약

환경 설정을 업데이트해 GitLab의 모양과 느낌을 변경할 수 있습니다. 인터페이스의 색상 모드를 밝게, 어둡게, 또는 기기 환경 설정에 따라 자동으로 업데이트되도록 변경할 수 있습니다. 모양을 변경하려면 다음과 같이 합니다.

환경 설정을 업데이트해 GitLab의 모양과 느낌을 변경할 수 있습니다.

모드 변경#

히스토리
  • GitLab 13.1에서 도입됐습니다.
  • GitLab 17.11에서 실험에서 베타로 변경됐습니다.
  • GitLab 18.1에서 Appearance가 Mode로 변경됐습니다.

인터페이스의 색상 모드를 밝게, 어둡게, 또는 기기 환경 설정에 따라 자동으로 업데이트되도록 변경할 수 있습니다.

모양을 변경하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Mode 섹션에서 옵션을 선택합니다.
  4. Save changes를 선택합니다.

탐색 테마 변경#

히스토리
  • GitLab 18.1에서 Color theme 이 Navigation theme으로 변경됐습니다.
  • GitLab 18.4에서 Light Indigo, Light Blue, Light Green, Light Red 테마가 제거됐습니다.

GitLab UI의 탐색 테마를 변경할 수 있습니다. 이 색상은 왼쪽 사이드바에 표시됩니다. 개별 탐색 테마를 사용하면 서로 다른 GitLab 인스턴스를 구분하는 데 도움이 될 수 있습니다.

탐색 테마를 변경하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Theme 섹션에서 테마를 선택합니다.

구문 강조 테마 변경#

구문 강조는 코드 에디터와 IDE의 기능입니다. 강조 도구는 문자열이나 주석처럼 코드 유형마다 색상을 할당합니다.

구문 강조 테마를 변경하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Syntax highlighting 섹션에서 테마를 선택합니다.
  4. Save changes를 선택합니다.

업데이트된 구문 강조 테마를 보려면 프로젝트 페이지를 새로 고칩니다.

구문 강조 테마를 사용자 지정하려면 애플리케이션 설정 API를 사용할 수도 있습니다. default_syntax_highlighting_theme과 default_dark_syntax_highlighting_theme을 사용해 구문 강조 색상을 더 세밀한 수준에서 변경합니다.

이 단계가 동작하지 않으면 사용하는 프로그래밍 언어가 구문 강조 도구에서 지원되지 않을 수 있습니다. 자세한 내용은 코드 파일과 스니펫에 대한 지침을 다룬 Rouge Ruby Library를 참고합니다. Web IDE에 대한 지침은 Monaco Editor와 Monarch를 참고합니다.

diff 색상 변경#

diff는 코드 버전 간의 변경 사항을 두 가지 배경색으로 표시합니다. 기본적으로 원본 파일은 빨간색이고 변경 사항은 초록색입니다.

diff 색상을 변경하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Diffs 섹션으로 이동합니다.
  4. 색상을 선택하거나 색상 코드를 입력합니다.
  5. Save changes를 선택합니다.

기본 색상으로 되돌리려면 Color for removed lines와 Color for added lines 텍스트 상자를 비우고 Save changes를 선택합니다.

동작#

Behavior 섹션에서 시스템 레이아웃과 기본 보기의 동작을 사용자 지정합니다. 레이아웃 너비를 변경하고 홈페이지, 그룹 개요 페이지, 프로젝트 개요 페이지의 기본 콘텐츠를 선택할 수 있습니다. 공백 렌더링, 파일 표시, 텍스트 자동화처럼 모양과 기능을 사용자 지정하는 옵션도 있습니다.

이 섹션에서 GitLab Duo의 기본 네임스페이스를 설정할 수도 있습니다.

UI의 레이아웃 너비 변경#

GitLab UI의 콘텐츠를 전체 페이지에 맞게 늘릴 수 있습니다. 기본적으로 페이지 콘텐츠는 너비 1280 픽셀로 고정됩니다.

UI의 레이아웃 너비를 변경하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Layout width에서 Fixed 또는 Fluid를 선택합니다.
  5. Save changes를 선택합니다.

기본 텍스트 에디터 설정#

히스토리

기본적으로 모든 신규 사용자는 콘텐츠를 편집할 때 Rich text editor를 봅니다. GitLab에서 콘텐츠를 편집할 때 사용할 기본 에디터를 변경할 수 있습니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Default text editor에서 Enable default text editor 체크박스가 선택되어 있는지 확인합니다.
  5. 기본값으로 Rich text editor 또는 Plain text editor를 선택합니다.
  6. Save changes를 선택합니다.

홈페이지 선택#

히스토리

GitLab 로고([tanuki])를 선택할 때 표시되는 페이지를 제어합니다. 홈페이지를 Personal homepage(기본값), Your Contributed Projects, Your Groups, Your Activity 등의 콘텐츠로 설정할 수 있습니다.

홈페이지 보기를 선택하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Homepage 드롭다운 목록에서 옵션을 선택합니다.
  5. Save changes를 선택합니다.

그룹 개요 페이지의 기본 콘텐츠 사용자 지정#

그룹 개요 페이지의 주요 콘텐츠를 변경할 수 있습니다. 그룹 개요 페이지는 왼쪽 사이드바에서 Groups를 선택할 때 표시되는 페이지입니다. 그룹 개요 페이지의 기본 콘텐츠를 다음으로 지정할 수 있습니다.

  • Details Dashboard(기본값). 그룹 활동과 프로젝트 개요를 포함합니다.
  • Security Dashboard. 그룹 보안 정책과 그 밖의 보안 주제를 포함할 수 있습니다.

자세한 내용은 그룹을 참고합니다.

그룹 개요 페이지의 기본 콘텐츠를 변경하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Group overview content 드롭다운 목록에서 옵션을 선택합니다.
  5. Save changes를 선택합니다.

프로젝트 개요 페이지의 기본 콘텐츠 사용자 지정#

프로젝트 개요 페이지는 왼쪽 사이드바에서 Project overview를 선택할 때 표시되는 페이지입니다. 주 프로젝트 개요 페이지를 Activity 페이지, README 파일 등의 콘텐츠로 설정할 수 있습니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Project overview content 드롭다운 목록에서 옵션을 선택합니다.
  5. Save changes를 선택합니다.

기본 GitLab Duo 네임스페이스 설정#

히스토리
  • GitLab 18.3에서 ai_user_default_duo_namespace라는 플래그와 함께 도입됐습니다. 기본적으로 비활성화됩니다.
  • GitLab 18.4에서 활성화됐습니다.
  • GitLab 18.7에서 ai_user_default_duo_namespace 기능 플래그가 제거됐습니다.

프로젝트에서 GitLab Duo를 사용할 수 있도록 기본 GitLab Duo 네임스페이스를 설정합니다. 기본 GitLab Duo 네임스페이스는 사용할 수 있는 AI 모델과 GitLab Duo 기능, 그리고 GitLab Credits 소비량을 결정합니다.

기본 GitLab Duo 네임스페이스는 다음 상황에서 기능 사용 가능 여부와 크레딧 소비를 결정합니다.

  • 작업 중인 프로젝트의 멤버가 아닌 경우.
  • 여러 GitLab Duo 네임스페이스에 속한 경우.
  • GitLab 리모트가 구성되지 않은 프로젝트로 IDE에서 작업하는 경우.
  • CLI에서 GitLab Duo를 사용하는 경우.

직접 멤버이거나 상속된 멤버인 프로젝트나 그룹에서 작업하면, 기능 사용 가능 여부와 크레딧 소비에 해당 프로젝트나 그룹의 최상위 그룹이 대신 사용됩니다.

  • 멤버로 속한 프로젝트에서 GitLab Duo 기능을 사용하면 사용량이 해당 프로젝트의 최상위 그룹에 청구됩니다.
  • 프로젝트 밖에서 GitLab Duo 기능을 사용하면(예를 들어 프로젝트를 열지 않은 IDE 나 CLI) 사용량이 기본 네임스페이스에 청구됩니다.
  • 멤버가 아닌 프로젝트에서 GitLab Duo 기능을 사용하면 사용량이 기본 네임스페이스에 청구됩니다.

기본 네임스페이스를 설정하지 않으면 GitLab Duo Agentic Chat과 GitLab Duo Agent Platform 이 비활성화됩니다.

기본 GitLab Duo 네임스페이스를 설정하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Default GitLab Duo group 드롭다운 목록에서 기본값으로 설정할 그룹을 선택합니다.
  5. Save changes를 선택합니다.

로컬 환경에서의 네임스페이스 확인#

히스토리
  • GitLab 18.10에서 IDE의 사용자 기본 네임스페이스 액세스가 도입됐습니다.
  • GitLab for VS Code 6.71.7에서 사용자 기본 네임스페이스 액세스가 도입됐습니다.
  • GitLab Duo CLI 8.76.0에서 사용자 기본 네임스페이스 액세스가 도입됐습니다.
  • GitLab 19.4에서 에디터 확장의 기본 네임스페이스 설정이 제거됐습니다.
  • JetBrains IDE 용 GitLab Duo 플러그인 3.46.0에서 제거됐습니다.
  • GitLab for VS Code 6.90.0에서 제거됐습니다.

IDE 나 CLI에서 GitLab Duo를 사용하면 가장 먼저 사용할 수 있는 네임스페이스가 기능 사용 가능 여부와 크레딧 소비를 결정합니다. 다른 Agent Platform 요구 사항과 함께, 작업하는 프로젝트는 그룹 네임스페이스에 있어야 합니다.

GitLab Duo는 다음 순서로 네임스페이스를 확인합니다.

  1. 프로젝트가 GitLab의 원격 리포지터리에 연결된 경우 프로젝트 네임스페이스.
  2. 사용자 환경 설정에 지정된 기본 네임스페이스.

가장 먼저 식별된 네임스페이스에 요청한 기능에 대한 액세스 권한이나 사용 가능한 크레딧이 없으면 그 기능을 사용할 수 없습니다. GitLab Duo는 목록의 다음 네임스페이스로 폴백하지 않습니다.

프로젝트가 GitLab의 원격 리포지터리에 연결되지 않았다면 사용자 환경 설정에서 기본 GitLab Duo 네임스페이스를 설정해야 합니다.

단축키 버튼 숨기기#

단축키 버튼은 프로젝트 개요 페이지에서 파일 목록 앞에 표시됩니다. 이 버튼은 README 파일이나 라이선스 계약처럼 프로젝트의 일부로 이동하는 링크를 제공합니다.

프로젝트 개요 페이지에서 단축키 버튼을 숨기려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Show shortcut buttons above files on project overview 체크박스를 선택 해제합니다.
  5. Save changes를 선택합니다.

Web IDE에서 공백 문자 표시#

공백 문자는 공백이나 들여쓰기처럼 텍스트에서 비어 있는 모든 문자입니다. 코드에서 콘텐츠를 구조화하는 데 공백을 사용할 수 있습니다. 사용하는 프로그래밍 언어가 공백에 민감하다면 Web IDE가 공백 변경을 감지할 수 있습니다.

Web IDE에서 공백을 렌더링하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Render whitespace characters in the Web IDE 체크박스를 선택합니다.
  5. Save changes를 선택합니다.

diff에서 공백 변경 사항을 볼 수 있습니다.

Web IDE에서 diff를 보려면 다음 단계를 따릅니다.

  1. 왼쪽 사이드바에서 Source Control ([branch])을 선택합니다.
  2. Changes 탭에서 파일을 선택합니다.

diff에서 공백 변경 사항 표시#

diff 파일에서 공백 변경 사항을 봅니다. 공백에 대한 자세한 내용은 앞의 작업을 참고합니다.

diff에서 공백 변경 사항을 보려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Show whitespace changes in diffs 체크박스를 선택합니다.
  5. Save changes를 선택합니다.

diff에 대한 자세한 내용은 diff 색상 변경을 참고합니다.

머지 리퀘스트에서 페이지당 한 파일 표시#

Changes 탭에서는 머지 리퀘스트의 모든 파일 변경 사항을 한 페이지에서 볼 수 있습니다. 대신 한 번에 한 파일씩 보도록 선택할 수 있습니다.

Changes 탭에서 페이지당 한 파일을 표시하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Show one file at a time on merge request's Changes tab 체크박스를 선택합니다.
  5. Save changes를 선택합니다.

그다음 Changes 탭에서 파일 사이를 이동하려면 각 파일 아래의 Previous와 Next 버튼을 선택합니다.

문자 자동 묶기#

여는 문자를 입력하면 해당하는 닫는 문자를 텍스트에 자동으로 추가합니다. 예를 들어 여는 대괄호를 입력하면 닫는 대괄호를 자동으로 삽입할 수 있습니다. 이 설정은 설명과 댓글 상자에서만, 그리고 다음 문자에 대해서만 동작합니다: **", ', ```, (, [, {, <, *, _**.

설명과 댓글 상자에서 문자를 자동으로 묶으려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Surround text selection when typing quotes or brackets 체크박스를 선택합니다.
  5. Save changes를 선택합니다.

이제 설명이나 댓글 상자에서 단어를 입력하고 강조 표시한 다음 여는 문자를 입력할 수 있습니다. 텍스트가 대체되는 대신 닫는 문자가 끝에 추가됩니다.

새 목록 항목 자동화#

설명과 댓글 상자의 목록에서 Enter를 누르면 새 목록 항목을 만듭니다.

Enter 키를 누를 때 새 목록 항목을 추가하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Automatically add new list items 체크박스를 선택합니다.
  5. Save changes를 선택합니다.

이모지 자동 완성 끄기#

기본적으로 설명이나 댓글 상자에 콜론(:)을 입력하면 GitLab 이 일치하는 이모지를 제안합니다. 콜론 앞에 공백을 두는 언어처럼 다른 이유로 콜론을 입력한다면 이 제안을 끌 수 있습니다. 끈 뒤에도 복사해 붙여넣기 같은 다른 방법으로 이모지를 삽입할 수 있습니다.

이모지 자동 완성을 끄려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Enable emoji autocomplete 체크박스를 선택 해제합니다.
  5. Save changes를 선택합니다.

커서 들여쓰기 유지#

Enter를 누를 때 들여쓰기를 유지합니다. 새 줄의 커서는 이전 줄과 동일하게 자동으로 들여쓰기됩니다. 이 설정은 설명과 댓글 상자에서만 동작합니다.

Enter 키를 누를 때 새 목록 항목을 추가하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Maintain cursor indentation 체크박스를 선택합니다.
  5. Save changes를 선택합니다.

탭 너비 변경#

diff, blob, 스니펫에서 탭의 기본 크기를 변경합니다. Web IDE, 파일 에디터, Markdown 에디터는 이 기능을 지원하지 않습니다.

기본 탭 너비를 조정하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Tab width에 값을 입력합니다.
  5. Save changes를 선택합니다.

현지화#

언어, 캘린더 시작 요일, 시간 환경 설정 같은 현지화 설정을 변경합니다.

GitLab UI에서 표시 언어 변경#

GitLab은 UI에서 여러 언어를 지원합니다.

GitLab UI의 언어를 선택하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Localization 섹션으로 이동합니다.
  4. Language에서 옵션을 선택합니다.
  5. Save changes를 선택합니다.

업데이트된 언어를 보려면 페이지를 새로 고쳐야 할 수 있습니다.

기여 캘린더 시작 요일 사용자 지정#

기여 캘린더가 어느 요일부터 시작할지 선택합니다. 기여 캘린더는 지난 1 년간의 프로젝트 기여를 보여 줍니다. 이 캘린더는 각 사용자 프로필에서 볼 수 있습니다. 사용자 프로필에 접근하려면 다음과 같이 합니다.

  • 오른쪽 상단에서 아바타를 선택하고 이름이나 사용자 이름을 선택합니다.

기여 캘린더 시작 요일을 변경하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Localization 섹션으로 이동합니다.
  4. First day of the week에서 옵션을 선택합니다.
  5. Save changes를 선택합니다.

캘린더 시작 요일을 변경한 뒤에는 사용자 프로필 페이지를 새로 고칩니다.

상대 시간 대신 정확한 시간 표시#

그룹 및 프로젝트 개요 페이지와 사용자 프로필에서 활동 시간을 표시하는 형식을 사용자 지정합니다. 시간은 다음 형식으로 표시할 수 있습니다.

  • 상대 형식. 예를 들어 30 minutes ago.
  • 절대 형식. 예를 들어 September 3, 2022, 3:57 PM.

GitLab UI에서 정확한 시간을 사용하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Time preferences 섹션으로 이동합니다.
  4. Use relative times 체크박스를 선택 해제합니다.
  5. Save changes를 선택합니다.

시간 형식 사용자 지정#

그룹 및 프로젝트 개요 페이지와 사용자 프로필에서 활동 시간을 표시하는 형식을 사용자 지정할 수 있습니다. 시간은 다음과 같이 표시할 수 있습니다.

  • 12 시간 형식. 예를 들어 2:34 PM.
  • 24 시간 형식. 예를 들어 14:34.

시스템 설정을 따를 수도 있습니다.

시간 형식을 사용자 지정하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Time preferences 섹션으로 이동합니다.
  4. Time format에서 System, 12-hour, 24-hour 옵션 중 하나를 선택합니다.
  5. Save changes를 선택합니다.

CI job JSON 웹 토큰의 사용자 ID#

CI/CD job은 외부 ID 목록을 포함할 수 있는 JSON 웹 토큰을 생성합니다. 개별 계정을 가져오기 위해 별도의 API를 호출하는 대신, 인증 토큰 하나에서 사용자 ID를 확인할 수 있습니다.

외부 ID는 기본적으로 포함되지 않습니다. 외부 ID를 포함하도록 활성화하려면 토큰 페이로드를 참고합니다.

팔로워 참여 제어#

다른 GitLab 사용자를 팔로우하거나 다른 사용자에게 팔로우되는 기능을 끕니다. 기본적으로 이름과 프로필 사진을 포함한 사용자 프로필은 다른 사용자의 Following 탭에서 공개됩니다. 이 설정을 비활성화하면 다음과 같이 동작합니다.

  • GitLab 이 모든 팔로워와 팔로우 연결을 삭제합니다.
  • GitLab 이 각 연결의 페이지에서 사용자 프로필을 자동으로 제거합니다.

다른 사용자에게 팔로우되는 기능과 다른 사용자를 팔로우하는 기능을 제거하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Enable follow users 체크박스를 선택 해제합니다.
  4. Save changes를 선택합니다.

Followers와 Following 탭에 접근하려면 다음과 같이 합니다.

  • 오른쪽 상단에서 아바타를 선택합니다.
  • Followers 또는 Following을 선택합니다.

GitLab 인스턴스와 타사 서비스 통합#

GitLab 사용 경험을 향상하도록 타사 서비스에 액세스 권한을 부여합니다.

GitLab 인스턴스와 Ona 통합#

GitLab 브라우저에서 코드를 직접 실행하고 관리하려면 GitLab 인스턴스를 Ona와 함께 구성합니다. Ona는 프로젝트의 개발 환경을 자동으로 준비하고 빌드합니다.

Ona와 통합하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Integrations 섹션을 찾습니다.
  4. Enable Ona integration 체크박스를 선택합니다.
  5. Save changes를 선택합니다.

GitLab 인스턴스와 Sourcegraph 통합#

GitLab은 GitLab의 모든 공개 프로젝트에 대해 Sourcegraph 통합을 지원합니다.

Sourcegraph와 통합하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Integrations 섹션을 찾습니다.
  4. Enable integrated code intelligence on code views 체크박스를 선택합니다.
  5. Save changes를 선택합니다.

GitLab을 Sourcegraph와 함께 구성하려면 GitLab 인스턴스의 관리자여야 합니다.

확장 마켓플레이스와 통합#

히스토리

VS Code Extension Marketplace는 Web IDE와 워크스페이스의 기능을 확장하는 확장을 제공합니다.

사전 요구 사항:

Extension Marketplace와 통합하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Integrations 섹션으로 이동합니다.
  4. Enable extension marketplace 체크박스를 선택합니다.
  5. 타사 확장 동의 안내에서 I understand를 선택합니다.
  6. Save changes를 선택합니다.

프로필 환경 설정

GitLab v19.5
Tier: Free, Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기

요약

환경 설정을 업데이트해 GitLab의 모양과 느낌을 변경할 수 있습니다. 인터페이스의 색상 모드를 밝게, 어둡게, 또는 기기 환경 설정에 따라 자동으로 업데이트되도록 변경할 수 있습니다. 모양을 변경하려면 다음과 같이 합니다.

환경 설정을 업데이트해 GitLab의 모양과 느낌을 변경할 수 있습니다.

모드 변경#

히스토리
  • GitLab 13.1에서 도입됐습니다.
  • GitLab 17.11에서 실험에서 베타로 변경됐습니다.
  • GitLab 18.1에서 Appearance가 Mode로 변경됐습니다.

인터페이스의 색상 모드를 밝게, 어둡게, 또는 기기 환경 설정에 따라 자동으로 업데이트되도록 변경할 수 있습니다.

모양을 변경하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Mode 섹션에서 옵션을 선택합니다.
  4. Save changes를 선택합니다.

탐색 테마 변경#

히스토리
  • GitLab 18.1에서 Color theme 이 Navigation theme으로 변경됐습니다.
  • GitLab 18.4에서 Light Indigo, Light Blue, Light Green, Light Red 테마가 제거됐습니다.

GitLab UI의 탐색 테마를 변경할 수 있습니다. 이 색상은 왼쪽 사이드바에 표시됩니다. 개별 탐색 테마를 사용하면 서로 다른 GitLab 인스턴스를 구분하는 데 도움이 될 수 있습니다.

탐색 테마를 변경하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Theme 섹션에서 테마를 선택합니다.

구문 강조 테마 변경#

구문 강조는 코드 에디터와 IDE의 기능입니다. 강조 도구는 문자열이나 주석처럼 코드 유형마다 색상을 할당합니다.

구문 강조 테마를 변경하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Syntax highlighting 섹션에서 테마를 선택합니다.
  4. Save changes를 선택합니다.

업데이트된 구문 강조 테마를 보려면 프로젝트 페이지를 새로 고칩니다.

구문 강조 테마를 사용자 지정하려면 애플리케이션 설정 API를 사용할 수도 있습니다. default_syntax_highlighting_theme과 default_dark_syntax_highlighting_theme을 사용해 구문 강조 색상을 더 세밀한 수준에서 변경합니다.

이 단계가 동작하지 않으면 사용하는 프로그래밍 언어가 구문 강조 도구에서 지원되지 않을 수 있습니다. 자세한 내용은 코드 파일과 스니펫에 대한 지침을 다룬 Rouge Ruby Library를 참고합니다. Web IDE에 대한 지침은 Monaco Editor와 Monarch를 참고합니다.

diff 색상 변경#

diff는 코드 버전 간의 변경 사항을 두 가지 배경색으로 표시합니다. 기본적으로 원본 파일은 빨간색이고 변경 사항은 초록색입니다.

diff 색상을 변경하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Diffs 섹션으로 이동합니다.
  4. 색상을 선택하거나 색상 코드를 입력합니다.
  5. Save changes를 선택합니다.

기본 색상으로 되돌리려면 Color for removed lines와 Color for added lines 텍스트 상자를 비우고 Save changes를 선택합니다.

동작#

Behavior 섹션에서 시스템 레이아웃과 기본 보기의 동작을 사용자 지정합니다. 레이아웃 너비를 변경하고 홈페이지, 그룹 개요 페이지, 프로젝트 개요 페이지의 기본 콘텐츠를 선택할 수 있습니다. 공백 렌더링, 파일 표시, 텍스트 자동화처럼 모양과 기능을 사용자 지정하는 옵션도 있습니다.

이 섹션에서 GitLab Duo의 기본 네임스페이스를 설정할 수도 있습니다.

UI의 레이아웃 너비 변경#

GitLab UI의 콘텐츠를 전체 페이지에 맞게 늘릴 수 있습니다. 기본적으로 페이지 콘텐츠는 너비 1280 픽셀로 고정됩니다.

UI의 레이아웃 너비를 변경하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Layout width에서 Fixed 또는 Fluid를 선택합니다.
  5. Save changes를 선택합니다.

기본 텍스트 에디터 설정#

히스토리

기본적으로 모든 신규 사용자는 콘텐츠를 편집할 때 Rich text editor를 봅니다. GitLab에서 콘텐츠를 편집할 때 사용할 기본 에디터를 변경할 수 있습니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Default text editor에서 Enable default text editor 체크박스가 선택되어 있는지 확인합니다.
  5. 기본값으로 Rich text editor 또는 Plain text editor를 선택합니다.
  6. Save changes를 선택합니다.

홈페이지 선택#

히스토리

GitLab 로고([tanuki])를 선택할 때 표시되는 페이지를 제어합니다. 홈페이지를 Personal homepage(기본값), Your Contributed Projects, Your Groups, Your Activity 등의 콘텐츠로 설정할 수 있습니다.

홈페이지 보기를 선택하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Homepage 드롭다운 목록에서 옵션을 선택합니다.
  5. Save changes를 선택합니다.

그룹 개요 페이지의 기본 콘텐츠 사용자 지정#

그룹 개요 페이지의 주요 콘텐츠를 변경할 수 있습니다. 그룹 개요 페이지는 왼쪽 사이드바에서 Groups를 선택할 때 표시되는 페이지입니다. 그룹 개요 페이지의 기본 콘텐츠를 다음으로 지정할 수 있습니다.

  • Details Dashboard(기본값). 그룹 활동과 프로젝트 개요를 포함합니다.
  • Security Dashboard. 그룹 보안 정책과 그 밖의 보안 주제를 포함할 수 있습니다.

자세한 내용은 그룹을 참고합니다.

그룹 개요 페이지의 기본 콘텐츠를 변경하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Group overview content 드롭다운 목록에서 옵션을 선택합니다.
  5. Save changes를 선택합니다.

프로젝트 개요 페이지의 기본 콘텐츠 사용자 지정#

프로젝트 개요 페이지는 왼쪽 사이드바에서 Project overview를 선택할 때 표시되는 페이지입니다. 주 프로젝트 개요 페이지를 Activity 페이지, README 파일 등의 콘텐츠로 설정할 수 있습니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Project overview content 드롭다운 목록에서 옵션을 선택합니다.
  5. Save changes를 선택합니다.

기본 GitLab Duo 네임스페이스 설정#

히스토리
  • GitLab 18.3에서 ai_user_default_duo_namespace라는 플래그와 함께 도입됐습니다. 기본적으로 비활성화됩니다.
  • GitLab 18.4에서 활성화됐습니다.
  • GitLab 18.7에서 ai_user_default_duo_namespace 기능 플래그가 제거됐습니다.

프로젝트에서 GitLab Duo를 사용할 수 있도록 기본 GitLab Duo 네임스페이스를 설정합니다. 기본 GitLab Duo 네임스페이스는 사용할 수 있는 AI 모델과 GitLab Duo 기능, 그리고 GitLab Credits 소비량을 결정합니다.

기본 GitLab Duo 네임스페이스는 다음 상황에서 기능 사용 가능 여부와 크레딧 소비를 결정합니다.

  • 작업 중인 프로젝트의 멤버가 아닌 경우.
  • 여러 GitLab Duo 네임스페이스에 속한 경우.
  • GitLab 리모트가 구성되지 않은 프로젝트로 IDE에서 작업하는 경우.
  • CLI에서 GitLab Duo를 사용하는 경우.

직접 멤버이거나 상속된 멤버인 프로젝트나 그룹에서 작업하면, 기능 사용 가능 여부와 크레딧 소비에 해당 프로젝트나 그룹의 최상위 그룹이 대신 사용됩니다.

  • 멤버로 속한 프로젝트에서 GitLab Duo 기능을 사용하면 사용량이 해당 프로젝트의 최상위 그룹에 청구됩니다.
  • 프로젝트 밖에서 GitLab Duo 기능을 사용하면(예를 들어 프로젝트를 열지 않은 IDE 나 CLI) 사용량이 기본 네임스페이스에 청구됩니다.
  • 멤버가 아닌 프로젝트에서 GitLab Duo 기능을 사용하면 사용량이 기본 네임스페이스에 청구됩니다.

기본 네임스페이스를 설정하지 않으면 GitLab Duo Agentic Chat과 GitLab Duo Agent Platform 이 비활성화됩니다.

기본 GitLab Duo 네임스페이스를 설정하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Default GitLab Duo group 드롭다운 목록에서 기본값으로 설정할 그룹을 선택합니다.
  5. Save changes를 선택합니다.

로컬 환경에서의 네임스페이스 확인#

히스토리
  • GitLab 18.10에서 IDE의 사용자 기본 네임스페이스 액세스가 도입됐습니다.
  • GitLab for VS Code 6.71.7에서 사용자 기본 네임스페이스 액세스가 도입됐습니다.
  • GitLab Duo CLI 8.76.0에서 사용자 기본 네임스페이스 액세스가 도입됐습니다.
  • GitLab 19.4에서 에디터 확장의 기본 네임스페이스 설정이 제거됐습니다.
  • JetBrains IDE 용 GitLab Duo 플러그인 3.46.0에서 제거됐습니다.
  • GitLab for VS Code 6.90.0에서 제거됐습니다.

IDE 나 CLI에서 GitLab Duo를 사용하면 가장 먼저 사용할 수 있는 네임스페이스가 기능 사용 가능 여부와 크레딧 소비를 결정합니다. 다른 Agent Platform 요구 사항과 함께, 작업하는 프로젝트는 그룹 네임스페이스에 있어야 합니다.

GitLab Duo는 다음 순서로 네임스페이스를 확인합니다.

  1. 프로젝트가 GitLab의 원격 리포지터리에 연결된 경우 프로젝트 네임스페이스.
  2. 사용자 환경 설정에 지정된 기본 네임스페이스.

가장 먼저 식별된 네임스페이스에 요청한 기능에 대한 액세스 권한이나 사용 가능한 크레딧이 없으면 그 기능을 사용할 수 없습니다. GitLab Duo는 목록의 다음 네임스페이스로 폴백하지 않습니다.

프로젝트가 GitLab의 원격 리포지터리에 연결되지 않았다면 사용자 환경 설정에서 기본 GitLab Duo 네임스페이스를 설정해야 합니다.

단축키 버튼 숨기기#

단축키 버튼은 프로젝트 개요 페이지에서 파일 목록 앞에 표시됩니다. 이 버튼은 README 파일이나 라이선스 계약처럼 프로젝트의 일부로 이동하는 링크를 제공합니다.

프로젝트 개요 페이지에서 단축키 버튼을 숨기려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Show shortcut buttons above files on project overview 체크박스를 선택 해제합니다.
  5. Save changes를 선택합니다.

Web IDE에서 공백 문자 표시#

공백 문자는 공백이나 들여쓰기처럼 텍스트에서 비어 있는 모든 문자입니다. 코드에서 콘텐츠를 구조화하는 데 공백을 사용할 수 있습니다. 사용하는 프로그래밍 언어가 공백에 민감하다면 Web IDE가 공백 변경을 감지할 수 있습니다.

Web IDE에서 공백을 렌더링하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Render whitespace characters in the Web IDE 체크박스를 선택합니다.
  5. Save changes를 선택합니다.

diff에서 공백 변경 사항을 볼 수 있습니다.

Web IDE에서 diff를 보려면 다음 단계를 따릅니다.

  1. 왼쪽 사이드바에서 Source Control ([branch])을 선택합니다.
  2. Changes 탭에서 파일을 선택합니다.

diff에서 공백 변경 사항 표시#

diff 파일에서 공백 변경 사항을 봅니다. 공백에 대한 자세한 내용은 앞의 작업을 참고합니다.

diff에서 공백 변경 사항을 보려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Show whitespace changes in diffs 체크박스를 선택합니다.
  5. Save changes를 선택합니다.

diff에 대한 자세한 내용은 diff 색상 변경을 참고합니다.

머지 리퀘스트에서 페이지당 한 파일 표시#

Changes 탭에서는 머지 리퀘스트의 모든 파일 변경 사항을 한 페이지에서 볼 수 있습니다. 대신 한 번에 한 파일씩 보도록 선택할 수 있습니다.

Changes 탭에서 페이지당 한 파일을 표시하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Show one file at a time on merge request's Changes tab 체크박스를 선택합니다.
  5. Save changes를 선택합니다.

그다음 Changes 탭에서 파일 사이를 이동하려면 각 파일 아래의 Previous와 Next 버튼을 선택합니다.

문자 자동 묶기#

여는 문자를 입력하면 해당하는 닫는 문자를 텍스트에 자동으로 추가합니다. 예를 들어 여는 대괄호를 입력하면 닫는 대괄호를 자동으로 삽입할 수 있습니다. 이 설정은 설명과 댓글 상자에서만, 그리고 다음 문자에 대해서만 동작합니다: **", ', ```, (, [, {, <, *, _**.

설명과 댓글 상자에서 문자를 자동으로 묶으려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Surround text selection when typing quotes or brackets 체크박스를 선택합니다.
  5. Save changes를 선택합니다.

이제 설명이나 댓글 상자에서 단어를 입력하고 강조 표시한 다음 여는 문자를 입력할 수 있습니다. 텍스트가 대체되는 대신 닫는 문자가 끝에 추가됩니다.

새 목록 항목 자동화#

설명과 댓글 상자의 목록에서 Enter를 누르면 새 목록 항목을 만듭니다.

Enter 키를 누를 때 새 목록 항목을 추가하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Automatically add new list items 체크박스를 선택합니다.
  5. Save changes를 선택합니다.

이모지 자동 완성 끄기#

기본적으로 설명이나 댓글 상자에 콜론(:)을 입력하면 GitLab 이 일치하는 이모지를 제안합니다. 콜론 앞에 공백을 두는 언어처럼 다른 이유로 콜론을 입력한다면 이 제안을 끌 수 있습니다. 끈 뒤에도 복사해 붙여넣기 같은 다른 방법으로 이모지를 삽입할 수 있습니다.

이모지 자동 완성을 끄려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Enable emoji autocomplete 체크박스를 선택 해제합니다.
  5. Save changes를 선택합니다.

커서 들여쓰기 유지#

Enter를 누를 때 들여쓰기를 유지합니다. 새 줄의 커서는 이전 줄과 동일하게 자동으로 들여쓰기됩니다. 이 설정은 설명과 댓글 상자에서만 동작합니다.

Enter 키를 누를 때 새 목록 항목을 추가하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Maintain cursor indentation 체크박스를 선택합니다.
  5. Save changes를 선택합니다.

탭 너비 변경#

diff, blob, 스니펫에서 탭의 기본 크기를 변경합니다. Web IDE, 파일 에디터, Markdown 에디터는 이 기능을 지원하지 않습니다.

기본 탭 너비를 조정하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Behavior 섹션으로 스크롤합니다.
  4. Tab width에 값을 입력합니다.
  5. Save changes를 선택합니다.

현지화#

언어, 캘린더 시작 요일, 시간 환경 설정 같은 현지화 설정을 변경합니다.

GitLab UI에서 표시 언어 변경#

GitLab은 UI에서 여러 언어를 지원합니다.

GitLab UI의 언어를 선택하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Localization 섹션으로 이동합니다.
  4. Language에서 옵션을 선택합니다.
  5. Save changes를 선택합니다.

업데이트된 언어를 보려면 페이지를 새로 고쳐야 할 수 있습니다.

기여 캘린더 시작 요일 사용자 지정#

기여 캘린더가 어느 요일부터 시작할지 선택합니다. 기여 캘린더는 지난 1 년간의 프로젝트 기여를 보여 줍니다. 이 캘린더는 각 사용자 프로필에서 볼 수 있습니다. 사용자 프로필에 접근하려면 다음과 같이 합니다.

  • 오른쪽 상단에서 아바타를 선택하고 이름이나 사용자 이름을 선택합니다.

기여 캘린더 시작 요일을 변경하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Localization 섹션으로 이동합니다.
  4. First day of the week에서 옵션을 선택합니다.
  5. Save changes를 선택합니다.

캘린더 시작 요일을 변경한 뒤에는 사용자 프로필 페이지를 새로 고칩니다.

상대 시간 대신 정확한 시간 표시#

그룹 및 프로젝트 개요 페이지와 사용자 프로필에서 활동 시간을 표시하는 형식을 사용자 지정합니다. 시간은 다음 형식으로 표시할 수 있습니다.

  • 상대 형식. 예를 들어 30 minutes ago.
  • 절대 형식. 예를 들어 September 3, 2022, 3:57 PM.

GitLab UI에서 정확한 시간을 사용하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Time preferences 섹션으로 이동합니다.
  4. Use relative times 체크박스를 선택 해제합니다.
  5. Save changes를 선택합니다.

시간 형식 사용자 지정#

그룹 및 프로젝트 개요 페이지와 사용자 프로필에서 활동 시간을 표시하는 형식을 사용자 지정할 수 있습니다. 시간은 다음과 같이 표시할 수 있습니다.

  • 12 시간 형식. 예를 들어 2:34 PM.
  • 24 시간 형식. 예를 들어 14:34.

시스템 설정을 따를 수도 있습니다.

시간 형식을 사용자 지정하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Time preferences 섹션으로 이동합니다.
  4. Time format에서 System, 12-hour, 24-hour 옵션 중 하나를 선택합니다.
  5. Save changes를 선택합니다.

CI job JSON 웹 토큰의 사용자 ID#

CI/CD job은 외부 ID 목록을 포함할 수 있는 JSON 웹 토큰을 생성합니다. 개별 계정을 가져오기 위해 별도의 API를 호출하는 대신, 인증 토큰 하나에서 사용자 ID를 확인할 수 있습니다.

외부 ID는 기본적으로 포함되지 않습니다. 외부 ID를 포함하도록 활성화하려면 토큰 페이로드를 참고합니다.

팔로워 참여 제어#

다른 GitLab 사용자를 팔로우하거나 다른 사용자에게 팔로우되는 기능을 끕니다. 기본적으로 이름과 프로필 사진을 포함한 사용자 프로필은 다른 사용자의 Following 탭에서 공개됩니다. 이 설정을 비활성화하면 다음과 같이 동작합니다.

  • GitLab 이 모든 팔로워와 팔로우 연결을 삭제합니다.
  • GitLab 이 각 연결의 페이지에서 사용자 프로필을 자동으로 제거합니다.

다른 사용자에게 팔로우되는 기능과 다른 사용자를 팔로우하는 기능을 제거하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Enable follow users 체크박스를 선택 해제합니다.
  4. Save changes를 선택합니다.

Followers와 Following 탭에 접근하려면 다음과 같이 합니다.

  • 오른쪽 상단에서 아바타를 선택합니다.
  • Followers 또는 Following을 선택합니다.

GitLab 인스턴스와 타사 서비스 통합#

GitLab 사용 경험을 향상하도록 타사 서비스에 액세스 권한을 부여합니다.

GitLab 인스턴스와 Ona 통합#

GitLab 브라우저에서 코드를 직접 실행하고 관리하려면 GitLab 인스턴스를 Ona와 함께 구성합니다. Ona는 프로젝트의 개발 환경을 자동으로 준비하고 빌드합니다.

Ona와 통합하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Integrations 섹션을 찾습니다.
  4. Enable Ona integration 체크박스를 선택합니다.
  5. Save changes를 선택합니다.

GitLab 인스턴스와 Sourcegraph 통합#

GitLab은 GitLab의 모든 공개 프로젝트에 대해 Sourcegraph 통합을 지원합니다.

Sourcegraph와 통합하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Integrations 섹션을 찾습니다.
  4. Enable integrated code intelligence on code views 체크박스를 선택합니다.
  5. Save changes를 선택합니다.

GitLab을 Sourcegraph와 함께 구성하려면 GitLab 인스턴스의 관리자여야 합니다.

확장 마켓플레이스와 통합#

히스토리

VS Code Extension Marketplace는 Web IDE와 워크스페이스의 기능을 확장하는 확장을 제공합니다.

사전 요구 사항:

Extension Marketplace와 통합하려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. Integrations 섹션으로 이동합니다.
  4. Enable extension marketplace 체크박스를 선택합니다.
  5. 타사 확장 동의 안내에서 I understand를 선택합니다.
  6. Save changes를 선택합니다.