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

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

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

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

4. 첫 번째 단계를 실행해 가져오기를 시작합니다.

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

사전 요구 사항:

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

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. 파일을 저장하고 GitLab을 재구성합니다.

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

4. 첫 번째 단계를 실행해 가져오기를 시작합니다.

   sudo gitlab-ctl registry-database import --step-one
   

1. 레지스트리가 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.
       }
     }
   }
   

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

3. 가져오기의 2 단계를 실행합니다.

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

4. 명령이 성공적으로 완료되면 모든 이미지를 완전히 가져온 상태입니다. 이제 데이터베이스를 활성화하고 구성에서 읽기 전용 모드를 해제한 다음 레지스트리 서비스를 시작할 수 있습니다.

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

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

1. 레지스트리가 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.
       }
     }
   }
   

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

3. 가져오기의 2 단계를 실행합니다.

   sudo gitlab-ctl registry-database import --step-two
   

4. 명령이 성공적으로 완료되면 모든 이미지를 완전히 가져온 상태입니다. 이제 데이터베이스를 활성화하고 구성에서 읽기 전용 모드를 해제한 다음 레지스트리 서비스를 시작할 수 있습니다.

   registry['database'] = {
     'enabled' => true, # Must be set to true!
     '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' => { # This section can be removed.
       'readonly' => {
         'enabled' => false
       }
     }
   }
   

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

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

sudo gitlab-ctl registry-database import --step-three