README.md

Telegram resource

Telegram notification resource for ConcourseCI

Config

Source:

• bot_token: Required Bot token, for example 123456789:ABCDEFGHIJKLMNOPQRSTUVWQYZabcdefghi
• chat_id: Required Chat id
• ci_url: URL of your CI, if not defined will be used from $ATC_EXTERNAL_URL
• command: Required for get Command which will trigger a job, for example /build
• admins: Array of usernames (without @) who can use a command to trigger job, if not defined all users will be able to trigger a job

Params:

• message: Message which will send with build info

Input

You can use input to get args from a command sent to bot. All args will be stored in <resourse_name>/input_args

Example

resource_types:
- name: telegram-notification
  type: docker-image
  source:
    repository: cuttlerat/concourse-telegram-resource
    tag: latest

resources:
- name: telegram
  type: telegram-notification
  source:
    bot_token: ((telegram_bot_token))
    chat_id: ((telegram_chat_id))
    ci_url: "http://example.com"
    admins: ((telegram_admins))
    command: "/build"

jobs:
- name: test_task
  plan:
  - get: telegram
    trigger: true
  - task: Send message
    on_success:
      put: telegram
      params:
        message: Build successful
    config:
      platform: linux
      image_resource:
        type: docker-image
        source: {repository: alpine, tag: "latest"}
      inputs:
        - name: telegram
      run:
        path: sh
        args:
          - -exc
          - |
             [[ -f telegram/input_args ]] && cat telegram/input_args || exit 0

Example command for trigger

/build

Example output message

Build successful
URL: Link
Pipeline: test
Job: test_task
Build number: 1