Split Rake tasks to their own files

6 files changed, 350 insertions, 335 deletions

diff --git a/Rakefile b/Rakefile
index ed8ecfcb..c104034f 100644
--- a/Rakefile
+++ b/Rakefile
@@ -1,336 +1,6 @@
+#!/usr/bin/env rake
 # frozen_string_literal: true
 
-require './lib/task_helpers'
-require 'fileutils'
-require 'pathname'
-
-COLOR_CODE_RESET = "\e[0m"
-COLOR_CODE_RED = "\e[31m"
-COLOR_CODE_GREEN = "\e[32m"
-
-task_helpers = TaskHelpers.new
-
-task default: [:clone_repositories, :generate_feature_flags]
-
-task :setup_git do
-  puts "\n#{COLOR_CODE_GREEN}INFO: Setting up dummy user and email in Git..#{COLOR_CODE_RESET}"
-
-  `git config --global user.name "Sidney Jones"`
-  `git config --global user.email "sidneyjones@example.com"`
-end
-
-desc 'Clone Git repositories of documentation projects, keeping only the most recent commit'
-task :clone_repositories do
-  task_helpers.products.each_value do |product|
-    branch = task_helpers.retrieve_branch(product['slug'])
-
-    # Limit the pipeline to pull only the repo where the MR is, not all 4, to save time/space.
-    # First we check if the branch on the docs repo is other than the default branch and
-    # then we skip if the remote branch variable is the default branch name. Finally,
-    # check if the pipeline was triggered via the API (multi-project pipeline)
-    # to exclude the case where we create a branch right off the gitlab-docs
-    # project.
-    next if ENV["CI_COMMIT_REF_NAME"] != ENV['CI_DEFAULT_BRANCH'] \
-      && branch == ENV['CI_DEFAULT_BRANCH'] \
-      && ENV["CI_PIPELINE_SOURCE"] == 'pipeline'
-
-    puts "\n#{COLOR_CODE_GREEN}INFO: Cloning #{product['repo']}..#{COLOR_CODE_RESET}"
-
-    `git clone --branch #{branch} --single-branch #{product['repo']} --depth 1 #{product['project_dir']}`
-
-    # Print the latest commit from each project so that we can see which commit we're building from.
-    puts "\n#{COLOR_CODE_GREEN}INFO: Latest commit: #{`git -C #{product['project_dir']} log --oneline -n 1`}#{COLOR_CODE_RESET}"
-  end
-end
-
-desc 'Generate feature flags data file'
-task :generate_feature_flags do
-  feature_flags_dir = Pathname.new('..').join('gitlab', 'config', 'feature_flags').expand_path
-  feature_flags_ee_dir = Pathname.new('..').join('gitlab', 'ee', 'config', 'feature_flags').expand_path
-
-  abort("\n#{COLOR_CODE_RED}ERROR: The feature flags directory #{feature_flags_dir} does not exist.#{COLOR_CODE_RESET}") unless feature_flags_dir.exist?
-  abort("\n#{COLOR_CODE_RED}ERROR: The feature flags EE directory #{feature_flags_ee_dir} does not exist.#{COLOR_CODE_RESET}") unless feature_flags_ee_dir.exist?
-
-  paths = {
-    'GitLab Community Edition and Enterprise Edition' => feature_flags_dir.join('**', '*.yml'),
-    'GitLab Enterprise Edition only' => feature_flags_ee_dir.join('**', '*.yml')
-  }
-
-  feature_flags = {
-    products: {}
-  }
-
-  paths.each do |key, path|
-    feature_flags[:products][key] = []
-
-    Dir.glob(path).each do |feature_flag_yaml|
-      feature_flags[:products][key] << YAML.safe_load(File.read(feature_flag_yaml))
-    end
-  end
-
-  feature_flags_yaml = File.join('content', '_data', 'feature_flags.yaml')
-
-  puts "\n#{COLOR_CODE_GREEN}INFO: Generating #{feature_flags_yaml}..#{COLOR_CODE_RESET}"
-  File.write(feature_flags_yaml, feature_flags.to_yaml)
-end
-
-namespace :release do
-  desc 'Creates a single release archive'
-  task :single, :version do |t, args|
-    require "highline/import"
-    version = args.version.to_s
-    source_dir = File.expand_path(__dir__)
-
-    # Disable lefthook because it was causing some PATH errors
-    # https://docs.gitlab.com/ee/development/contributing/style_guides.html#disable-lefthook-temporarily
-    ENV['LEFTHOOK'] = '0'
-
-    raise 'You need to specify a version, like 10.1' unless version.match?(%r{\A\d+\.\d+\z})
-
-    # Check if local branch exists
-    abort("\n#{COLOR_CODE_RED}ERROR: Rake aborted! The branch already exists. Delete it with `git branch -D #{version}` and rerun the task.#{COLOR_CODE_RESET}") \
-      if task_helpers.local_branch_exist?(version)
-
-    # Stash modified and untracked files so we have "clean" environment
-    # without accidentally deleting data
-    puts "\n#{COLOR_CODE_GREEN}INFO: Stashing changes..#{COLOR_CODE_RESET}"
-    `git stash -u` if task_helpers.git_workdir_dirty?
-
-    # Sync with upstream default branch
-    `git checkout #{ENV['CI_DEFAULT_BRANCH']}`
-    `git pull origin #{ENV['CI_DEFAULT_BRANCH']}`
-
-    # Create branch
-    `git checkout -b #{version}`
-
-    # Replace the branches variables in Dockerfile.X.Y
-    dockerfile = "#{source_dir}/#{version}.Dockerfile"
-
-    if File.exist?(dockerfile)
-      abort('rake aborted!') if ask("#{dockerfile} already exists. Do you want to overwrite?", %w[y n]) == 'n'
-    end
-
-    content = File.read('dockerfiles/single.Dockerfile')
-    content.gsub!('X.Y', version)
-    content.gsub!('X-Y', version.tr('.', '-'))
-    content.gsub!('W-Z', task_helpers.chart_version(version).tr('.', '-'))
-
-    File.open(dockerfile, 'w') do |post|
-      post.puts content
-    end
-
-    # Replace the branches variables in .gitlab-ci.yml
-    ci_yaml = "#{source_dir}/.gitlab-ci.yml"
-    ci_yaml_content = File.read(ci_yaml)
-    ci_yaml_content.gsub!("BRANCH_EE: 'master'", "BRANCH_EE: '#{version.tr('.', '-')}-stable-ee'")
-    ci_yaml_content.gsub!("BRANCH_OMNIBUS: 'master'", "BRANCH_OMNIBUS: '#{version.tr('.', '-')}-stable'")
-    ci_yaml_content.gsub!("BRANCH_RUNNER: 'main'", "BRANCH_RUNNER: '#{version.tr('.', '-')}-stable'")
-    ci_yaml_content.gsub!("BRANCH_CHARTS: 'master'", "BRANCH_CHARTS: '#{task_helpers.chart_version(version).tr('.', '-')}-stable'")
-
-    File.open(ci_yaml, 'w') do |post|
-      post.puts ci_yaml_content
-    end
-
-    # Add and commit
-    `git add .gitlab-ci.yml #{version}.Dockerfile`
-    `git commit -m 'Release cut #{version}'`
-
-    puts "\n#{COLOR_CODE_GREEN}INFO: Created new Dockerfile:#{COLOR_CODE_RESET} #{dockerfile}."
-    puts "#{COLOR_CODE_GREEN}INFO: Pushing the new branch. Don't create a merge request!#{COLOR_CODE_RESET}"
-
-    `git push origin #{version}`
-  end
-end
-
-desc 'Create the _redirects file'
-task :redirects do
-  redirects_yaml = YAML.load_file('content/_data/redirects.yaml', permitted_classes: [Date])
-  redirects_file = 'public/_redirects'
-
-  # Remove _redirects before populating it
-  File.delete(redirects_file) if File.exist?(redirects_file)
-
-  # Iterate over each entry and append to _redirects
-  redirects_yaml.fetch('redirects').each do |redirect|
-    File.open(redirects_file, 'a') do |f|
-      f.puts "#{redirect.fetch('from')} #{redirect.fetch('to')} 301"
-    end
-  end
-end
-
-#
-# https://docs.gitlab.com/ee/development/documentation/#move-or-rename-a-page
-#
-namespace :docs do
-  require 'date'
-  require 'pathname'
-  require "yaml"
-  desc 'GitLab | Docs | Clean up old redirects'
-  task :clean_redirects do
-    source_dir = File.expand_path(__dir__)
-    redirects_yaml = "#{source_dir}/content/_data/redirects.yaml"
-    today = Time.now.utc.to_date
-    mr_title = "Clean up docs redirects - #{today}"
-    mr_description = "Monthly cleanup of docs redirects.</br><p>See https://about.gitlab.com/handbook/engineering/ux/technical-writing/#regularly-scheduled-tasks</p></br></hr></br><p>_Created automatically: https://gitlab.com/gitlab-org/gitlab-docs/-/blob/main/doc/raketasks.md#clean-up-redirects_</p>"
-    redirects_branch = "docs-clean-redirects-#{today}"
-    commit_message = "Update docs redirects #{today}"
-
-    # Disable lefthook because it was causing some PATH errors
-    # https://docs.gitlab.com/ee/development/contributing/style_guides.html#disable-lefthook-temporarily
-    ENV['LEFTHOOK'] = '0'
-
-    # Check jq is available
-    abort("\n#{COLOR_CODE_RED}ERROR: jq not found. Install jq and run task again.#{COLOR_CODE_RESET}") if `which jq`.empty?
-
-    puts "\n#{COLOR_CODE_GREEN}INFO: (gitlab-docs): Stashing changes of gitlab-docs and syncing with upstream default branch..#{COLOR_CODE_RESET}"
-    system("git stash --quiet -u") if task_helpers.git_workdir_dirty?
-    system("git checkout --quiet main")
-    system("git fetch --quiet origin main")
-    system("git reset --quiet --hard origin/main")
-
-    task_helpers.products.each_value do |product|
-      #
-      # Calculate new path from the redirect URL.
-      #
-      # If the redirect is not a full URL:
-      #   1. Create a new Pathname of the file
-      #   2. Use dirname to get all but the last component of the path
-      #   3. Join with the redirect_to entry
-      #   4. Substitute:
-      #      - '.md' => '.html'
-      #      - 'doc/' => '/ee/'
-      #
-      # If the redirect URL is a full URL pointing to the Docs site
-      # (cross-linking among the 4 products), remove the FQDN prefix:
-      #
-      #   From : https://docs.gitlab.com/ee/install/requirements.html
-      #   To   : /ee/install/requirements.html
-      #
-      def new_path(redirect, filename, content_dir, slug)
-        if !redirect.start_with?('http')
-          Pathname.new(filename).dirname.join(redirect).to_s.gsub(%r{\.md}, '.html').gsub(content_dir, "/#{slug}")
-        elsif redirect.start_with?('https://docs.gitlab.com')
-          redirect.gsub('https://docs.gitlab.com', '')
-        else
-          redirect
-        end
-      end
-
-      content_dir = product['content_dir']
-      next unless Dir.exist?(content_dir)
-
-      default_branch = task_helpers.default_branch(product['repo'])
-      origin_default_branch = "origin/#{default_branch}"
-      slug = product['slug']
-      counter = 0
-
-      Dir.chdir(content_dir)
-      puts "\n#{COLOR_CODE_GREEN}INFO: (#{slug}): Stashing changes of #{slug} and syncing with upstream default branch..#{COLOR_CODE_RESET}"
-      system("git", "stash", "--quiet", "-u") if task_helpers.git_workdir_dirty?
-      system("git", "checkout", "--quiet", default_branch)
-      system("git", "fetch", "--quiet", "origin", default_branch)
-      system("git", "reset", "--quiet", "--hard", origin_default_branch)
-      Dir.chdir(source_dir)
-
-      #
-      # Find the files to be deleted.
-      # Exclude 'doc/development/documentation/redirects.md' because it
-      # contains an example of the YAML front matter.
-      #
-      files_to_be_deleted = `grep -Ir 'remove_date:' #{content_dir} | cut -d ":" -f1`.split("\n")
-      puts "Files containing 'remove_date':"
-      files_to_be_deleted.each { |file| puts "- #{file}" }
-      puts
-
-      #
-      # Iterate over the files to be deleted and print the needed
-      # YAML entries for the Docs site redirects.
-      #
-      files_to_be_deleted.each do |filename|
-        frontmatter = YAML.safe_load(File.read(filename))
-
-        # Skip if remove_date is not found in the frontmatter
-        next unless frontmatter.has_key?('remove_date')
-
-        remove_date = Date.parse(frontmatter['remove_date'])
-        old_path = filename.gsub(%r{\.md}, '.html').gsub(content_dir, "/#{slug}")
-
-        #
-        # Check if the removal date is before today, and delete the file and
-        # print the content to be pasted in
-        # https://gitlab.com/gitlab-org/gitlab-docs/-/blob/master/content/_data/redirects.yaml.
-        # The remove_date of redirects.yaml should be nine months in the future.
-        # To not be confused with the remove_date of the Markdown page.
-        #
-        next unless remove_date < today
-
-        puts "In #{filename}, remove date: #{remove_date} is less than today (#{today})."
-
-        counter += 1
-
-        File.delete(filename) if File.exist?(filename)
-
-        # Don't add any entries that are domain-level redirects, they are not supported
-        # https://docs.gitlab.com/ee/user/project/pages/redirects.html
-        next if new_path(frontmatter['redirect_to'], filename, content_dir, slug).start_with?('http')
-
-        File.open(redirects_yaml, 'a') do |post|
-          post.puts "  - from: #{old_path}"
-          post.puts "    to: #{new_path(frontmatter['redirect_to'], filename, content_dir, slug)}"
-          post.puts "    remove_date: #{remove_date >> 9}"
-        end
-
-        # If the 'from' path ends with 'index.html' we need an extra redirect
-        # entry in 'redirects.yaml' that is without 'index.html'
-        next unless old_path.end_with?('index.html')
-
-        File.open(redirects_yaml, 'a') do |post|
-          post.puts "  - from: #{old_path.gsub!('index.html', '')}"
-          post.puts "    to: #{new_path(frontmatter['redirect_to'], filename, content_dir, slug)}"
-          post.puts "    remove_date: #{remove_date >> 9}"
-        end
-      end
-
-      #
-      # If more than one files are found:
-      #
-      #   1. cd into each repository
-      #   2. Create a redirects branch
-      #   3. Add the changed files
-      #   4. Commit and push the branch to create the MR
-      #
-
-      puts "\n#{COLOR_CODE_GREEN}INFO: (#{slug}): Found #{counter} redirect(s).#{COLOR_CODE_RESET}"
-      next unless counter.positive?
-
-      Dir.chdir(content_dir)
-      puts "\n#{COLOR_CODE_GREEN}INFO: (#{slug}): Creating a new branch for the redirects MR..#{COLOR_CODE_RESET}"
-      system("git", "checkout", "--quiet", "-b", redirects_branch, origin_default_branch)
-      puts "\n#{COLOR_CODE_GREEN}INFO: (#{slug}): Committing and pushing to create a merge request..#{COLOR_CODE_RESET}"
-      system("git", "add", ".")
-      system("git", "commit", "--quiet", "-m", commit_message)
-
-      `git push --set-upstream origin #{redirects_branch} -o merge_request.create -o merge_request.remove_source_branch -o merge_request.title="#{mr_title}" -o merge_request.description="#{mr_description}" -o merge_request.label="Technical Writing" -o merge_request.label="documentation" -o merge_request.label="docs::improvement" -o merge_request.label="type::maintenance"` \
-        if ENV['SKIP_MR'].nil?
-
-      Dir.chdir(source_dir)
-      puts
-    end
-
-    #
-    # Finally, create the gitlab-docs MR
-    #
-    #   1. Create a redirects branch
-    #   2. Add the changed files
-    #   3. Commit and push the branch to create the MR
-    #
-    puts "\n#{COLOR_CODE_GREEN}INFO: (gitlab-docs): Creating a new branch for the redirects MR..#{COLOR_CODE_RESET}"
-    system("git", "checkout", "--quiet", "-b", redirects_branch, "origin/main")
-    puts "\n#{COLOR_CODE_GREEN}INFO: (gitlab-docs): Committing and pushing to create a merge request..#{COLOR_CODE_RESET}"
-    system("git", "add", redirects_yaml)
-    system("git", "commit", "--quiet", "-m", commit_message)
-
-    `git push --set-upstream origin #{redirects_branch} -o merge_request.create -o merge_request.remove_source_branch -o merge_request.title="#{mr_title}" -o merge_request.description="#{mr_description}" -o merge_request.label="Technical Writing" -o merge_request.label="redirects" -o merge_request.label="Category:Docs Site" -o merge_request.label="type::maintenance"` \
-      if ENV['SKIP_MR'].nil?
-  end
-end
+# All tasks in files placed in lib/tasks/ ending in .rake will be loaded
+# automatically
+Rake.add_rakelib 'lib/tasks'
diff --git a/lib/tasks/build_site.rake b/lib/tasks/build_site.rake
new file mode 100644
index 00000000..af235dbe
--- /dev/null
+++ b/lib/tasks/build_site.rake
@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+require './lib/tasks/task_helpers'
+require 'fileutils'
+require 'pathname'
+
+task_helpers = TaskHelpers.new
+
+task default: [:clone_repositories, :generate_feature_flags]
+
+task :setup_git do
+  puts "\n#{COLOR_CODE_GREEN}INFO: Setting up dummy user and email in Git..#{COLOR_CODE_RESET}"
+
+  `git config --global user.name "Sidney Jones"`
+  `git config --global user.email "sidneyjones@example.com"`
+end
+
+desc 'Clone Git repositories of documentation projects, keeping only the most recent commit'
+task :clone_repositories do
+  task_helpers.products.each_value do |product|
+    branch = task_helpers.retrieve_branch(product['slug'])
+
+    # Limit the pipeline to pull only the repo where the MR is, not all 4, to save time/space.
+    # First we check if the branch on the docs repo is other than the default branch and
+    # then we skip if the remote branch variable is the default branch name. Finally,
+    # check if the pipeline was triggered via the API (multi-project pipeline)
+    # to exclude the case where we create a branch right off the gitlab-docs
+    # project.
+    next if ENV["CI_COMMIT_REF_NAME"] != ENV['CI_DEFAULT_BRANCH'] \
+      && branch == ENV['CI_DEFAULT_BRANCH'] \
+      && ENV["CI_PIPELINE_SOURCE"] == 'pipeline'
+
+    puts "\n#{COLOR_CODE_GREEN}INFO: Cloning #{product['repo']}..#{COLOR_CODE_RESET}"
+
+    `git clone --branch #{branch} --single-branch #{product['repo']} --depth 1 #{product['project_dir']}`
+
+    # Print the latest commit from each project so that we can see which commit we're building from.
+    puts "\n#{COLOR_CODE_GREEN}INFO: Latest commit: #{`git -C #{product['project_dir']} log --oneline -n 1`}#{COLOR_CODE_RESET}"
+  end
+end
+
+desc 'Generate feature flags data file'
+task :generate_feature_flags do
+  feature_flags_dir = Pathname.new('..').join('gitlab', 'config', 'feature_flags').expand_path
+  feature_flags_ee_dir = Pathname.new('..').join('gitlab', 'ee', 'config', 'feature_flags').expand_path
+
+  abort("\n#{COLOR_CODE_RED}ERROR: The feature flags directory #{feature_flags_dir} does not exist.#{COLOR_CODE_RESET}") unless feature_flags_dir.exist?
+  abort("\n#{COLOR_CODE_RED}ERROR: The feature flags EE directory #{feature_flags_ee_dir} does not exist.#{COLOR_CODE_RESET}") unless feature_flags_ee_dir.exist?
+
+  paths = {
+    'GitLab Community Edition and Enterprise Edition' => feature_flags_dir.join('**', '*.yml'),
+    'GitLab Enterprise Edition only' => feature_flags_ee_dir.join('**', '*.yml')
+  }
+
+  feature_flags = {
+    products: {}
+  }
+
+  paths.each do |key, path|
+    feature_flags[:products][key] = []
+
+    Dir.glob(path).each do |feature_flag_yaml|
+      feature_flags[:products][key] << YAML.safe_load(File.read(feature_flag_yaml))
+    end
+  end
+
+  feature_flags_yaml = File.join('content', '_data', 'feature_flags.yaml')
+
+  puts "\n#{COLOR_CODE_GREEN}INFO: Generating #{feature_flags_yaml}..#{COLOR_CODE_RESET}"
+  File.write(feature_flags_yaml, feature_flags.to_yaml)
+end
diff --git a/lib/tasks/redirects.rake b/lib/tasks/redirects.rake
new file mode 100644
index 00000000..9d1b094b
--- /dev/null
+++ b/lib/tasks/redirects.rake
@@ -0,0 +1,197 @@
+# frozen_string_literal: true
+require './lib/tasks/task_helpers'
+require 'date'
+require 'pathname'
+require 'fileutils'
+
+task_helpers = TaskHelpers.new
+
+desc 'Create the _redirects file'
+task :redirects do
+  redirects_yaml = YAML.load_file('content/_data/redirects.yaml', permitted_classes: [Date])
+  redirects_file = 'public/_redirects'
+
+  # Remove _redirects before populating it
+  File.delete(redirects_file) if File.exist?(redirects_file)
+
+  # Iterate over each entry and append to _redirects
+  redirects_yaml.fetch('redirects').each do |redirect|
+    File.open(redirects_file, 'a') do |f|
+      f.puts "#{redirect.fetch('from')} #{redirect.fetch('to')} 301"
+    end
+  end
+end
+
+#
+# https://docs.gitlab.com/ee/development/documentation/#move-or-rename-a-page
+#
+namespace :docs do
+  desc 'GitLab | Docs | Clean up old redirects'
+  task :clean_redirects do
+    source_dir = File.expand_path(__dir__)
+    redirects_yaml = "#{source_dir}/content/_data/redirects.yaml"
+    today = Time.now.utc.to_date
+    mr_title = "Clean up docs redirects - #{today}"
+    mr_description = "Monthly cleanup of docs redirects.</br><p>See https://about.gitlab.com/handbook/engineering/ux/technical-writing/#regularly-scheduled-tasks</p></br></hr></br><p>_Created automatically: https://gitlab.com/gitlab-org/gitlab-docs/-/blob/main/doc/raketasks.md#clean-up-redirects_</p>"
+    redirects_branch = "docs-clean-redirects-#{today}"
+    commit_message = "Update docs redirects #{today}"
+
+    # Disable lefthook because it was causing some PATH errors
+    # https://docs.gitlab.com/ee/development/contributing/style_guides.html#disable-lefthook-temporarily
+    ENV['LEFTHOOK'] = '0'
+
+    # Check jq is available
+    abort("\n#{COLOR_CODE_RED}ERROR: jq not found. Install jq and run task again.#{COLOR_CODE_RESET}") if `which jq`.empty?
+
+    puts "\n#{COLOR_CODE_GREEN}INFO: (gitlab-docs): Stashing changes of gitlab-docs and syncing with upstream default branch..#{COLOR_CODE_RESET}"
+    system("git stash --quiet -u") if git_workdir_dirty?
+    system("git checkout --quiet main")
+    system("git fetch --quiet origin main")
+    system("git reset --quiet --hard origin/main")
+
+    task_helpers.products.each_value do |product|
+      #
+      # Calculate new path from the redirect URL.
+      #
+      # If the redirect is not a full URL:
+      #   1. Create a new Pathname of the file
+      #   2. Use dirname to get all but the last component of the path
+      #   3. Join with the redirect_to entry
+      #   4. Substitute:
+      #      - '.md' => '.html'
+      #      - 'doc/' => '/ee/'
+      #
+      # If the redirect URL is a full URL pointing to the Docs site
+      # (cross-linking among the 4 products), remove the FQDN prefix:
+      #
+      #   From : https://docs.gitlab.com/ee/install/requirements.html
+      #   To   : /ee/install/requirements.html
+      #
+      def new_path(redirect, filename, content_dir, slug)
+        if !redirect.start_with?('http')
+          Pathname.new(filename).dirname.join(redirect).to_s.gsub(%r{\.md}, '.html').gsub(content_dir, "/#{slug}")
+        elsif redirect.start_with?('https://docs.gitlab.com')
+          redirect.gsub('https://docs.gitlab.com', '')
+        else
+          redirect
+        end
+      end
+
+      content_dir = product['content_dir']
+      next unless Dir.exist?(content_dir)
+
+      default_branch = task_helpers.default_branch(product['repo'])
+      origin_default_branch = "origin/#{default_branch}"
+      slug = product['slug']
+      counter = 0
+
+      Dir.chdir(content_dir)
+      puts "\n#{COLOR_CODE_GREEN}INFO: (#{slug}): Stashing changes of #{slug} and syncing with upstream default branch..#{COLOR_CODE_RESET}"
+      system("git", "stash", "--quiet", "-u") if task_helpers.git_workdir_dirty?
+      system("git", "checkout", "--quiet", default_branch)
+      system("git", "fetch", "--quiet", "origin", default_branch)
+      system("git", "reset", "--quiet", "--hard", origin_default_branch)
+      Dir.chdir(source_dir)
+
+      #
+      # Find the files to be deleted.
+      # Exclude 'doc/development/documentation/redirects.md' because it
+      # contains an example of the YAML front matter.
+      #
+      files_to_be_deleted = `grep -Ir 'remove_date:' #{content_dir} | cut -d ":" -f1`.split("\n")
+      puts "Files containing 'remove_date':"
+      files_to_be_deleted.each { |file| puts "- #{file}" }
+      puts
+
+      #
+      # Iterate over the files to be deleted and print the needed
+      # YAML entries for the Docs site redirects.
+      #
+      files_to_be_deleted.each do |filename|
+        frontmatter = YAML.safe_load(File.read(filename))
+
+        # Skip if remove_date is not found in the frontmatter
+        next unless frontmatter.has_key?('remove_date')
+
+        remove_date = Date.parse(frontmatter['remove_date'])
+        old_path = filename.gsub(%r{\.md}, '.html').gsub(content_dir, "/#{slug}")
+
+        #
+        # Check if the removal date is before today, and delete the file and
+        # print the content to be pasted in
+        # https://gitlab.com/gitlab-org/gitlab-docs/-/blob/master/content/_data/redirects.yaml.
+        # The remove_date of redirects.yaml should be nine months in the future.
+        # To not be confused with the remove_date of the Markdown page.
+        #
+        next unless remove_date < today
+
+        puts "In #{filename}, remove date: #{remove_date} is less than today (#{today})."
+
+        counter += 1
+
+        File.delete(filename) if File.exist?(filename)
+
+        # Don't add any entries that are domain-level redirects, they are not supported
+        # https://docs.gitlab.com/ee/user/project/pages/redirects.html
+        next if new_path(frontmatter['redirect_to'], filename, content_dir, slug).start_with?('http')
+
+        File.open(redirects_yaml, 'a') do |post|
+          post.puts "  - from: #{old_path}"
+          post.puts "    to: #{new_path(frontmatter['redirect_to'], filename, content_dir, slug)}"
+          post.puts "    remove_date: #{remove_date >> 9}"
+        end
+
+        # If the 'from' path ends with 'index.html' we need an extra redirect
+        # entry in 'redirects.yaml' that is without 'index.html'
+        next unless old_path.end_with?('index.html')
+
+        File.open(redirects_yaml, 'a') do |post|
+          post.puts "  - from: #{old_path.gsub!('index.html', '')}"
+          post.puts "    to: #{new_path(frontmatter['redirect_to'], filename, content_dir, slug)}"
+          post.puts "    remove_date: #{remove_date >> 9}"
+        end
+      end
+
+      #
+      # If more than one files are found:
+      #
+      #   1. cd into each repository
+      #   2. Create a redirects branch
+      #   3. Add the changed files
+      #   4. Commit and push the branch to create the MR
+      #
+
+      puts "\n#{COLOR_CODE_GREEN}INFO: (#{slug}): Found #{counter} redirect(s).#{COLOR_CODE_RESET}"
+      next unless counter.positive?
+
+      Dir.chdir(content_dir)
+      puts "\n#{COLOR_CODE_GREEN}INFO: (#{slug}): Creating a new branch for the redirects MR..#{COLOR_CODE_RESET}"
+      system("git", "checkout", "--quiet", "-b", redirects_branch, origin_default_branch)
+      puts "\n#{COLOR_CODE_GREEN}INFO: (#{slug}): Committing and pushing to create a merge request..#{COLOR_CODE_RESET}"
+      system("git", "add", ".")
+      system("git", "commit", "--quiet", "-m", commit_message)
+
+      `git push --set-upstream origin #{redirects_branch} -o merge_request.create -o merge_request.remove_source_branch -o merge_request.title="#{mr_title}" -o merge_request.description="#{mr_description}" -o merge_request.label="Technical Writing" -o merge_request.label="documentation" -o merge_request.label="docs::improvement" -o merge_request.label="type::maintenance"` \
+        if ENV['SKIP_MR'].nil?
+
+      Dir.chdir(source_dir)
+      puts
+    end
+
+    #
+    # Finally, create the gitlab-docs MR
+    #
+    #   1. Create a redirects branch
+    #   2. Add the changed files
+    #   3. Commit and push the branch to create the MR
+    #
+    puts "\n#{COLOR_CODE_GREEN}INFO: (gitlab-docs): Creating a new branch for the redirects MR..#{COLOR_CODE_RESET}"
+    system("git", "checkout", "--quiet", "-b", redirects_branch, "origin/main")
+    puts "\n#{COLOR_CODE_GREEN}INFO: (gitlab-docs): Committing and pushing to create a merge request..#{COLOR_CODE_RESET}"
+    system("git", "add", redirects_yaml)
+    system("git", "commit", "--quiet", "-m", commit_message)
+
+    `git push --set-upstream origin #{redirects_branch} -o merge_request.create -o merge_request.remove_source_branch -o merge_request.title="#{mr_title}" -o merge_request.description="#{mr_description}" -o merge_request.label="Technical Writing" -o merge_request.label="redirects" -o merge_request.label="Category:Docs Site" -o merge_request.label="type::maintenance"` \
+      if ENV['SKIP_MR'].nil?
+  end
+end
diff --git a/lib/tasks/release.rake b/lib/tasks/release.rake
new file mode 100644
index 00000000..0d629503
--- /dev/null
+++ b/lib/tasks/release.rake
@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+require './lib/tasks/task_helpers'
+require 'fileutils'
+require "highline/import"
+
+task_helpers = TaskHelpers.new
+
+namespace :release do
+  desc 'Creates a single release archive'
+  task :single, :version do |t, args|
+    version = args.version.to_s
+    source_dir = File.expand_path(__dir__)
+
+    # Disable lefthook because it was causing some PATH errors
+    # https://docs.gitlab.com/ee/development/contributing/style_guides.html#disable-lefthook-temporarily
+    ENV['LEFTHOOK'] = '0'
+
+    raise 'You need to specify a version, like 10.1' unless version.match?(%r{\A\d+\.\d+\z})
+
+    # Check if local branch exists
+    abort("\n#{COLOR_CODE_RED}ERROR: Rake aborted! The branch already exists. Delete it with `git branch -D #{version}` and rerun the task.#{COLOR_CODE_RESET}") \
+      if task_helpers.local_branch_exist?(version)
+
+    # Stash modified and untracked files so we have "clean" environment
+    # without accidentally deleting data
+    puts "\n#{COLOR_CODE_GREEN}INFO: Stashing changes..#{COLOR_CODE_RESET}"
+    `git stash -u` if task_helpers.git_workdir_dirty?
+
+    # Sync with upstream default branch
+    `git checkout #{ENV['CI_DEFAULT_BRANCH']}`
+    `git pull origin #{ENV['CI_DEFAULT_BRANCH']}`
+
+    # Create branch
+    `git checkout -b #{version}`
+
+    # Replace the branches variables in Dockerfile.X.Y
+    dockerfile = "#{source_dir}/#{version}.Dockerfile"
+
+    if File.exist?(dockerfile)
+      abort('rake aborted!') if ask("#{dockerfile} already exists. Do you want to overwrite?", %w[y n]) == 'n'
+    end
+
+    content = File.read('dockerfiles/single.Dockerfile')
+    content.gsub!('X.Y', version)
+    content.gsub!('X-Y', version.tr('.', '-'))
+    content.gsub!('W-Z', task_helpers.chart_version(version).tr('.', '-'))
+
+    File.open(dockerfile, 'w') do |post|
+      post.puts content
+    end
+
+    # Replace the branches variables in .gitlab-ci.yml
+    ci_yaml = "#{source_dir}/.gitlab-ci.yml"
+    ci_yaml_content = File.read(ci_yaml)
+    ci_yaml_content.gsub!("BRANCH_EE: 'master'", "BRANCH_EE: '#{version.tr('.', '-')}-stable-ee'")
+    ci_yaml_content.gsub!("BRANCH_OMNIBUS: 'master'", "BRANCH_OMNIBUS: '#{version.tr('.', '-')}-stable'")
+    ci_yaml_content.gsub!("BRANCH_RUNNER: 'main'", "BRANCH_RUNNER: '#{version.tr('.', '-')}-stable'")
+    ci_yaml_content.gsub!("BRANCH_CHARTS: 'master'", "BRANCH_CHARTS: '#{task_helpers.chart_version(version).tr('.', '-')}-stable'")
+
+    File.open(ci_yaml, 'w') do |post|
+      post.puts ci_yaml_content
+    end
+
+    # Add and commit
+    `git add .gitlab-ci.yml #{version}.Dockerfile`
+    `git commit -m 'Release cut #{version}'`
+
+    puts "\n#{COLOR_CODE_GREEN}INFO: Created new Dockerfile:#{COLOR_CODE_RESET} #{dockerfile}."
+    puts "#{COLOR_CODE_GREEN}INFO: Pushing the new branch. Don't create a merge request!#{COLOR_CODE_RESET}"
+
+    `git push origin #{version}`
+  end
+end
diff --git a/lib/task_helpers.rb b/lib/tasks/task_helpers.rb
index c532c883..9d720021 100644
--- a/lib/task_helpers.rb
+++ b/lib/tasks/task_helpers.rb
@@ -5,6 +5,9 @@ require 'yaml'
 class TaskHelpers
   PRODUCTS = %w[ee omnibus runner charts operator].freeze
   VERSION_FORMAT = %r{^(?<major>\d{1,2})\.(?<minor>\d{1,2})$}.freeze
+  COLOR_CODE_RESET = "\e[0m"
+  COLOR_CODE_RED = "\e[31m"
+  COLOR_CODE_GREEN = "\e[32m"
 
   def config
     # Parse the config file and create a hash.
diff --git a/spec/lib/task_helpers_spec.rb b/spec/lib/task_helpers_spec.rb
index 5bf1a662..bdbd3064 100644
--- a/spec/lib/task_helpers_spec.rb
+++ b/spec/lib/task_helpers_spec.rb
@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require 'task_helpers'
+require './lib/tasks/task_helpers'
 
 describe TaskHelpers do
   describe '#chart_version' do