robopigeon 0.1.0

data/lib/robopigeon/jira/ticket.rb

@@ -0,0 +1,186 @@
+require 'json'
+
+module RoboPigeon::Jira
+  class Ticket
+    MAX_TRANSITIONS = 10
+    ISSUE_PATH = '/rest/api/2/issue'.freeze
+    attr_accessor :ticket, :project, :issue_type, :summary, :fields,
+                  :assignee, :reporter, :description
+
+    def initialize(ticket = nil)
+      self.ticket = ticket
+      self.fields = {}
+      update_from_server
+      self.project = ticket.split('-')[0] if ticket
+    end
+
+    def update_from_server
+      return unless ticket
+
+      get = jira_request.get("#{ISSUE_PATH}/#{ticket}/")
+      raise "Failed to look up issue #{ticket}" unless get.status < 400
+
+      raw = JSON.parse(get.body)
+      self.project = raw['fields']['project']['key']
+      self.issue_type = raw['fields']['issuetype']['name']
+      self.summary = raw['fields']['summary']
+      self.reporter = raw['fields']['reporter']['name'] if raw['fields']['reporter']
+      self.assignee = raw['fields']['assignee']['name'] if raw['fields']['assignee']
+    end
+
+    def jira_request
+      RoboPigeon::Jira::Client.jira_request
+    end
+
+    def create!
+      response = jira_request.post do |req|
+        req.url '/rest/api/2/issue'
+        req.body = {
+          fields: {
+            project: { key: project },
+            issuetype: { name: issue_type },
+            summary: summary,
+            description: description,
+            assignee: { name: reporter }
+          }.merge(fields)
+        }.to_json
+      end
+
+      begin
+        self.ticket = JSON.parse(response.body).fetch('key')
+        RoboPigeon::Jira::Client.last_created_ticket = ticket
+      rescue KeyError
+        raise RoboPigeon::Jira::RequiredFieldNotSet, "Response from JIRA did not contain new issue key: #{response.body}"
+      end
+    end
+
+    def assign(user_email)
+      user_data = jira_request.get("/rest/api/2/user/search?username=#{user_email}")
+      user = JSON.parse(user_data.body).first
+      raise "Unable to find jira user with email #{user_email}" unless user
+
+      self.assignee = user['name']
+      self.reporter ||= user['name']
+
+      if ticket
+        jira_request.post do |req|
+          req.url "/rest/api/3/issue/#{ticket}/assignee"
+          req.body = { name: assignee }.to_json
+        end
+      end
+    end
+
+    def set_reporter(user_email)
+      raise 'Cannot modify reporter' if ticket
+
+      user_data = jira_request.get("/rest/api/2/user/search?username=#{user_email}")
+      user = JSON.parse(user_data.body).first
+      raise "Unable to find jira user with email #{user_email}" unless user
+
+      self.reporter = user['name']
+    end
+
+    def description_from_template(_file)
+      self.description = 'Content from an erb template'
+    end
+
+    def set_field(name, value)
+      require_field(:issue_type)
+      request_path = "#{ISSUE_PATH}/createmeta?projectKeys=#{project}&expand=projects.issuetypes.fields"
+      response = jira_request.get(request_path)
+      raw = JSON.parse(response.body)
+      fields = raw['projects'].first['issuetypes'].select do |it|
+        it['name'] == issue_type
+      end.first['fields']
+      field = fields.keys.select do |key|
+        fields[key]['name'] == name
+      end.first
+
+      raise "Field #{name} was not found" unless field
+
+      self.fields[field] = if fields[field]['allowedValues'].nil?
+                             value
+                           else
+                             { value: value }
+                           end
+
+      if ticket
+        post = jira_request.put do |req|
+          req.url "#{ISSUE_PATH}/#{ticket}/"
+          req.body = { fields: self.fields }.to_json
+        end
+      end
+
+      raise 'Failed to update field' unless post.nil? || post.status < 400
+    end
+
+    def set_issuetype(name)
+      require_field(:project)
+      request_path = "#{ISSUE_PATH}/createmeta?projectKeys=#{project}&expand=projects.issuetypes.fields"
+      response = jira_request.get(request_path)
+      raw = JSON.parse(response.body)
+      types = raw['projects'].first['issuetypes'].map { |type| type['name'] }
+      raise RoboPigeon::Jira::FieldDoesNotConform, "Issue type #{name} was not found in #{types.join(', ')}" unless types.include?(name)
+
+      self.issue_type = name
+    end
+
+    def perform_transition(transition)
+      require_ticket
+      get_fields = jira_request.get("#{ISSUE_PATH}/#{ticket}/transitions?expand=transitions.fields")
+      transition_details = JSON.parse(get_fields.body)['transitions'].find do |trans|
+        trans['name'].casecmp(transition).zero?
+      end
+      raise "Unable to find valid transition '#{transition}'" unless transition_details
+
+      jira_request.post do |req|
+        req.url "#{ISSUE_PATH}/#{ticket}/transitions"
+        req.body = { transition: { id: transition_details['id'] } }.to_json
+      end
+    end
+
+    def current_state
+      require_ticket
+      get = jira_request.get do |req|
+        req.url "#{ISSUE_PATH}/#{ticket}/"
+      end
+      JSON.parse(get.body)['fields']['status']['name']
+    end
+
+    def wait_for_state!(state, timeout=10.minutes, time=Time.now, sleep_time=15)
+      require_ticket
+      waited = (Time.now - time).to_i
+      minutes = waited / 60
+      seconds = waited % 60
+      if current_state == state
+        puts "#{ticket} in #{state} after #{minutes} minutes #{seconds} seconds"
+        return
+      end
+      raise RoboPigeon::Jira::WaitTimeout, "Timed out waiting for #{ticket} to transition to #{state} after #{minutes} minutes #{seconds} seconds" if (timeout.to_i - waited) <= 0
+
+      puts "Still waiting for #{ticket} in #{state}... waited #{minutes} minutes #{seconds} seconds"
+      sleep sleep_time
+      wait_for_state!(state, timeout, time, sleep_time)
+    end
+
+    def add_comment(comment)
+      require_ticket
+
+      post = jira_request.post do |req|
+        req.url "#{ISSUE_PATH}/#{ticket}/comment"
+        req.body = { body: comment }.to_json
+      end
+      raise 'Failed to create comment' unless post.status == 201
+    end
+
+    private
+
+    def require_ticket
+      raise RoboPigeon::Jira::TicketNotFoundOrSet, 'Ticket was not set!' if ticket.nil?
+    end
+
+    def require_field(field)
+      raise RoboPigeon::Jira::RequiredFieldNotSet, "You must set a #{field}" if send(field).nil?
+    end
+  end
+end

data/lib/robopigeon/jira/ticket_dsl.rb

@@ -0,0 +1,155 @@
+module RoboPigeon::Dsl
+  class JiraTicket
+    include RoboPigeon::Dsl::Helpers
+    attr_accessor :ticket
+
+    def self.run(ticket_number = nil, &block)
+      ticket = RoboPigeon::Jira::Ticket.new(ticket_number)
+      jira = RoboPigeon::Dsl::JiraTicket.new
+      jira.ticket = ticket
+      jira.instance_eval(&block)
+      jira.ticket.create! unless jira.ticket.ticket
+      ticket
+    end
+
+    RoboPigeon::Documentarian.add_command(
+      'assign',
+      block: %w[job jira ticket],
+      params: [
+        { name: 'email', type: 'String', desc: 'the email address for the person to assign the ticket to', example: 'someone@example.com' }
+      ],
+      desc: 'assign the ticket to a person by email address'
+    )
+    def assign(email)
+      ticket.assign(email)
+    end
+
+    RoboPigeon::Documentarian.add_command(
+      'reporter',
+      block: %w[job jira ticket],
+      params: [
+        { name: 'email', type: 'String', desc: 'the email address for the person to reporter the ticket to', example: 'someone@example.com' }
+      ],
+      desc: 'reporter the ticket to a person by email address'
+    )
+    def reporter(email)
+      ticket.set_reporter(email)
+    end
+
+    RoboPigeon::Documentarian.add_command(
+      'comment',
+      block: %w[job jira ticket],
+      params: [
+        { name: 'comment', type: 'String', desc: 'the comment to add to the ticket', example: 'A string comment' }
+      ],
+      desc: 'add a comment to the ticket'
+    )
+    def comment(comment)
+      ticket.add_comment(comment)
+    end
+
+    RoboPigeon::Documentarian.add_command(
+      'project',
+      block: %w[job jira ticket],
+      params: [
+        { name: 'project_key', type: 'String', desc: 'the key for the project you want to create the ticket in', example: 'TIC' }
+      ],
+      desc: 'set which project you want to create the ticket in (only used when creating)'
+    )
+    def project(project_key)
+      ticket.project = project_key
+    end
+
+    RoboPigeon::Documentarian.add_command(
+      'summary',
+      block: %w[job jira ticket],
+      params: [
+        { name: 'title', type: 'String', desc: 'title summary for your issue', example: 'A Bug has happend!' }
+      ],
+      desc: 'set the issue summary (only used in creation, use the field funtion for updates)'
+    )
+    def summary(title)
+      ticket.summary = title
+    end
+
+    RoboPigeon::Documentarian.add_command(
+      'description',
+      block: %w[job jira ticket],
+      params: [
+        { name: 'text', type: 'String', desc: 'the main body of a new issue', example: 'Lots of content in here' }
+      ],
+      desc: 'Set the main body of the issue here, only used in creation, use the field function to update'
+    )
+    def description(text)
+      ticket.description = text
+    end
+
+    RoboPigeon::Documentarian.add_command(
+      'issuetype',
+      block: %w[job jira ticket],
+      params: [
+        { name: 'type', type: 'String', desc: 'name of the issue type', example: 'Story' }
+      ],
+      desc: 'sets the issue type to use when creating a ticket'
+    )
+    def issuetype(type)
+      ticket.set_issuetype type
+    end
+
+    RoboPigeon::Documentarian.add_command(
+      'create!',
+      block: %w[job jira ticket],
+      desc: 'creates the configured ticket and returns the id'
+    )
+    def create!
+      ticket.create!
+      ticket.ticket
+    end
+
+    RoboPigeon::Documentarian.add_command(
+      'field',
+      block: %w[job jira ticket],
+      params: [
+        { name: 'field_name', type: 'String', desc: 'the name of the field you want to set', example: 'duedate' },
+        { name: 'field_value', type: 'String', desc: 'what to set that field to', example: '2/10/2030' }
+      ],
+      desc: 'set or update a field to a value'
+    )
+    def field(name, value)
+      ticket.set_field(name, value)
+    end
+
+    RoboPigeon::Documentarian.add_command(
+      'print_id',
+      block: %w[job jira ticket],
+      desc: 'print the ticket number to standard out (only for already created tickets)'
+    )
+    def print_id
+      puts ticket.ticket.to_s
+    end
+
+    RoboPigeon::Documentarian.add_command(
+      'transition',
+      block: %w[job jira ticket],
+      params: [
+        { name: 'transition_name', type: 'String', desc: 'the name of the transition to run', example: 'Ready' }
+      ],
+      desc: 'transition a ticket to a new state'
+    )
+    def transition(name)
+      ticket.perform_transition(name)
+    end
+
+    RoboPigeon::Documentarian.add_command(
+      'wait_for_state',
+      block: %w[job jira ticket],
+      params: [
+        { name: 'state_name', type: 'String', desc: 'the name of the state to wait for', example: 'Approved' }
+      ],
+      desc: 'block execution waiting for a state transition'
+    )
+    def wait_for_state(transition_state)
+      ticket.wait_for_state!(transition_state)
+    end
+  end
+end

data/lib/robopigeon/jira.rb

@@ -0,0 +1,37 @@
+RoboPigeon::Documentarian.add_block('jira', helpers: true, block: [], desc: 'a configuration block for jira')
+RoboPigeon::Documentarian.add_block('jira', helpers: true, block: ['job'], desc: 'configure a jira ticket manipulation, sends on end, can have multiple')
+
+require 'robopigeon/jira/client'
+require 'robopigeon/jira/helper_dsl'
+require 'robopigeon/jira/dsl'
+require 'robopigeon/jira/ticket'
+require 'robopigeon/jira/ticket_dsl'
+
+module RoboPigeon::Jira
+  class TicketNotFoundOrSet < StandardError; end
+  class RequiredFieldNotSet < StandardError; end
+  class FieldDoesNotConform < StandardError; end
+  class WaitTimeout < StandardError; end
+end
+
+module RoboPigeon::Dsl
+  module Helpers
+    include RoboPigeon::Dsl::Helpers::Jira
+  end
+end
+
+module RoboPigeon::Dsl
+  class Root
+    def jira(&block)
+      RoboPigeon::Dsl::JiraRoot.run(&block)
+    end
+  end
+end
+
+module RoboPigeon::Dsl
+  class Job
+    def jira(&block)
+      RoboPigeon::Dsl::Jira.run(&block)
+    end
+  end
+end

data/lib/robopigeon/markdown/helper_dsl.rb

@@ -0,0 +1,73 @@
+require 'erb'
+require 'markdown2confluence'
+require 'kramdown/converter/slack'
+
+module RoboPigeon::Dsl
+  module Helpers
+    module Markdown
+      RoboPigeon::Documentarian.add_command(
+        'confluence_from_md',
+        params: [
+          { name: 'file', type: 'String', desc: 'path to a markdown erb file', example: 'config/wiki-page-template.erb.md' }
+        ],
+        block: ['helpers'],
+        desc: 'get jira/confluence markup from an erb markdown template'
+      )
+      def confluence_from_md(file)
+        from_md_template(file).to_confluence
+      end
+
+      RoboPigeon::Documentarian.add_command(
+        'jira_from_md',
+        params: [
+          { name: 'file', type: 'String', desc: 'path to a markdown erb file', example: 'config/issue-template.erb.md' }
+        ],
+        block: ['helpers'],
+        desc: 'get jira/confluence markup from an erb markdown template'
+      )
+      def jira_from_md(file)
+        from_md_template(file).to_confluence
+      end
+
+      RoboPigeon::Documentarian.add_command(
+        'html_from_md',
+        params: [
+          { name: 'file', type: 'String', desc: 'path to a markdown erb file', example: 'config/results-template.erb.md' }
+        ],
+        block: ['helpers'],
+        desc: 'get html markup from an erb markdown template'
+      )
+      def html_from_md(file)
+        from_md_template(file).to_html
+      end
+
+      RoboPigeon::Documentarian.add_command(
+        'slack_from_md',
+        params: [
+          { name: 'file', type: 'String', desc: 'path to a markdown erb file', example: 'config/message-template.erb.md' }
+        ],
+        block: ['helpers'],
+        desc: 'get slack markup from an erb markdown template'
+      )
+      def slack_from_md(file)
+        from_md_template(file).to_slack
+      end
+
+      private
+
+      def from_md_template(file)
+        raise RoboPigeon::Markdown::Error, "template file #{file} not found" unless File.exist?(file)
+
+        raw = File.read(file)
+        markdown = ERB.new(raw).result(binding)
+        Kramdown::Document.new(markdown,
+                               input: 'GFM',
+                               syntax_highlighter: 'coderay',
+                               syntax_highlighter_opts: {
+                                 css: 'style',
+                                 line_numbers: 'table'
+                               })
+      end
+    end
+  end
+end

data/lib/robopigeon/markdown.rb

@@ -0,0 +1,11 @@
+require 'robopigeon/markdown/helper_dsl'
+
+module RoboPigeon::Markdown
+  class Error < StandardError; end
+end
+
+module RoboPigeon::Dsl
+  module Helpers
+    include RoboPigeon::Dsl::Helpers::Markdown
+  end
+end

data/lib/robopigeon/resources/initial_robopigeon.rb

@@ -0,0 +1,156 @@
+slack do
+  # Slack is currently disabled, make sure you have a valid bot token, then remove
+  # the following line
+  enabled false
+  # This is where you configure your global slack preferences, like bot name and api key
+  # You should always keep the api key either encrypted with something like `encryptatron`
+  # or in a ci environment variable (which is probably better)
+  api_key ENV['SLACK_API_KEY']
+  name 'RoboPigeon'
+end
+
+gitlab do
+  # GitLab is currently disabled, make sure you have a valid api token with acces to
+  # to your repo, then remove the following line
+  enabled false
+  # This is where you configure your global gitlab settings, like api url and api key
+  # always keep your api key either in an environment variable or encrypted with something
+  # something like `encryptatron` or rails secrets.
+  api_url ENV['CI_API_V4_URL']
+  api_key ENV['GITLAB_API_KEY'] # Always use an envrionment variable, don't check in secrets.
+end
+
+jira do
+  # Jira is currently disabled, make sure you have a valid api token with acces to
+  # to your repo, then remove the following line
+  enabled false
+  # This is where you configure your global jira settings, like api url and api token
+  # always keep your api key either in an environment variable or encrypted with
+  # something like `encryptatron` or rails secrets.
+  api_url ENV['JIRA_API_URL']
+  api_key ENV['JIRA_API_TOKEN'] # Always use an envrionment variable, don't check in secrets.
+end
+
+job 'deploy_complete', 'Notify slack and comment in gitlab that a deploy is complete' do
+  # This configures a slack notification, at the end of the block it sends to
+  # the users and channels in the body. Un-comment the channels and fill in the
+  # appropriate ones to have them sent there.
+  slack do
+    # channel '#your-team-channel'
+    # channel '#your-release-notifications-channel'
+    user ENV['GITLAB_USER_EMAIL']
+    # `git_committer_email` looks at the commit log and returns the email address
+    # for the last person to make a non-merge commit
+    user git_committer_email
+    # `git_merger_email` looks at the commit log and returns the email address
+    # for the last person to make a merge commit
+    user git_merger_email
+    # This configures the overall message to send, it comes first, before attachments.
+    # If you want to send multiple messages, you can use attachments with pretext in them
+    # It's not actually required to that you set a message in order to send attachments
+    message "#{slack_user_for(ENV['GITLAB_USER_EMAIL'])} deployed #{ENV['CI_PROJECT_NAME']} #{ENV['CI_COMMIT_TAG']} to #{ENV['CI_ENVIRONMENT_NAME']}"
+    attachment do
+      # You have to set a fallback text for the actions
+      fallback "<#{ENV['CI_PIPELINE_URL']}|Pipeline>"
+      # Actions show up as little buttons under the message, this one will be
+      # a green button that links to the pipeline.
+      action 'button', 'Pipeline', ENV['CI_PIPELINE_URL'], 'primary'
+      action 'button', 'Rollback', "#{ENV['CI_PROJECT_URL']}/environments", 'danger'
+      color 'good'
+    end
+  end
+
+  # This configures an action taken in gitlab. In this case, we're saying to use
+  # the last branch merged into this one as the branch name, and then comment on
+  # each merge request with that branch that someone has started deploying
+  gitlab do
+    merge_request_comment "#{ENV['GITLAB_USER_EMAIL']} deployed branch", git_branch_merged_source
+  end
+
+  # This configures an action taken in jira, In this case, we're looping over all
+  # of the tickets since the last deployment, and then adding a comment to them
+  # with what version it was released in.
+  jira do
+    # This helper gets all of the tickets referenced in the git log since the last
+    # deployment to the referenced environment, that contain the provided key
+    tickets_in_log_since_deployment_to('production', 'TIC').each do |ticket_id|
+      # Then it comments on them with the project that was deployed and the version
+      ticket ticket_id do
+        # Then it comments on them with the project that was deployed and the version
+        comment "#{ENV['CI_PROJECT_NAME']} had changes related to this deployed to production in version #{ENV['CI_COMMIT_TAG']}"
+        # Runs a transition called 'Release'
+        transition 'Release'
+        # and sets the fix version to the tag of the deployment
+        field 'Fix Version', ENV['CI_COMMIT_TAG']
+      end
+    end
+  end
+end
+
+# This example job creates a ticket, assignes it to whoever runs the pipeline, and
+# then sends them a slack message with the id of the ticket
+job 'create ticket' do
+  jira do
+    ticket do
+      # Set the project key
+      project 'PIG'
+      # Set the issue type
+      issuetype 'Bug'
+      # Set the summary of the ticket
+      summary 'Detecetd a defect! Fix it!'
+      # Assign the ticket to the user who is running the pipeline
+      assign ENV['GITLAB_USER_EMAIL']
+      # Set a description from a file template, that template can
+      # use any of the other dsl helpers like the git or deployment
+      # operations
+      description jira_from_md('path/to/file.erb.md')
+      # Create the ticket and store the id in a global variable
+      create!
+      # Print out the ticket number for logging/deubgging
+      puts 'Created ticket:'
+      print_id
+    end
+  end
+
+  slack do
+    user ENV['GITLAB_USER_EMAIL']
+    message "Created #{jira_last_created_ticket_slack_link}"
+  end
+end
+
+# Below are a number of pre-configured jobs that some people find useful!
+job 'deploy_started', 'Notfiy slack and comment in gitlab that a deploy is starting' do
+  slack do
+    user ENV['GITLAB_USER_EMAIL']
+    user git_committer_email
+    user git_merger_email
+    message "#{slack_user_for(ENV['GITLAB_USER_EMAIL'])} deployed #{ENV['CI_PROJECT_NAME']} #{ENV['CI_COMMIT_TAG']} to #{ENV['CI_ENVIRONMENT_NAME']}"
+    attachment do
+      fallback "<#{ENV['CI_PIPELINE_URL']}|Pipeline>"
+      action 'button', 'Pipeline', ENV['CI_PIPELINE_URL'], 'primary'
+      color 'good'
+    end
+  end
+
+  gitlab do
+    merge_request_comment "#{ENV['GITLAB_USER_EMAIL']} has started deyploying this branch", git_branch_merged_source
+  end
+end
+
+job 'notify_failure', 'Notify slack and gitlab that a job has failed' do
+  slack do
+    # channel '#your-team-channel'
+    user ENV['GITLAB_USER_EMAIL']
+    user git_committer_email
+    attachment do
+      fallback "#{ENV['CI_PROJECT_NAME']} - #{ENV['CI_COMMIT_REF_NAME']} has a failure - <#{ENV['CI_PIPELINE_URL']}|Pipeline>"
+      title "#{ENV['CI_PROJECT_NAME']} - #{ENV['CI_COMMIT_REF_NAME']} has a failure"
+      action 'button', 'Pipeline', ENV['CI_PIPELINE_URL'], 'primary'
+      color 'danger'
+    end
+  end
+
+  gitlab do
+    merge_request_comment "The branch from this merge request has a failure - ENV['CI_PIPELINE_URL']", git_branch_merged_source
+  end
+end

data/lib/robopigeon/slack/attachments_dsl.rb

@@ -0,0 +1,63 @@
+module RoboPigeon::Dsl
+  class SlackAttachment
+    include RoboPigeon::Dsl::Helpers
+    attr_accessor :attachment
+
+    def initialize
+      self.attachment = { actions: [] }
+    end
+
+    def self.run(&block)
+      attachment = RoboPigeon::Dsl::SlackAttachment.new
+      attachment.instance_eval(&block)
+      attachment.attachment
+    end
+
+    private
+
+    RoboPigeon::Documentarian.add_command('fallback', block: %w[job slack attachment], params: [{ name: 'text', type: 'String', desc: 'a string message', example: 'This message is displayed when the client does not support attachments' }], desc: 'Add a fallback message for clients that do not support actions')
+    def fallback(text)
+      attachment[:fallback] = text
+    end
+
+    RoboPigeon::Documentarian.add_command('title', block: %w[job slack attachment], params: [{ name: 'title', type: 'String', desc: 'the title of the attachment', example: 'Job Failed!' }], desc: 'Add a title to your attachment')
+    def title(title)
+      attachment[:title] = title
+    end
+
+    RoboPigeon::Documentarian.add_command('title_linke', block: %w[job slack attachment], params: [{ name: 'link', type: 'String', desc: 'a url', example: 'https://gitlab.com/robopigeon/robopigeon/pipelines' }], desc: 'Add a link to the title so that users can click on it')
+    def title_link(title_link)
+      attachment[:title_link] = title_link
+    end
+
+    RoboPigeon::Documentarian.add_command('pretext', block: %w[job slack attachment], params: [{ name: 'text', type: 'String', desc: 'a string message', example: 'This message shows up before rest of the attachment' }], desc: 'Add a message that shows up just before your attachment')
+    def pretext(text)
+      attachment[:pretext] = text
+    end
+
+    RoboPigeon::Documentarian.add_command('color', block: %w[job slack attachment], params: [{ name: 'color', type: 'String', desc: 'a color, hex or something', example: 'danger' }], desc: 'Change the color of the bar next to your attachment')
+    def color(color)
+      attachment[:color] = color
+    end
+
+    RoboPigeon::Documentarian.add_command(
+      'action',
+      block: %w[job slack attachment],
+      params: [
+        { name: 'type', type: 'String', desc: 'Currently only supports `button`', example: 'button' },
+        { name: 'text', type: 'String', desc: 'Field label', example: 'Pipeline' },
+        { name: 'url', type: 'String', desc: 'Url to link to', example: 'https://gitlab.com/robopigeon/robopigeon/pipelines' },
+        { name: 'style', type: 'String', desc: 'button style, can be danger or primary', example: 'danger', defaut: 'nil' }
+      ],
+      desc: 'Add a Url linked button to your bot'
+    )
+    def action(type, text, url, style=nil)
+      attachment[:actions].push(
+        type: type,
+        text: text,
+        url: url,
+        style: style
+      )
+    end
+  end
+end