debian-mirror-gitlab/app/models/service.rb

465 lines
14 KiB
Ruby
Raw Normal View History

2018-11-18 11:00:15 +05:30
# frozen_string_literal: true
2014-09-02 18:07:02 +05:30
# To add new service you should build a class inherited from Service
# and implement a set of methods
2019-07-07 11:18:12 +05:30
class Service < ApplicationRecord
2015-04-26 12:48:37 +05:30
include Sortable
2018-03-17 18:26:18 +05:30
include Importable
2018-11-20 20:47:30 +05:30
include ProjectServicesLoggable
2019-09-04 21:01:54 +05:30
include DataFields
2021-01-03 14:25:43 +05:30
include FromUnion
2021-01-29 00:20:46 +05:30
include EachBatch
2018-03-17 18:26:18 +05:30
2020-04-22 19:07:51 +05:30
SERVICE_NAMES = %w[
2021-02-22 17:27:13 +05:30
asana assembla bamboo bugzilla buildkite campfire confluence custom_issue_tracker datadog discord
2020-11-24 15:15:51 +05:30
drone_ci emails_on_push ewm external_wiki flowdock hangouts_chat hipchat irker jira
2020-04-22 19:07:51 +05:30
mattermost mattermost_slash_commands microsoft_teams packagist pipelines_email
2020-05-24 23:13:21 +05:30
pivotaltracker prometheus pushover redmine slack slack_slash_commands teamcity unify_circuit webex_teams youtrack
2020-04-22 19:07:51 +05:30
].freeze
2021-02-22 17:27:13 +05:30
PROJECT_SPECIFIC_SERVICE_NAMES = %w[
jenkins
].freeze
2021-01-29 00:20:46 +05:30
# Fake services to help with local development.
2020-04-22 19:07:51 +05:30
DEV_SERVICE_NAMES = %w[
2021-02-22 17:27:13 +05:30
mock_ci mock_monitoring
2020-04-22 19:07:51 +05:30
].freeze
2017-09-10 17:25:29 +05:30
serialize :properties, JSON # rubocop:disable Cop/ActiveRecordSerialize
2015-04-26 12:48:37 +05:30
2014-09-02 18:07:02 +05:30
default_value_for :active, false
2020-06-23 00:09:42 +05:30
default_value_for :alert_events, true
2020-11-24 15:15:51 +05:30
default_value_for :category, 'common'
2017-08-17 22:00:37 +05:30
default_value_for :commit_events, true
2020-11-24 15:15:51 +05:30
default_value_for :confidential_issues_events, true
2018-04-05 14:03:07 +05:30
default_value_for :confidential_note_events, true
2020-11-24 15:15:51 +05:30
default_value_for :issues_events, true
2017-09-10 17:25:29 +05:30
default_value_for :job_events, true
2020-11-24 15:15:51 +05:30
default_value_for :merge_requests_events, true
default_value_for :note_events, true
2016-09-29 09:46:39 +05:30
default_value_for :pipeline_events, true
2020-11-24 15:15:51 +05:30
default_value_for :push_events, true
default_value_for :tag_push_events, true
2016-06-02 11:05:42 +05:30
default_value_for :wiki_page_events, true
2015-04-26 12:48:37 +05:30
after_initialize :initialize_properties
2014-09-02 18:07:02 +05:30
2015-10-24 18:46:33 +05:30
after_commit :reset_updated_properties
2016-08-24 12:49:21 +05:30
belongs_to :project, inverse_of: :services
2020-11-24 15:15:51 +05:30
belongs_to :group, inverse_of: :services
2014-09-02 18:07:02 +05:30
has_one :service_hook
2020-10-24 23:57:45 +05:30
validates :project_id, presence: true, unless: -> { template? || instance? || group_id }
validates :group_id, presence: true, unless: -> { template? || instance? || project_id }
validates :project_id, :group_id, absence: true, if: -> { template? || instance? }
2017-08-17 22:00:37 +05:30
validates :type, presence: true
2021-03-11 19:13:27 +05:30
validates :type, uniqueness: { scope: :template }, if: :template?
validates :type, uniqueness: { scope: :instance }, if: :instance?
validates :type, uniqueness: { scope: :project_id }, if: :project_id?
validates :type, uniqueness: { scope: :group_id }, if: :group_id?
2020-04-08 14:13:33 +05:30
validate :validate_is_instance_or_template
2020-10-24 23:57:45 +05:30
validate :validate_belongs_to_project_or_group
2015-04-26 12:48:37 +05:30
2020-10-24 23:57:45 +05:30
scope :external_issue_trackers, -> { where(category: 'issue_tracker').active }
2016-08-24 12:49:21 +05:30
scope :external_wikis, -> { where(type: 'ExternalWikiService').active }
2016-01-29 22:53:50 +05:30
scope :active, -> { where(active: true) }
2019-12-26 22:10:19 +05:30
scope :by_type, -> (type) { where(type: type) }
2020-04-22 19:07:51 +05:30
scope :by_active_flag, -> (flag) { where(active: flag) }
2021-01-03 14:25:43 +05:30
scope :inherit_from_id, -> (id) { where(inherit_from_id: id) }
2021-02-22 17:27:13 +05:30
scope :inherit, -> { where.not(inherit_from_id: nil) }
2021-01-29 00:20:46 +05:30
scope :for_group, -> (group) { where(group_id: group, type: available_services_types(include_project_specific: false)) }
scope :for_template, -> { where(template: true, type: available_services_types(include_project_specific: false)) }
scope :for_instance, -> { where(instance: true, type: available_services_types(include_project_specific: false)) }
2015-04-26 12:48:37 +05:30
scope :push_hooks, -> { where(push_events: true, active: true) }
scope :tag_push_hooks, -> { where(tag_push_events: true, active: true) }
scope :issue_hooks, -> { where(issues_events: true, active: true) }
2016-09-29 09:46:39 +05:30
scope :confidential_issue_hooks, -> { where(confidential_issues_events: true, active: true) }
2015-04-26 12:48:37 +05:30
scope :merge_request_hooks, -> { where(merge_requests_events: true, active: true) }
scope :note_hooks, -> { where(note_events: true, active: true) }
2018-04-05 14:03:07 +05:30
scope :confidential_note_hooks, -> { where(confidential_note_events: true, active: true) }
2017-09-10 17:25:29 +05:30
scope :job_hooks, -> { where(job_events: true, active: true) }
2016-09-13 17:45:13 +05:30
scope :pipeline_hooks, -> { where(pipeline_events: true, active: true) }
2016-06-02 11:05:42 +05:30
scope :wiki_page_hooks, -> { where(wiki_page_events: true, active: true) }
2019-07-31 22:56:46 +05:30
scope :deployment_hooks, -> { where(deployment_events: true, active: true) }
2020-06-23 00:09:42 +05:30
scope :alert_hooks, -> { where(alert_events: true, active: true) }
2018-03-17 18:26:18 +05:30
scope :deployment, -> { where(category: 'deployment') }
2014-09-02 18:07:02 +05:30
2020-11-24 15:15:51 +05:30
# Provide convenient accessor methods for each serialized property.
# Also keep track of updated properties in a similar way as ActiveModel::Dirty
def self.prop_accessor(*args)
args.each do |arg|
class_eval <<~RUBY, __FILE__, __LINE__ + 1
unless method_defined?(arg)
def #{arg}
properties['#{arg}']
end
end
def #{arg}=(value)
self.properties ||= {}
updated_properties['#{arg}'] = #{arg} unless #{arg}_changed?
self.properties['#{arg}'] = value
end
def #{arg}_changed?
#{arg}_touched? && #{arg} != #{arg}_was
end
def #{arg}_touched?
updated_properties.include?('#{arg}')
end
def #{arg}_was
updated_properties['#{arg}']
end
RUBY
end
end
# Provide convenient boolean accessor methods for each serialized property.
# Also keep track of updated properties in a similar way as ActiveModel::Dirty
def self.boolean_accessor(*args)
self.prop_accessor(*args)
args.each do |arg|
class_eval <<~RUBY, __FILE__, __LINE__ + 1
def #{arg}?
# '!!' is used because nil or empty string is converted to nil
!!ActiveRecord::Type::Boolean.new.cast(#{arg})
end
RUBY
end
end
def self.to_param
raise NotImplementedError
end
def self.event_names
self.supported_events.map { |event| ServicesHelper.service_event_field_name(event) }
end
def self.supported_event_actions
%w[]
end
def self.supported_events
%w[commit push tag_push issue confidential_issue merge_request wiki_page]
end
2021-02-22 17:27:13 +05:30
def self.default_test_event
'push'
end
2020-11-24 15:15:51 +05:30
def self.event_description(event)
ServicesHelper.service_event_description(event)
end
def self.find_or_create_templates
create_nonexistent_templates
for_template
end
def self.create_nonexistent_templates
nonexistent_services = list_nonexistent_services_for(for_template)
return if nonexistent_services.empty?
# Create within a transaction to perform the lowest possible SQL queries.
transaction do
nonexistent_services.each do |service_type|
service_type.constantize.create(template: true)
end
end
end
private_class_method :create_nonexistent_templates
2021-01-29 00:20:46 +05:30
def self.find_or_initialize_non_project_specific_integration(name, instance: false, group_id: nil)
if name.in?(available_services_names(include_project_specific: false))
2020-11-24 15:15:51 +05:30
"#{name}_service".camelize.constantize.find_or_initialize_by(instance: instance, group_id: group_id)
end
end
2021-01-29 00:20:46 +05:30
def self.find_or_initialize_all_non_project_specific(scope)
2020-11-24 15:15:51 +05:30
scope + build_nonexistent_services_for(scope)
end
def self.build_nonexistent_services_for(scope)
list_nonexistent_services_for(scope).map do |service_type|
service_type.constantize.new
end
end
private_class_method :build_nonexistent_services_for
def self.list_nonexistent_services_for(scope)
# Using #map instead of #pluck to save one query count. This is because
# ActiveRecord loaded the object here, so we don't need to query again later.
2021-01-29 00:20:46 +05:30
available_services_types(include_project_specific: false) - scope.map(&:type)
2020-11-24 15:15:51 +05:30
end
private_class_method :list_nonexistent_services_for
2021-01-29 00:20:46 +05:30
def self.available_services_names(include_project_specific: true, include_dev: true)
2020-11-24 15:15:51 +05:30
service_names = services_names
2021-01-29 00:20:46 +05:30
service_names += project_specific_services_names if include_project_specific
service_names += dev_services_names if include_dev
2020-11-24 15:15:51 +05:30
service_names.sort_by(&:downcase)
end
def self.services_names
SERVICE_NAMES
end
def self.dev_services_names
return [] unless Rails.env.development?
DEV_SERVICE_NAMES
end
2021-01-03 14:25:43 +05:30
def self.project_specific_services_names
2021-02-22 17:27:13 +05:30
PROJECT_SPECIFIC_SERVICE_NAMES
2021-01-03 14:25:43 +05:30
end
2021-01-29 00:20:46 +05:30
def self.available_services_types(include_project_specific: true, include_dev: true)
available_services_names(include_project_specific: include_project_specific, include_dev: include_dev).map do |service_name|
"#{service_name}_service".camelize
end
2020-11-24 15:15:51 +05:30
end
2021-01-03 14:25:43 +05:30
def self.build_from_integration(integration, project_id: nil, group_id: nil)
2020-11-24 15:15:51 +05:30
service = integration.dup
if integration.supports_data_fields?
data_fields = integration.data_fields.dup
data_fields.service = service
end
service.template = false
service.instance = false
service.project_id = project_id
2021-01-03 14:25:43 +05:30
service.group_id = group_id
service.inherit_from_id = integration.id if integration.instance? || integration.group
2020-11-24 15:15:51 +05:30
service.active = false if service.invalid?
service
end
def self.instance_exists_for?(type)
exists?(instance: true, type: type)
end
def self.default_integration(type, scope)
closest_group_integration(type, scope) || instance_level_integration(type)
end
def self.closest_group_integration(type, scope)
group_ids = scope.ancestors.select(:id)
array = group_ids.to_sql.present? ? "array(#{group_ids.to_sql})" : 'ARRAY[]'
2021-01-03 14:25:43 +05:30
where(type: type, group_id: group_ids, inherit_from_id: nil)
2020-11-24 15:15:51 +05:30
.order(Arel.sql("array_position(#{array}::bigint[], services.group_id)"))
.first
end
private_class_method :closest_group_integration
def self.instance_level_integration(type)
find_by(type: type, instance: true)
end
private_class_method :instance_level_integration
2016-01-29 22:53:50 +05:30
2021-01-03 14:25:43 +05:30
def self.create_from_active_default_integrations(scope, association, with_templates: false)
group_ids = scope.ancestors.select(:id)
array = group_ids.to_sql.present? ? "array(#{group_ids.to_sql})" : 'ARRAY[]'
from_union([
with_templates ? active.where(template: true) : none,
active.where(instance: true),
active.where(group_id: group_ids, inherit_from_id: nil)
]).order(Arel.sql("type ASC, array_position(#{array}::bigint[], services.group_id), instance DESC")).group_by(&:type).each do |type, records|
2021-02-22 17:27:13 +05:30
build_from_integration(records.first, association => scope.id).save
2021-01-03 14:25:43 +05:30
end
end
2021-01-29 00:20:46 +05:30
def self.inherited_descendants_from_self_or_ancestors_from(integration)
inherit_from_ids =
where(type: integration.type, group: integration.group.self_and_ancestors)
.or(where(type: integration.type, instance: true)).select(:id)
from_union([
where(type: integration.type, inherit_from_id: inherit_from_ids, group: integration.group.descendants),
where(type: integration.type, inherit_from_id: inherit_from_ids, project: Project.in_namespace(integration.group.self_and_descendants))
])
end
2014-09-02 18:07:02 +05:30
def activated?
active
end
2020-05-24 23:13:21 +05:30
def operating?
active && persisted?
end
2017-09-10 17:25:29 +05:30
def show_active_box?
true
end
def editable?
true
end
2014-09-02 18:07:02 +05:30
def category
2016-01-29 22:53:50 +05:30
read_attribute(:category).to_sym
2014-09-02 18:07:02 +05:30
end
2015-04-26 12:48:37 +05:30
def initialize_properties
2021-01-29 00:20:46 +05:30
self.properties = {} if has_attribute?(:properties) && properties.nil?
2015-04-26 12:48:37 +05:30
end
2014-09-02 18:07:02 +05:30
def title
# implement inside child
end
def description
# implement inside child
end
def help
# implement inside child
end
def to_param
# implement inside child
2017-08-17 22:00:37 +05:30
self.class.to_param
end
2014-09-02 18:07:02 +05:30
def fields
# implement inside child
[]
end
2019-12-04 20:38:33 +05:30
# Expose a list of fields in the JSON endpoint.
#
# This list is used in `Service#as_json(only: json_fields)`.
def json_fields
2020-11-24 15:15:51 +05:30
%w[active]
2019-12-04 20:38:33 +05:30
end
2020-06-23 00:09:42 +05:30
def to_service_hash
2020-11-24 15:15:51 +05:30
as_json(methods: :type, except: %w[id template instance project_id group_id])
2020-06-23 00:09:42 +05:30
end
def to_data_fields_hash
data_fields.as_json(only: data_fields.class.column_names).except('id', 'service_id')
2016-08-24 12:49:21 +05:30
end
def event_channel_names
[]
end
2016-09-13 17:45:13 +05:30
def event_names
2017-08-17 22:00:37 +05:30
self.class.event_names
end
2016-08-24 12:49:21 +05:30
def event_field(event)
nil
end
2018-03-17 18:26:18 +05:30
def api_field_names
fields.map { |field| field[:name] }
2019-09-30 21:07:59 +05:30
.reject { |field_name| field_name =~ /(password|token|key|title|description)/ }
2018-03-17 18:26:18 +05:30
end
2016-08-24 12:49:21 +05:30
def global_fields
fields
end
2018-03-27 19:54:05 +05:30
def configurable_events
2020-06-23 00:09:42 +05:30
events = supported_events
2018-03-27 19:54:05 +05:30
# No need to disable individual triggers when there is only one
if events.count == 1
[]
else
events
end
end
2020-01-01 13:55:28 +05:30
def configurable_event_actions
self.class.supported_event_actions
end
2015-04-26 12:48:37 +05:30
def supported_events
2017-08-17 22:00:37 +05:30
self.class.supported_events
end
2021-02-22 17:27:13 +05:30
def default_test_event
self.class.default_test_event
end
2015-09-11 14:41:01 +05:30
def execute(data)
2014-09-02 18:07:02 +05:30
# implement inside child
end
2015-09-11 14:41:01 +05:30
def test(data)
# default implementation
result = execute(data)
{ success: result.present?, result: result }
end
2020-11-24 15:15:51 +05:30
# Disable test for instance-level and group-level services.
2020-04-22 19:07:51 +05:30
# https://gitlab.com/gitlab-org/gitlab/-/issues/213138
2014-09-02 18:07:02 +05:30
def can_test?
2020-11-24 15:15:51 +05:30
!instance? && !group_id
2015-12-23 02:04:40 +05:30
end
2021-02-22 17:27:13 +05:30
def parent
project || group
end
2015-10-24 18:46:33 +05:30
# Returns a hash of the properties that have been assigned a new value since last save,
# indicating their original values (attr => original value).
2016-01-29 22:53:50 +05:30
# ActiveRecord does not provide a mechanism to track changes in serialized keys,
2015-10-24 18:46:33 +05:30
# so we need a specific implementation for service properties.
# This allows to track changes to properties set with the accessor methods,
# but not direct manipulation of properties hash.
def updated_properties
@updated_properties ||= ActiveSupport::HashWithIndifferentAccess.new
end
def reset_updated_properties
@updated_properties = nil
end
2016-01-29 22:53:50 +05:30
2015-04-26 12:48:37 +05:30
def async_execute(data)
return unless supported_events.include?(data[:object_kind])
2018-03-17 18:26:18 +05:30
ProjectServiceWorker.perform_async(id, data)
2015-04-26 12:48:37 +05:30
end
2021-01-29 00:20:46 +05:30
def external_wiki?
type == 'ExternalWikiService' && active?
2015-04-26 12:48:37 +05:30
end
2019-12-21 20:55:43 +05:30
# override if needed
def supports_data_fields?
false
end
private
2020-04-08 14:13:33 +05:30
def validate_is_instance_or_template
errors.add(:template, 'The service should be a service template or instance-level integration') if template? && instance?
end
2020-10-24 23:57:45 +05:30
def validate_belongs_to_project_or_group
errors.add(:project_id, 'The service cannot belong to both a project and a group') if project_id && group_id
end
2018-03-17 18:26:18 +05:30
def valid_recipients?
activated? && !importing?
end
2014-09-02 18:07:02 +05:30
end
2019-12-04 20:38:33 +05:30
Service.prepend_if_ee('EE::Service')