Merge branch 'specify-ruby-image-in-fail-fast-template' into 'master'

Specify Ruby image in FailFast template

See merge request gitlab-org/gitlab!38523

changelogs/unreleased/specify-ruby-image-in-fail-fast-template.yml

+---
+title: Specify Ruby image in FailFast template
+merge_request: 38523
+author:
+type: changed

doc/user/project/merge_requests/fail_fast_testing.md

@@ -45,8 +45,9 @@ This template requires:
   - Use [Pipelines for Merge Requests](../../../ci/merge_request_pipelines/index.md#configuring-pipelines-for-merge-requests)
 - [Pipelines for Merged Results](../../../ci/merge_request_pipelines/pipelines_for_merged_results/index.md#enable-pipelines-for-merged-results)
   enabled in the project settings.
+- A Docker image with Ruby available. The template uses `image: ruby:2.6` by default, but you [can override](../../../ci/yaml/includes.md#overriding-external-template-values) this.
 
-## Configure Fast RSpec Failure
+## Configuring Fast RSpec Failure
 
 We'll use the following plain RSpec configuration as a starting point. It installs all the
 project gems and executes `rspec`, on merge request pipelines only.
@@ -69,6 +70,16 @@ include:
   - template: Verify/FailFast.gitlab-ci.yml
 ```
 
+To customize the job, specific options may be set to override the template. For example, to override the default Docker image:
+
+```yaml
+include:
+  - template: Verify/FailFast.gitlab-ci.yml
+
+rspec-rails-modified-path-specs:
+  image: custom-docker-image-with-ruby
+```
+
 ### Example test loads
 
 For illustrative purposes, let's say our Rails app spec suite consists of 100 specs per model for ten models.

lib/gitlab/ci/templates/Verify/FailFast.gitlab-ci.yml

 rspec-rails-modified-path-specs:
+  image: ruby:2.6
   stage: .pre
   rules:
     - if: $CI_MERGE_REQUEST_EVENT_TYPE == "merged_result" || $CI_MERGE_REQUEST_EVENT_TYPE == "merge_train"