제품, 기능, 표준 섹션
GitLab v19.6요약
GitLab 제품 문서에서 제품과 기능을 설명할 때 이 섹션의 정보를 참고합니다. 기능 또는 제품 이름에 공백이 있더라도 줄 바꿈으로 이름을 나누지 않습니다. 제품 제공 세부 정보는 기능에 관한 정보를 제공하며 주제 제목 아래에 표시됩니다.
제품과 기능#
GitLab 제품 문서에서 제품과 기능을 설명할 때 이 섹션의 정보를 참고합니다.
이름 안에서 줄 바꿈 피하기#
기능 또는 제품 이름에 공백이 있더라도 줄 바꿈으로 이름을 나누지 않습니다. 이름이 바뀔 때 줄 바꿈이 있는 텍스트는 검색하거나 grep하기가 더 복잡합니다.
제품 제공 세부 정보#
제품 제공 세부 정보는 기능에 관한 정보를 제공하며 주제 제목 아래에 표시됩니다.
자세한 내용은 제품 제공 세부 정보를 참고합니다.
특정 섹션#
특정 섹션에는 정해진 스타일을 적용해야 합니다. 특정 섹션의 스타일은 이 섹션에서 설명합니다.
도움말 및 피드백 섹션#
이 섹션은 각 문서 끝에 표시되며, 프론트매터에 다음 키를 추가하면 생략할 수 있습니다.
---
feedback: false
---
기본값은 이 섹션을 그대로 두는 것입니다. 문서에서 이 섹션을 생략하려면 먼저 테크니컬 라이터와 확인해야 합니다.
GitLab 재시작#
GitLab 재시작 또는 재구성이 필요한 경우, 중복을 피하기 위해 다음과 같은 텍스트로
doc/administration/restart_gitlab.md로 링크합니다.
필요하면 'reconfigure'를 'restart'로 바꿉니다.
Save the file and [reconfigure GitLab](../../../administration/restart_gitlab.md)
for the changes to take effect.
문서가 doc/ 디렉터리 밖에 있으면 상대 링크 대신 전체 경로를 사용합니다:
https://docs.gitlab.com/administration/restart_gitlab.
다양한 설치 방법을 문서화하는 방법#
GitLab은 다섯 가지 공식 설치 방법을 지원합니다. 문장과 제목의 일부로 이 방법을 언급할 때는 다음 표현을 사용합니다.
- Linux package
- Helm chart
- GitLab Operator
- Docker
- Self-compiled
탭을 사용할 때는 설명하는 괄호를 추가해도 됩니다.
- Linux package (Omnibus)
- Helm chart (Kubernetes)
- GitLab Operator (Kubernetes)
- Docker
- Self-compiled (source)
탭으로 GitLab Self-Managed 구성 절차 설명하기#
구성 절차에서는 사용자가 구성 파일을 편집하거나 GitLab을 재구성하거나 GitLab을 재시작해야 할 수 있습니다. 이 경우 다음을 따릅니다.
- 탭을 사용해 여러 설치 방법을 구분합니다.
- 설치 방법 이름은 앞의 목록에 나온 그대로 사용합니다.
- 아래에 설명된 순서대로 사용합니다.
- 코드 블록은 해당하는 목록 항목에 맞춰 들여씁니다.
- 각 코드 블록에 알맞은 구문 강조(
ruby,shell,yaml)를 사용합니다. - YAML 파일에서는 항상 상위 설정을 포함합니다.
- GitLab을 재구성하거나 재시작하는 마지막 단계는 매번 같으므로 그대로 사용해도 됩니다.
구성 편집을 설명할 때는 이 스니펫을 사용하고, 필요에 따라 수정합니다.
1. Edit `/etc/gitlab/gitlab.rb`:
```ruby
external_url "https://gitlab.example.com"
```
1. Save the file and reconfigure GitLab:
```shell
sudo gitlab-ctl reconfigure
```
1. Export the Helm values:
```shell
helm get values gitlab > gitlab_values.yaml
```
1. Edit `gitlab_values.yaml`:
```yaml
global:
hosts:
gitlab:
name: gitlab.example.com
```
1. Save the file and apply the new values:
```shell
helm upgrade -f gitlab_values.yaml gitlab gitlab/gitlab
```
1. Edit `docker-compose.yml`:
```yaml
version: "3.6"
services:
gitlab:
environment:
GITLAB_OMNIBUS_CONFIG: |
external_url "https://gitlab.example.com"
```
1. Save the file and restart GitLab:
```shell
docker compose up -d
```
1. Edit `/home/git/gitlab/config/gitlab.yml`:
```yaml
production: &base
gitlab:
host: "gitlab.example.com"
```
1. Save the file and restart GitLab:
```shell
# For systems running systemd
sudo systemctl restart gitlab.target
# For systems running SysV init
sudo service gitlab restart
```
다음과 같이 렌더링됩니다.
-
/etc/gitlab/gitlab.rb를 편집합니다.external_url "https://gitlab.example.com" -
파일을 저장하고 GitLab을 재구성합니다.
sudo gitlab-ctl reconfigure
-
Helm 값을 내보냅니다.
helm get values gitlab > gitlab_values.yaml -
gitlab_values.yaml을 편집합니다.global: hosts: gitlab: name: gitlab.example.com -
파일을 저장하고 새 값을 적용합니다.
helm upgrade -f gitlab_values.yaml gitlab gitlab/gitlab
-
docker-compose.yml을 편집합니다.version: "3.6" services: gitlab: environment: GITLAB_OMNIBUS_CONFIG: | external_url "https://gitlab.example.com" -
파일을 저장하고 GitLab을 재시작합니다.
docker compose up -d
-
/home/git/gitlab/config/gitlab.yml을 편집합니다.production: &base gitlab: host: "gitlab.example.com" -
파일을 저장하고 GitLab을 재시작합니다.
# For systems running systemd sudo systemctl restart gitlab.target # For systems running SysV init sudo service gitlab restart