2017-09-07 11:43:20 -04:00
|
|
|
#!/usr/bin/env ruby
|
|
|
|
|
|
|
|
require 'gitlab'
|
|
|
|
|
|
|
|
#
|
|
|
|
# Configure credentials to be used with gitlab gem
|
|
|
|
#
|
|
|
|
Gitlab.configure do |config|
|
|
|
|
config.endpoint = 'https://gitlab.com/api/v4'
|
|
|
|
config.private_token = ENV["DOCS_API_TOKEN"] # GitLab Docs bot access token which has only Developer access to gitlab-docs
|
|
|
|
end
|
|
|
|
|
2017-09-19 07:30:44 -04:00
|
|
|
#
|
|
|
|
# The remote docs project
|
|
|
|
#
|
|
|
|
GITLAB_DOCS_REPO = 'gitlab-com/gitlab-docs'.freeze
|
|
|
|
|
|
|
|
#
|
|
|
|
# Truncate the remote docs branch name if it's more than 63 characters
|
|
|
|
# otherwise we hit the filesystem limit and the directory name where
|
|
|
|
# NGINX serves the site won't match the branch name.
|
|
|
|
#
|
|
|
|
def docs_branch
|
|
|
|
# The maximum string length a file can have on a filesystem (ext4)
|
|
|
|
# is 63 characters. Let's use something smaller to be 100% sure.
|
|
|
|
max = 42
|
|
|
|
# Prefix the remote branch with 'preview-' in order to avoid
|
|
|
|
# name conflicts in the rare case the branch name already
|
|
|
|
# exists in the docs repo and truncate to max length.
|
|
|
|
"preview-#{ENV["CI_COMMIT_REF_SLUG"]}"[0...max]
|
|
|
|
end
|
|
|
|
|
2017-09-07 11:43:20 -04:00
|
|
|
#
|
|
|
|
# Create a remote branch in gitlab-docs
|
|
|
|
#
|
|
|
|
def create_remote_branch
|
2017-09-19 07:30:44 -04:00
|
|
|
Gitlab.create_branch(GITLAB_DOCS_REPO, docs_branch, 'master')
|
|
|
|
puts "Remote branch '#{docs_branch}' created"
|
2017-09-07 13:21:47 -04:00
|
|
|
rescue Gitlab::Error::BadRequest
|
2017-09-19 07:30:44 -04:00
|
|
|
puts "Remote branch '#{docs_branch}' already exists"
|
2017-09-07 11:43:20 -04:00
|
|
|
end
|
|
|
|
|
|
|
|
#
|
|
|
|
# Remove a remote branch in gitlab-docs
|
|
|
|
#
|
|
|
|
def remove_remote_branch
|
2017-09-19 07:30:44 -04:00
|
|
|
Gitlab.delete_branch(GITLAB_DOCS_REPO, docs_branch)
|
|
|
|
puts "Remote branch '#{docs_branch}' deleted"
|
2017-09-07 11:43:20 -04:00
|
|
|
end
|
|
|
|
|
2017-11-15 07:05:53 -05:00
|
|
|
#
|
|
|
|
# Define suffix in review app URL based on project
|
|
|
|
#
|
|
|
|
def slug
|
|
|
|
case ENV["CI_PROJECT_NAME"]
|
|
|
|
when 'gitlab-ce'
|
|
|
|
'ce'
|
|
|
|
when 'gitlab-ee'
|
|
|
|
'ee'
|
|
|
|
when 'gitlab-runner'
|
|
|
|
'runner'
|
|
|
|
when 'omnibus-gitlab'
|
|
|
|
'omnibus'
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
#
|
|
|
|
# Overriding vars in https://gitlab.com/gitlab-com/gitlab-docs/blob/master/.gitlab-ci.yml
|
|
|
|
#
|
|
|
|
def param_name
|
|
|
|
"BRANCH_#{slug.upcase}"
|
|
|
|
end
|
|
|
|
|
2017-09-07 11:43:20 -04:00
|
|
|
#
|
|
|
|
# Trigger a pipeline in gitlab-docs
|
|
|
|
#
|
|
|
|
def trigger_pipeline
|
|
|
|
# The review app URL
|
2017-11-15 07:05:53 -05:00
|
|
|
app_url = "http://#{docs_branch}.#{ENV["DOCS_REVIEW_APPS_DOMAIN"]}/#{slug}"
|
2017-09-07 11:43:20 -04:00
|
|
|
|
|
|
|
# Create the pipeline
|
|
|
|
puts "=> Triggering a pipeline..."
|
2017-09-19 07:30:44 -04:00
|
|
|
pipeline = Gitlab.run_trigger(GITLAB_DOCS_REPO, ENV["CI_JOB_TOKEN"], docs_branch, { param_name => ENV["CI_COMMIT_REF_NAME"] })
|
2017-09-07 11:43:20 -04:00
|
|
|
|
|
|
|
puts "=> Pipeline created:"
|
|
|
|
puts ""
|
|
|
|
puts "https://gitlab.com/gitlab-com/gitlab-docs/pipelines/#{pipeline.id}"
|
|
|
|
puts ""
|
|
|
|
puts "=> Preview your changes live at:"
|
|
|
|
puts ""
|
|
|
|
puts app_url
|
|
|
|
puts ""
|
|
|
|
end
|
|
|
|
|
|
|
|
#
|
|
|
|
# When the first argument is deploy then create the branch and trigger pipeline
|
|
|
|
# When it is 'stop', it deleted the remote branch. That way, we ensure there
|
|
|
|
# are no stale remote branches and the Review server doesn't fill.
|
|
|
|
#
|
|
|
|
case ARGV[0]
|
|
|
|
when 'deploy'
|
|
|
|
create_remote_branch
|
|
|
|
trigger_pipeline
|
|
|
|
when 'cleanup'
|
|
|
|
remove_remote_branch
|
2017-09-19 07:30:44 -04:00
|
|
|
else
|
|
|
|
puts "Please provide a valid option:
|
|
|
|
deploy - Creates the remote branch and triggers a pipeline
|
|
|
|
cleanup - Deletes the remote branch and stops the Review App"
|
2017-09-07 11:43:20 -04:00
|
|
|
end
|