85 lines
3.5 KiB
Ruby
85 lines
3.5 KiB
Ruby
# frozen_string_literal: true
|
|
# rubocop:disable Style/SignalException
|
|
|
|
SEE_DOC = "See the [feature flag documentation](https://docs.gitlab.com/ee/development/feature_flags#feature-flag-definition-and-validation)."
|
|
FEATURE_FLAG_LABEL = "feature flag"
|
|
|
|
SUGGEST_MR_COMMENT = <<~SUGGEST_COMMENT
|
|
```suggestion
|
|
group: "%<group>s"
|
|
```
|
|
|
|
#{SEE_DOC}
|
|
SUGGEST_COMMENT
|
|
|
|
def check_feature_flag_yaml(feature_flag)
|
|
mr_group_label = helper.group_label
|
|
|
|
if feature_flag.group.nil?
|
|
message_for_feature_flag_missing_group!(feature_flag: feature_flag, mr_group_label: mr_group_label)
|
|
else
|
|
message_for_feature_flag_with_group!(feature_flag: feature_flag, mr_group_label: mr_group_label)
|
|
end
|
|
rescue Psych::Exception
|
|
# YAML could not be parsed, fail the build.
|
|
fail "#{helper.html_link(feature_flag.path)} isn't valid YAML! #{SEE_DOC}"
|
|
rescue StandardError => e
|
|
warn "There was a problem trying to check the Feature Flag file. Exception: #{e.class.name} - #{e.message}"
|
|
end
|
|
|
|
def message_for_feature_flag_missing_group!(feature_flag:, mr_group_label:)
|
|
if mr_group_label.nil?
|
|
warn "Consider setting `group` in #{helper.html_link(feature_flag.path)}. #{SEE_DOC}"
|
|
else
|
|
mr_line = feature_flag.raw.lines.find_index("group:\n")
|
|
|
|
if mr_line
|
|
markdown(format(SUGGEST_MR_COMMENT, group: mr_group_label), file: feature_flag.path, line: mr_line.succ)
|
|
else
|
|
warn %(Consider setting `group: "#{mr_group_label}"` in #{helper.html_link(feature_flag.path)}. #{SEE_DOC})
|
|
end
|
|
end
|
|
end
|
|
|
|
def message_for_global_rollout(feature_flag)
|
|
return unless feature_flag.default_enabled == true
|
|
|
|
message = <<~SUGGEST_COMMENT
|
|
You're about to [release the feature with the feature flag](https://gitlab.com/gitlab-org/gitlab/-/blob/master/.gitlab/issue_templates/Feature%20Flag%20Roll%20Out.md#optional-release-the-feature-with-the-feature-flag).
|
|
This process can only be done **after** the [global rollout on production](https://gitlab.com/gitlab-org/gitlab/-/blob/master/.gitlab/issue_templates/Feature%20Flag%20Roll%20Out.md#global-rollout-on-production).
|
|
Please make sure in [the rollout issue](#{feature_flag.rollout_issue_url}) that the preliminary steps have already been done. Otherwise, changing the YAML definition might not have the desired effect.
|
|
SUGGEST_COMMENT
|
|
|
|
mr_line = feature_flag.raw.lines.find_index { |l| l.include?('default_enabled:') }
|
|
markdown(message, file: feature_flag.path, line: mr_line.succ)
|
|
end
|
|
|
|
def message_for_feature_flag_with_group!(feature_flag:, mr_group_label:)
|
|
return if feature_flag.group_match_mr_label?(mr_group_label)
|
|
|
|
if mr_group_label.nil?
|
|
helper.labels_to_add << feature_flag.group
|
|
else
|
|
fail %(`group` is set to ~"#{feature_flag.group}" in #{helper.html_link(feature_flag.path)}, which does not match ~"#{mr_group_label}" set on the MR!)
|
|
end
|
|
end
|
|
|
|
def feature_flag_file_added?
|
|
feature_flag.feature_flag_files(change_type: :added).any?
|
|
end
|
|
|
|
def feature_flag_file_added_or_removed?
|
|
feature_flag_file_added? || feature_flag.feature_flag_files(change_type: :deleted).any?
|
|
end
|
|
|
|
feature_flag.feature_flag_files(change_type: :added).each do |feature_flag|
|
|
check_feature_flag_yaml(feature_flag)
|
|
end
|
|
|
|
feature_flag.feature_flag_files(change_type: :modified).each do |feature_flag|
|
|
message_for_global_rollout(feature_flag)
|
|
end
|
|
|
|
if helper.security_mr? && feature_flag_file_added?
|
|
fail "Feature flags are discouraged from security merge requests. Read the [security documentation](https://gitlab.com/gitlab-org/release/docs/-/blob/master/general/security/utilities/feature_flags.md) for details."
|
|
end
|