Class: Upload

Inherits:
ApplicationRecord show all
Includes:
Checksummable
Defined in:
app/models/upload.rb

Constant Summary collapse

CHECKSUM_THRESHOLD =

Upper limit for foreground checksum processing

100.megabytes

Constants inherited from ApplicationRecord

ApplicationRecord::MAX_PLUCK

Constants included from ResetOnUnionError

ResetOnUnionError::MAX_RESET_PERIOD

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from ApplicationRecord

cached_column_list, #create_or_load_association, declarative_enum, default_select_columns, id_in, id_not_in, iid_in, pluck_primary_key, primary_key_in, #readable_by?, safe_ensure_unique, safe_find_or_create_by, safe_find_or_create_by!, #to_ability_name, underscore, where_exists, where_not_exists, with_fast_read_statement_timeout, without_order

Methods included from SensitiveSerializableHash

#serializable_hash

Class Method Details

.begin_fast_destroyObject

FastDestroyAll concerns



45
46
47
48
49
50
# File 'app/models/upload.rb', line 45

def begin_fast_destroy
  {
    Uploads::Local => Uploads::Local.new.keys(with_files_stored_locally),
    Uploads::Fog => Uploads::Fog.new.keys(with_files_stored_remotely)
  }
end

.finalize_fast_destroy(items_to_remove) ⇒ Object

FastDestroyAll concerns



54
55
56
57
58
# File 'app/models/upload.rb', line 54

def finalize_fast_destroy(items_to_remove)
  items_to_remove.each do |store_class, keys|
    store_class.new.delete_keys_async(keys)
  end
end

.inner_join_local_uploads_projectsObject



28
29
30
31
32
33
34
35
36
37
38
39
40
41
# File 'app/models/upload.rb', line 28

def inner_join_local_uploads_projects
  upload_table = Upload.arel_table
  project_table = Project.arel_table

  join_statement = upload_table.project(upload_table[Arel.star])
                     .join(project_table)
                     .on(
                       upload_table[:model_type].eq('Project')
                         .and(upload_table[:model_id].eq(project_table[:id]))
                         .and(upload_table[:store].eq(ObjectStorage::Store::LOCAL))
                     )

  joins(join_statement.join_sources)
end

Instance Method Details

#absolute_pathObject



61
62
63
64
65
66
# File 'app/models/upload.rb', line 61

def absolute_path
  raise ObjectStorage::RemoteStoreError, _("Remote object has no absolute path.") unless local?
  return path unless relative_path?

  uploader_class.absolute_path(self)
end

#build_uploader(mounted_as = nil) ⇒ GitlabUploader

Initialize the associated Uploader class with current model

Parameters:

  • mounted_as (String) (defaults to: nil)

Returns:

  • (GitlabUploader)

    one of the subclasses, defined at the model’s uploader attribute



83
84
85
86
87
# File 'app/models/upload.rb', line 83

def build_uploader(mounted_as = nil)
  uploader_class.new(model, mounted_as || mount_point).tap do |uploader|
    uploader.upload = self
  end
end

#calculate_checksum!Object



72
73
74
75
76
77
# File 'app/models/upload.rb', line 72

def calculate_checksum!
  self.checksum = nil
  return unless needs_checksum?

  self.checksum = self.class.sha256_hexdigest(absolute_path)
end

#exist?Boolean

This checks for existence of the upload on storage

Returns:

  • (Boolean)

    whether upload exists on storage



103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
# File 'app/models/upload.rb', line 103

def exist?
  exist = if local?
            File.exist?(absolute_path)
          else
            retrieve_uploader.exists?
          end

  # Help sysadmins find missing upload files
  if persisted? && !exist
    exception = RuntimeError.new("Uploaded file does not exist")
    Gitlab::ErrorTracking.track_exception(exception, self.attributes)
    Gitlab::Metrics.counter(:upload_file_does_not_exist_total, _('The number of times an upload record could not find its file')).increment
  end

  exist
end

#local?Boolean

Returns:

  • (Boolean)


127
128
129
# File 'app/models/upload.rb', line 127

def local?
  store == ObjectStorage::Store::LOCAL
end

#needs_checksum?Boolean

Returns whether generating checksum is needed

This takes into account whether file exists, if any checksum exists or if the storage has checksum generation code implemented

Returns:

  • (Boolean)

    whether generating a checksum is needed



137
138
139
# File 'app/models/upload.rb', line 137

def needs_checksum?
  checksum.nil? && local? && exist?
end

#relative_pathObject



68
69
70
# File 'app/models/upload.rb', line 68

def relative_path
  uploader_class.relative_path(self)
end

#retrieve_uploader(mounted_as = nil) ⇒ GitlabUploader

Initialize the associated Uploader class with current model and retrieve existing file from the store to a local cache

Parameters:

  • mounted_as (String) (defaults to: nil)

Returns:

  • (GitlabUploader)

    one of the subclasses, defined at the model’s uploader attribute



94
95
96
97
98
# File 'app/models/upload.rb', line 94

def retrieve_uploader(mounted_as = nil)
  build_uploader(mounted_as).tap do |uploader|
    uploader.retrieve_from_store!(identifier)
  end
end

#uploader_contextObject



120
121
122
123
124
125
# File 'app/models/upload.rb', line 120

def uploader_context
  {
    identifier: identifier,
    secret: secret
  }.compact
end