Module: Octokit::Client::Deployments

Included in:
Octokit::Client
Defined in:
lib/octokit/client/deployments.rb

Overview

Methods for the Deployments API

See Also:

Instance Method Summary collapse

Instance Method Details

#create_deployment(repo, ref, options = {}) ⇒ Sawyer::Resource

Create a deployment for a ref

Options Hash (options):

  • :task (String) —

    Used by the deployment system to allow different execution paths. Defaults to “deploy”.

  • :payload (String) —

    Meta info about the deployment

  • :auto_merge (Boolean) —

    Optional parameter to merge the default branch into the requested deployment branch if necessary. Default: true

  • :required_contexts (Array<String>) —

    Optional array of status contexts verified against commit status checks.

  • :environment (String) —

    Optional name for the target deployment environment (e.g., production, staging, qa). Default: “production”

  • :description (String) —

    Optional short description.

See Also:



41
42
43
44
 
# File 'lib/octokit/client/deployments.rb', line 41

def create_deployment(repo, ref, options = {})
  options[:ref] = ref
  post("#{Repository.path repo}/deployments", options)
end

#create_deployment_status(deployment_url, state, options = {}) ⇒ Sawyer::Resource

Create a deployment status for a Deployment

Options Hash (options):

  • :target_url (String) —

    The target URL to associate with this status. Default: “”

  • :description (String) —

    A short description of the status. Maximum length of 140 characters. Default: “”

See Also:



75
76
77
78
79
 
# File 'lib/octokit/client/deployments.rb', line 75

def create_deployment_status(deployment_url, state, options = {})
  deployment = get(deployment_url, accept: options[:accept])
  options[:state] = state.to_s.downcase
  post(deployment.rels[:statuses].href, options)
end

#delete_deployment(repo, deployment_id, options = {}) ⇒ No Content

Delete a Deployment

See Also:



52
53
54
 
# File 'lib/octokit/client/deployments.rb', line 52

def delete_deployment(repo, deployment_id, options = {})
  delete("#{Repository.path repo}/deployments/#{deployment_id}", options)
end

#deployment(repo, deployment_id, options = {}) ⇒ Sawyer::Resource

Fetch a single deployment for a repository

See Also:



15
16
17
 
# File 'lib/octokit/client/deployments.rb', line 15

def deployment(repo, deployment_id, options = {})
  get("#{Repository.path repo}/deployments/#{deployment_id}", options)
end

#deployment_statuses(deployment_url, options = {}) ⇒ Array<Sawyer::Resource> Also known as: list_deployment_statuses

List all statuses for a Deployment

See Also:



61
62
63
64
 
# File 'lib/octokit/client/deployments.rb', line 61

def deployment_statuses(deployment_url, options = {})
  deployment = get(deployment_url, accept: options[:accept])
  get(deployment.rels[:statuses].href, options)
end

#deployments(repo, options = {}) ⇒ Array<Sawyer::Resource> Also known as: list_deployments

List all deployments for a repository

See Also:



24
25
26
 
# File 'lib/octokit/client/deployments.rb', line 24

def deployments(repo, options = {})
  get("#{Repository.path repo}/deployments", options)
end