1. /etc/gitlab/gitlab.rb 파일의 registry['database'] 섹션에서 데이터베이스가 비활성화되어 있는지 확인합니다.

   registry['database'] = {
     'enabled' => false, # Must be false!
   }
   

2. 레지스트리가 read-only 모드로 설정되어 있는지 확인합니다.

   /etc/gitlab/gitlab.rb 파일을 편집해 registry['storage'] 구성에 maintenance 섹션을 추가합니다. 예를 들어 gs://my-company-container-registry 버킷을 사용하는 gcs 기반 레지스트리라면 구성은 다음과 같습니다.

   ## Object Storage - Container Registry
   registry['storage'] = {
     'gcs' => {
       'bucket' => '<my-company-container-registry>',
       'chunksize' => 5242880
     },
     'maintenance' => {
       'readonly' => {
         'enabled' => true # Must be set to true.
       }
     }
   }
   

3. 파일을 저장하고 GitLab을 재구성합니다.

4. 데이터베이스 마이그레이션을 적용합니다.

5. 다음 명령을 실행합니다.

   sudo -u registry gitlab-ctl registry-database import --log-to-stdout
   

6. 명령이 성공적으로 완료되면 레지스트리 가져오기가 모두 끝난 것입니다. 데이터베이스를 활성화하고, 구성에서 읽기 전용 모드를 해제하고, 레지스트리 서비스를 시작할 수 있습니다.

   registry['database'] = {
     'enabled' => true, # Must be enabled now!
   }
   
   ## Object Storage - Container Registry
   registry['storage'] = {
     'gcs' => {
       'bucket' => '<my-company-container-registry>',
       'chunksize' => 5242880
     },
     'maintenance' => {
       'readonly' => {
         'enabled' => false
       }
     }
   }
   

7. 파일을 저장하고 GitLab을 재구성합니다.

사전 요구 사항:

• 외부 데이터베이스를 생성합니다.

1. /etc/gitlab/gitlab.rb 파일에 database 섹션을 추가하되, 메타데이터 데이터베이스는 비활성화한 상태로 시작합니다.

   registry['database'] = {
     'enabled' => false, # Must be false!
     'host' => '<registry_database_host_placeholder_change_me>',
     'port' => 5432, # Default, but set to the port of your database instance if it differs.
     'user' => '<registry_database_username_placeholder_change_me>',
     'password' => '<registry_database_placeholder_change_me>',
     'dbname' => '<registry_database_name_placeholder_change_me>',
     'sslmode' => 'require', # See the PostgreSQL documentation for additional information https://www.postgresql.org/docs/16/libpq-ssl.html.
     'sslcert' => '</path/to/cert.pem>',
     'sslkey' => '</path/to/private.key>',
     'sslrootcert' => '</path/to/ca.pem>'
   }
   

2. 레지스트리가 read-only 모드로 설정되어 있는지 확인합니다.

   /etc/gitlab/gitlab.rb 파일을 편집해 registry['storage'] 구성에 maintenance 섹션을 추가합니다. 예를 들어 gs://my-company-container-registry 버킷을 사용하는 gcs 기반 레지스트리라면 구성은 다음과 같습니다.

   ## Object Storage - Container Registry
   registry['storage'] = {
     'gcs' => {
       'bucket' => '<my-company-container-registry>',
       'chunksize' => 5242880
     },
     'maintenance' => {
       'readonly' => {
         'enabled' => true # Must be set to true.
       }
     }
   }
   

3. 파일을 저장하고 GitLab을 재구성합니다.

4. 아직 적용하지 않았다면 데이터베이스 마이그레이션을 적용합니다.

5. 다음 명령을 실행합니다.

   sudo gitlab-ctl registry-database import
   

6. 명령이 성공적으로 완료되면 레지스트리 가져오기가 모두 끝난 것입니다. 이제 데이터베이스를 활성화하고, 구성에서 읽기 전용 모드를 해제하고, 레지스트리 서비스를 시작할 수 있습니다.

   registry['database'] = {
     'enabled' => true, # Must be enabled now!
     'host' => '<registry_database_host_placeholder_change_me>',
     'port' => 5432, # Default, but set to the port of your database instance if it differs.
     'user' => '<registry_database_username_placeholder_change_me>',
     'password' => '<registry_database_placeholder_change_me>',
     'dbname' => '<registry_database_name_placeholder_change_me>',
     'sslmode' => 'require', # See the PostgreSQL documentation for additional information https://www.postgresql.org/docs/16/libpq-ssl.html.
     'sslcert' => '</path/to/cert.pem>',
     'sslkey' => '</path/to/private.key>',
     'sslrootcert' => '</path/to/ca.pem>'
   }
   
   ## Object Storage - Container Registry
   registry['storage'] = {
     'gcs' => {
       'bucket' => '<my-company-container-registry>',
       'chunksize' => 5242880
     },
     'maintenance' => {
       'readonly' => {
         'enabled' => false
       }
     }
   }
   

7. 파일을 저장하고 GitLab을 재구성합니다.