Import/Export 개발 문서

# AttributeCleaner
# 모든 `_ids` 및 다른 금지된 키를 제거함
    class AttributeCleaner
      ALLOWED_REFERENCES = RelationFactory::PROJECT_REFERENCES + RelationFactory::USER_REFERENCES + ['group_id']

      def clean
        @relation_hash.reject do |key, _value|
          prohibited_key?(key) || !@relation_class.attribute_method?(key) || excluded_key?(key)
        end.except('id')
      end

      ...

# AttributeConfigurationSpec
<<-MSG
  프로젝트 Import/Export를 사용하여 내보낼 #{relation_class}에 새로운 속성이 추가되어 있는 것 같습니다.

  이 속성을 내보낼 수 있으면 `SAFE_MODEL_ATTRIBUTES`에 추가해 주세요.

  이 속성을 IMPORT_EXPORT_CONFIG에서 해당 모델의 +excluded_attributes+ 섹션에 추가하여 목록에서 제외해 주세요.

  SAFE_MODEL_ATTRIBUTES: #{File.expand_path(safe_attributes_file)}
  IMPORT_EXPORT_CONFIG: #{Gitlab::ImportExport.config_file}
MSG

# ModelConfigurationSpec
<<-MSG
  #{parent_model_name}과(와) 관련된 새로운 모델 <#{new_models.join(',')}>이(가) Import/Export 기능으로 내보내집니다.

  만약 이 모델이 내보내기에 포함되어야 한다면 `#{Gitlab::ImportExport.config_file}`에 추가해주세요.

  또한 `#{File.expand_path(ce_models_yml)}`에도 추가해주세요.
  이렇게 하면 오류를 처리했음을 알리고 나중에 표시되지 않도록 합니다.
MSG

# ExportFileSpec
<<-MSG
  발견된 새로운 민감한 단어 <#{key_found}>, 이것은 #{parent.inspect}의 일부입니다.
  이 정보가 내보내는 게 적합하지 않다고 생각하면, IMPORT_EXPORT_CONFIG에서 이 모델 또는 속성을 제외하세요.

  그렇지 않으면, CURRENT_SPEC의 +safe_list+에 예외를 추가하세요. 그리고 키로 #{sensitive_word}를, 값으로 대응되는 해시나 모델을 사용하세요.

  또한 이 속성이 생성된 고유한 토큰이라면, RelationFactory::TOKEN_RESET_MODELS에 추가해서
  (동일한 인스턴스로 가져올 때 중복 열 문제를 방지하기 위해) 리셋해야 하는지 확인하세요.

  IMPORT_EXPORT_CONFIG: #{Gitlab::ImportExport.config_file}
  CURRENT_SPEC: #{__FILE__}
MSG

# ImportExport
module Gitlab
  module ImportExport
    extend self

    # 매번 버전 업데이트마다 import_export.md의 이력을 최신 상태로 유지해야 합니다.
    VERSION = '0.2.4'

# ImportExport::Importer
module Gitlab
  module ImportExport
    class Importer
      def execute
        if import_file && check_version! && restorers.all?(&:restore) && overwrite_project
          project
        else
          raise Projects::ImportService::Error.new(@shared.errors.join(', '))
        end
      rescue => e
        raise Projects::ImportService::Error.new(e.message)
      ensure
        remove_import_file
      end

      def restorers
        [repo_restorer, wiki_restorer, project_tree, avatar_restorer,
         uploads_restorer, lfs_restorer, statistics_restorer]
      end

# ImportExport::ExportService
module Projects
  module ImportExport
    class ExportService < BaseService

      def save_all!
        if save_services
          Gitlab::ImportExport::Saver.save(project: project, shared: @shared)
          notify_success
        else
          cleanup_and_notify_error!
        end
      end

      def save_services
        [version_saver, avatar_saver, project_tree_saver, uploads_saver, repo_saver,
           wiki_repo_saver, lfs_saver].all?(&:save)
      end