Module: Octokit::Client::Deployments

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

Overview

Methods for the Deployments API

Instance Method Summary collapse

Instance Method Details

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

Create a deployment for a ref

Parameters:

  • repo (Integer, String, Repository, Hash)

    A GitHub repository

  • ref (String)

    The ref to deploy

  • options (Hash) (defaults to: {})

    a customizable set of options

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.

Returns:

  • (Sawyer::Resource)

    A deployment

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

Parameters:

  • deployment_url (String)

    A URL for a deployment resource

  • state (String)

    The state: pending, success, failure, error

  • options (Hash) (defaults to: {})

    a customizable set of options

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: ""

Returns:

  • (Sawyer::Resource)

    A deployment status

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

Parameters:

  • repo (Integer, String, Repository, Hash)

    A GitHub repository

  • deployment_id (Integer, String, Repository, Hash)

    A GitHub repository

Returns:

  • (No Content)

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

Parameters:

  • repo (Integer, String, Repository, Hash)

    A GitHub repository

  • deployment_id (Integer, String, Repository, Hash)

    A GitHub repository

Returns:

  • (Sawyer::Resource)

    A single deployment

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

Parameters:

  • deployment_url (String)

    A URL for a deployment resource

Returns:

  • (Array<Sawyer::Resource>)

    A list of deployment statuses

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])
  paginate(deployment.rels[:statuses].href, options)
end

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

List all deployments for a repository

Parameters:

  • repo (Integer, String, Repository, Hash)

    A GitHub repository

Returns:

  • (Array<Sawyer::Resource>)

    A list of deployments

See Also:



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

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