Module: Gitlab::Client::PipelineTriggers

Included in:
Gitlab::Client
Defined in:
lib/gitlab/client/pipeline_triggers.rb

Overview

Defines methods related to pipelines.

Instance Method Summary collapse

Instance Method Details

#create_trigger(project, description) ⇒ Gitlab::ObjectifiedHash

Create a pipeline trigger for a project.

Examples:

Gitlab.create_trigger(5, description: "my description")


37
38
39
# File 'lib/gitlab/client/pipeline_triggers.rb', line 37

def create_trigger(project, description)
  post("/projects/#{url_encode project}/triggers", body: {description: description})
end

#remove_trigger(project, trigger_id) ⇒ void Also known as: delete_trigger

This method returns an undefined value.

Remove a project’s pipeline trigger.

Examples:

Gitlab.remove_trigger(5, 1)


75
76
77
# File 'lib/gitlab/client/pipeline_triggers.rb', line 75

def remove_trigger(project, trigger_id)
  delete("/projects/#{url_encode project}/triggers/#{trigger_id}")
end

#run_trigger(project, token, ref, variables = {}) ⇒ Gitlab::ObjectifiedHash

Run the given project pipeline trigger.

Examples:

Gitlab.trigger_build(5, '7b9148c158980bbd9bcea92c17522d', 'master')
Gitlab.trigger_build(5, '7b9148c158980bbd9bcea92c17522d', 'master', { variable1: "value", variable2: "value2" })

See Also:



93
94
95
96
97
98
99
# File 'lib/gitlab/client/pipeline_triggers.rb', line 93

def run_trigger(project, token, ref, variables={})
  post("/projects/#{url_encode project}/trigger/pipeline", unauthenticated: true, body: {
    token: token,
    ref: ref,
    variables: variables
  })
end

#trigger(project, trigger_id) ⇒ Gitlab::ObjectifiedHash

Gets details of project’s pipeline trigger.

Examples:

Gitlab.trigger(5, 1)


25
26
27
# File 'lib/gitlab/client/pipeline_triggers.rb', line 25

def trigger(project, trigger_id)
  get("/projects/#{url_encode project}/triggers/#{trigger_id}")
end

#trigger_take_ownership(project, trigger_id) ⇒ Gitlab::ObjectifiedHash

Take ownership of a project trigger

Examples:

Gitlab.trigger_take_ownership(5, 1)


63
64
65
# File 'lib/gitlab/client/pipeline_triggers.rb', line 63

def trigger_take_ownership(project, trigger_id)
  post("/projects/#{url_encode project}/triggers/#{trigger_id}/take_ownership")
end

#triggers(project) ⇒ Array<Gitlab::ObjectifiedHash>

Gets a list of the project’s pipeline triggers

Examples:

Gitlab.triggers(5)


13
14
15
# File 'lib/gitlab/client/pipeline_triggers.rb', line 13

def triggers(project)
  get("/projects/#{url_encode project}/triggers")
end

#update_trigger(project, trigger_id, options = {}) ⇒ Gitlab::ObjectifiedHash

Update a project trigger

Examples:

Gitlab.update_trigger(5, 1, description: "my description")

Options Hash (options):

  • :description (String)

    The trigger name.



51
52
53
# File 'lib/gitlab/client/pipeline_triggers.rb', line 51

def update_trigger(project, trigger_id, options={})
  put("/projects/#{url_encode project}/triggers/#{trigger_id}", body: options)
end