gitpanda

README

gitpanda 🐼

GitLab URL expander for Slack

Example

Requirements

• GitLab API v4
• Slack app and OAuth Access Token
  • see CREATE_SLACK_APP.md

Supported URL format

• User URL
  • e.g. ${GITLAB_BASE_URL}/:username
• Project URL
  • e.g. ${GITLAB_BASE_URL}/:namespace/:reponame
• Issue URL
  • e.g. ${GITLAB_BASE_URL}/:namespace/:reponame/issues/:iid
• MergeRequest URL
  • e.g. ${GITLAB_BASE_URL}/:namespace/:reponame/merge_requests/:iid
• Blob URL
  • e.g. ${GITLAB_BASE_URL}/:namespace/:reponame/blob/:sha1/:filename

Running standalone

Download latest binary from https://github.com/sue445/gitpanda/releases

PORT=8000 \
GITLAB_API_ENDPOINT=https://your-gitlab.example.com/api/v4 \
GITLAB_BASE_URL=https://your-gitlab.example.com \
GITLAB_PRIVATE_TOKEN=xxxxxxxxxx \
SLACK_OAUTH_ACCESS_TOKEN=xoxp-0000000000-0000000000-000000000000-00000000000000000000000000000000 \
TRUNCATE_LINES=5 \
./gitpanda

Environment variables

• PORT
  • default is 8000
• GITLAB_API_ENDPOINT
  • e.g. https://your-gitlab.example.com/api/v4
• GITLAB_BASE_URL
  • e.g. https://your-gitlab.example.com
• GITLAB_PRIVATE_TOKEN
  • Generate a personal access token with api scope
• SLACK_OAUTH_ACCESS_TOKEN
  • see CREATE_SLACK_APP.md
  • e.g. xoxp-0000000000-0000000000-000000000000-00000000000000000000000000000000
• TRUNCATE_LINES
  • Line count to truncate the text (default. no truncate)

Running with AWS (Lambda + API Gateway + Parameter Store)

Use latest gitpanda_linux_amd64 on https://github.com/sue445/gitpanda/releases

Environment variables

One of the following is required

Environment	Key of Parameter Store
GITLAB_API_ENDPOINT	GITLAB_API_ENDPOINT_KEY
GITLAB_BASE_URL	GITLAB_BASE_URL_KEY
GITLAB_PRIVATE_TOKEN	GITLAB_PRIVATE_TOKEN_KEY
SLACK_OAUTH_ACCESS_TOKEN	SLACK_OAUTH_ACCESS_TOKEN_KEY
TRUNCATE_LINES

When you want to store to Parameter Store, please store as SecureString

Example

• Example template for AWS SAM

Arguments

$ ./gitpanda --help
Usage of ./gitpanda:
  -version
    	Whether showing version

Development

Recommend to use https://github.com/direnv/direnv

cp .envrc.example .envrc
vi .envrc
direnv allow

Heroku deploy