- GitLab 설치 상태 확인하기
- RPM ‘package is already installed’ 오류
- 설치된 패키지가 오래된 패키지에 의해 폐기됨
- 프로젝트 > 설정 > 리포지터리에 액세스 할 때 500 오류가 발생함
- 로그에
PG::UndefinedColumn: ERROR:..
메시지와 함께 500 오류가 발생하는 경우 - 오류: 내부 GitLab API에 연결하지 못했습니다
- 서명 확인 중 오류가 발생했습니다
Mixlib::ShellOut::CommandTimeout: rails_migration[gitlab-rails] [..] Command timed out after 3600s
- 누락 된 자산 파일
문제 해결
DETAILS: Tier: Free, Premium, Ultimate Offering: Self-Managed
GitLab 설치 상태 확인하기
sudo gitlab-ctl status
sudo gitlab-rake gitlab:check SANITIZE=true
RPM ‘package is already installed’ 오류
RPM을 사용하고 GitLab Community Edition에서 GitLab Enterprise Edition으로 업그레이드하는 경우 다음과 같은 오류가 발생할 수 있습니다:
package gitlab-7.5.2_omnibus.5.2.1.ci-1.el7.x86_64 (which is newer than gitlab-7.5.2_ee.omnibus.5.2.1.ci-1.el7.x86_64) is already installed
--oldpackage
옵션을 사용하여이 버전 확인을 재정의할 수 있습니다:
sudo rpm -Uvh --oldpackage gitlab-7.5.2_ee.omnibus.5.2.1.ci-1.el7.x86_64.rpm
설치된 패키지가 오래된 패키지에 의해 폐기됨
CE 및 EE 패키지는 서로를 폐기하고 대체하도록 표시되어 있어 동시에 설치하여 실행되지 않도록합니다.
CE에서 EE로 또는 그 반대로 전환하기 위해 로컬 RPM 파일을 사용하는 경우 패키지를 설치하기 위해 yum
대신 rpm
을 사용하십시오. 여기서 yum
을 사용하려고하면 다음과 같은 오류가 발생할 수 있습니다:
Cannot install package gitlab-ee-11.8.3-ee.0.el6.x86_64. It is obsoleted by installed package gitlab-ce-11.8.3-ce.0.el6.x86_64
이 문제를 피하려면 다음 중 하나를 수행하십시오:
- 매뉴얼으로 다운로드 한 패키지를 사용하여 업그레이드하는 섹션에서 제공 된 동일한 지침을 사용합니다.
- 명령에 제공 된 옵션에
--setopt = obsoletes = 0
을 추가하여 yum에서이 확인을 일시적으로 비활성화합니다.
프로젝트 > 설정 > 리포지터리에 액세스 할 때 500 오류가 발생함
이 오류는 GitLab이 CE > EE > CE로 변환 한 다음 다시 EE로 돌아간 경우에 발생합니다. 프로젝트의 리포지터리 설정을보고이 오류를 로그에서 볼 수 있습니다:
Processing by Projects::Settings::RepositoryController#show as HTML
Parameters: {"namespace_id"=>"<namespace_id>", "project_id"=>"<project_id>"}
Completed 500 Internal Server Error in 62ms (ActiveRecord: 4.7ms | Elasticsearch: 0.0ms | Allocations: 14583)
NoMethodError (undefined method `commit_message_negative_regex' for #<PushRule:0x00007fbddf4229b8>
Did you mean? commit_message_regex_change):
이 오류는 CE 인스턴스에 EE 기능이 추가되고 초기 EE로 이동 할 때 발생합니다.
인스턴스가 다시 CE로 이동 한 후 EE로 업그레이드되면
push_rules
테이블이 이미 데이터베이스에 존재합니다. 따라서 마이그레이션이
commit_message_regex_change
열을 추가할 수 없습니다.
이로 인해 EE 테이블의 백포트 마이그레이션이 올바르게 작동하지 않습니다. 백포트 마이그레이션은 CE에서 실행 될 때 데이터베이스의 특정 테이블이 존재하지 않는 것으로 가정합니다.
이 문제를 해결하려면:
-
데이터베이스 콘솔을 시작하십시오.
sudo gitlab-rails dbconsole --database main
-
누락 된
commit_message_negative_regex
열을 매뉴얼으로 추가하십시오.ALTER TABLE push_rules ADD COLUMN commit_message_negative_regex VARCHAR; # psql 종료 \q
-
GitLab을 다시 시작하십시오.
sudo gitlab-ctl restart
로그에 PG::UndefinedColumn: ERROR:..
메시지와 함께 500 오류가 발생하는 경우
업그레이드 후 로그에서 500
오류를받는 경우, PG::UndefinedColumn: ERROR:
와 유사한 메시지가 표시되는 경우 다음 중 하나에 의해 발생할 수 있습니다:
- 데이터베이스 마이그레이션이 완료되지 않았습니다. 마이그레이션이 완료 될 때까지 기다리십시오.
- 데이터베이스 마이그레이션이 완료되었지만 GitLab이 새로운 스키마를로드해야하는 경우. 새로운 스키마를로드하려면 GitLab을 다시 시작하십시오.
오류: 내부 GitLab API에 연결하지 못했습니다
별도의 GitLab Pages 서버에서 Failed to connect to the internal GitLab API
오류가 발생하는 경우,
GitLab Pages administration troubleshooting를 참조하십시오.
서명 확인 중 오류가 발생했습니다
apt-get update
를 실행 할 때이 오류가 발생하는 경우:
서명 확인 중 오류가 발생했습니다
다음 명령을 사용하여 GitLab 패키지 서버의 GPG 키를 업데이트하십시오:
curl --silent "https://packages.gitlab.com/gpg.key" | apt-key add -
apt-get update
Mixlib::ShellOut::CommandTimeout: rails_migration[gitlab-rails] [..] Command timed out after 3600s
데이터베이스 스키마 및 데이터 변경 (데이터베이스 마이그레이션)이 1 시간 이상 걸리는 경우 업그레이드가 시간 초과
오류로 실패합니다:
FATAL: Mixlib::ShellOut::CommandTimeout: rails_migration[gitlab-rails] (gitlab::database_migrations line 51)
had an error: Mixlib::ShellOut::CommandTimeout: bash[migrate gitlab-rails database]
(/opt/gitlab/embedded/cookbooks/cache/cookbooks/gitlab/resources/rails_migration.rb line 16)
had an error: Mixlib::ShellOut::CommandTimeout: Command timed out after 3600s:
이 오류를 해결하려면:
-
남은 데이터베이스 마이그레이션 실행:
sudo gitlab-rake db:migrate
이 명령은 완료하는 데 매우 오랜 시간이 걸릴 수 있습니다.
SSH 세션이 끊어지면 프로그램이 중단되지 않도록 screen
또는 기타 메커니즘을 사용하십시오.
-
업그레이드를 완료하십시오:
sudo gitlab-ctl reconfigure
-
puma
및sidekiq
서비스를 재로드하십시오:sudo gitlab-ctl hup puma sudo gitlab-ctl restart sidekiq
누락 된 자산 파일
업그레이드 후 GitLab이 이미지, JavaScript 및 스타일 시트와 같은 자산을 올바르게 제공하지 않을 수 있습니다. 500 오류가 발생하거나 웹 UI가 제대로 렌더링되지 않을 수 있습니다.
로드 밸런서 뒤에있는 하나의 웹 서버에서이 문제가 발생하는 경우 이 문제가 때때로 발생합니다.
자산을 다시 컴파일하는 Rake 작업을 Omnibus 설치에 적용되지는 않습니다
/opt/gitlab/embedded/service/gitlab-rails/public/assets
에서 사전 컴파일 된 자산을 제공합니다.
가능한 원인 및 해결 방법:
이전 프로세스
가장 가능성이 높은 원인은 이전 버전의 GitLab에서 asset 파일을 요청하도록 지시하는 이전 Puma 프로세스가 실행 중인 것입니다. 파일이 더 이상 존재하지 않기 때문에 HTTP 404 오류가 반환됩니다.
재부팅이 이전 Puma 프로세스가 더 이상 실행되지 않도록 하는 최선의 방법입니다.
또는:
-
Puma를 중지합니다:
gitlab-ctl stop puma
-
남아 있는 Puma 프로세스를 찾아서 종료합니다:
ps -ef | egrep 'puma[: ]' kill <processid>
-
ps
로 Puma 프로세스가 실행을 중지했는지 확인합니다. -
Puma를 시작합니다
gitlab-ctl start puma
중복 Sprockets 파일
컴파일된 asset 파일은 각 릴리스마다 고유한 파일 이름을 가지고 있습니다. Sprockets 파일은 애플리케이션 코드의 파일 이름과 고유한 파일 이름 간의 매핑을 제공합니다.
/opt/gitlab/embedded/service/gitlab-rails/public/assets/.sprockets-manifest*.json
중복 sprockets 파일이 없는지 확인하세요. Rails는 첫 번째 파일을 사용합니다.
Omnibus GitLab 업그레이드 중에 중복 sprockets 파일을 확인하는 검사가 실행됩니다:
이전 설치에서 삭제할 필요가 있는 오래된 파일이 GitLab에 의해 발견되었습니다.
다음 파일이 제거되어야 합니다:
/opt/gitlab/embedded/service/gitlab-rails/public/assets/.sprockets-manifest-e16fdb7dd73cfdd64ed9c2cc0e35718a.json
다음 중 이를 해결하는 옵션이 있습니다:
-
패키지 업그레이드로 인한 출력이 있는 경우 지정된 파일을 삭제한 다음 Puma를 다시 시작하세요:
gitlab-ctl restart puma
-
메시지가 없는 경우, 재설치를 수행하여 (자세한 내용은 아래의 incomplete installation를 참조하세요) 메시지를 다시 생성합니다.
-
모든 sprockets 파일을 제거한 다음 incomplete installation의 지침을 따르세요.
완전하지 않은 설치
완전하지 않은 설치가 이 문제의 원인일 수 있습니다.
이 문제인지를 확인하기 위해 패키지를 확인하세요:
-
Debian 배포판의 경우:
apt-get install debsums debsums -c gitlab-ee
-
Red Hat/SUSE (RPM) 배포판의 경우:
rpm -V gitlab-ee
완전하지 않은 설치를 해결하기 위해 패키지를 다시 설치하세요:
-
설치된 버전을 확인합니다
-
Debian 배포판의 경우:
apt --installed list gitlab-ee
-
Red Hat/SUSE (RPM) 배포판의 경우:
rpm -qa gitlab-ee
-
-
설치된 버전을 지정하여 패키지를 다시 설치합니다. 예: 14.4.0 Enterprise Edition
-
Debian 배포판의 경우:
apt-get install --reinstall gitlab-ee=14.4.0-ee.0
-
Red Hat/SUSE (RPM) 배포판의 경우:
yum reinstall gitlab-ee-14.4.0
-
NGINX Gzip 지원
nginx['gzip_enabled']
가 비활성화되었는지 확인하세요:
grep gzip /etc/gitlab/gitlab.rb
이로 인해 일부 asset이 제공되지 않을 수 있습니다. 관련된 이슈 중 하나에서 더 알아보기.