Twitter Concourse Resource

Send tweets when your Concourse builds finish. Compatible with Concourse 0.74+.

Source Configuration

Required

• consumer_key: The consumer key from registering an application with Twitter.
• consumer_secret: The consumer secret associated with the key above
• access_token: An OAuth 1.0a access token for the twitter account that will be posting tweets.
• access_token_secret: The secret associated with the access token above.

Behavior

check, in

Currently this resource only supports the put phase of a job plan, so these are effectively no-ops. This will likely change in the future.

out: Post a tweet

Posts a tweet with the given parameters. Note that no validation is done on the parameters to ensure that they meet Twitter's specifications; that is left to the API calls to Twitter itself, and builds will fail if the data does not conform.

Parameters

Required:

• status: The text of the tweet itself. Any metadata in the status will be evaluated prior to sending the tweet. Use media to include references to photos or video

Optional:

• media: An array of paths to images or video to upload. Any media referenced here will be uploaded and referenced by the resulting tweet.

Example Pipeline

---
resource_types:
- name: twitter
  type: docker-image
  source:
    repository: ecsteam/twitter-concourse-resource

resources:
- name: tweet-source
  type: git
  source:
    uri: git@github.com:jghiloni/tweet-resource-sample.git
    branch: master
    private_key: {{github-private-key}}
- name: tweet
  type: twitter
  source:
    consumer_key: {{twitter-consumer-key}}
    consumer_secret: {{twitter-consumer-secret}}
    access_token: {{twitter-access-token}}
    access_token_secret: {{twitter-access-token-secret}}

jobs:
- name: do-tweet
  plan:
  - get: tweet-source
  - put: tweet
    params:
      media:
      - tweet-source/logo.png
      status: >
        This is the first tweet with a picture (build ${BUILD_ID})
        from my custom @concourseci resource!