orbit-love / github-actions-templates Goto Github PK

View Code? Open in Web Editor NEW

51.0 3.0 41.0 425 KB

Starter GitHub Actions templates to get you up and running with community built integrations

github-actions automation hacktoberfest

github-actions-templates's Introduction

GitHub Actions Templates

Automate community integrations for your Orbit workspace with these GitHub Actions template starter files

Overview

This repository helps you get up and running with third party integrations to Orbit in a matter of minutes.

Inside this repository are template YAML workflow files you can use to automate third party integrations with your Orbit workspace.

What are 3rd party integrations?

All Orbit users have access to built-in integrations, such as GitHub, Twitter, Slack, and Discord. These built-in integrations can be added and set up from within the Orbit app.

Community-built, or 3rd party integrations, are additional integrations offered by the larger Orbit community. While not officially supported, they offer many opportunities to further extend the utility of the platform.

What is this repository for?

Within each subfolder of this repository is a GitHub Actions workflow template file, along with instructions on how to use it. GitHub Actions is a runtime environment provided by GitHub to any GitHub user. You can run applications on GitHub Actions for free on any publicly available (not private) repository.

First Time Setup

Before setting up an integration using GitHub Actions, you will need to follow the First Time Setup Guide

Available Integrations

The following integration workflows are available to use, and more will be added:

Platform	Features
Circle	New posts in Circle Spaces New comments on Circle Spaces posts
DEV Community	New followers New comments
LinkedIn	New comments on posts
Meetup	New RSVPs for Meetup group events
Notion	New Notes in a Notion database
Planning Center	New Event Check-ins
Pipedrive	New notes on deals New notes on people New activities on deals
Product Hunt	New votes on products New comments on products
Reddit	New posts in subreddits New comments in subreddits Ability to filter to specific term
Stack Overflow	New questions with tag
YouTube	New comments across all videos on a channel

To use a workflow, please follow the integration-specific instructions.

Frequently Asked Questions

Does this have anything to do with Orbit's GitHub Integration? No - setting up community integrations using GitHub Actions is independent of the integration. We are essentially using GitHub Actions as a free host and scheduler of our code.
Are there any requirements of the repository I put my .yml files in? No - it can be called anything, and contain any other files. As long as your workflows are inside of the .github/workflows directory it can go in any repository.
How much does it cost? GitHub provides a generous but limited allowance for using GitHub Actions in private repositories which should be plenty for most communities. If you are using a lot of GitHub Actions either from Orbit or elsewhere, consider making your repository public for unlimited free runs. More info.
Do I need to do any maintainence? Once you set up a GitHub Actions workflow you shouldn't need to do much to it to keep it running. If you are ingesting very large amounts of data you may hit rate limits - check the logs of any failed executions if this happens for more information. GitHub also require some repository activity on the main branch every 60 days to keep actions running. You should receive an email 7 days before this with notice. More info.

Contributing

We ❤️ contributions! Please read the Contribution Guidelines on how to get involved and submit your own 3rd party integration template.

Code of Conduct

This project has a Contributor Code of Conduct. We ask everyone to please adhere by its guidelines.

License

This project is under the MIT License.

github-actions-templates's People

Contributors

Stargazers

Watchers

github-actions-templates's Issues

[reddit] Filtering by multiple terms

On this page, the documentation says:

You can pass in a --filter=term flag to filter the results by a single term. To do this, find the line in the template which starts npx @orbit-love/reddit and add a space and --filter="your term" to the end.

Is it possible to filter the results with several terms? In my case, I would like to both match FoalTS and Foal.

YAML file: https://github.com/LoicPoullain/orbit/blob/main/.github/workflows/reddit.yml#L21

Pulling data from multiple meetup groups

Hi folks,

Couple of questions, firstly is there a way to pull in all historical data? The historical import doesn't seem to do what I'd expect it to (pull all RSVPs for all past events).

Secondly how can I pull in all the meetup groups which run in our community? We have a pro account at Meetup with 8 groups currently. Need a separate secret for each?

Guidance on which restrictions we should put on the API key

A part of me doesn't feel comfortable leaving API keys without any restrictions. Any ideas of restrictions that we can put? (for IPs, calls, etc).

Reddit intregration - only add posts and comments that include a specified keyword

Hi there.

First of all, thanks for the super useful action templates. I have close to zero programming skills (UX designer here) and I managed to get it up and running. This is also my first Github issue, so excuse me if I'm breaking any rules.

What I would like to achieve with the reddit integration is to see if anyone in a specific subreddit is mentioning our project (objectiv). I did manage to pull in all comments and posts from specific subreddits, but that's a bit much if the topic is broad.

Example: I would like to get notified if there are any new posts/comments in r/dataengineering that mention 'objectiv'.

I've tried looking into the Reddit API if such a thing is supported OOTB, but couldn't directly find it.

WDYT? Would this be a useful enhancement?

GH Action for DEV Integration is failing for "Check for New Comments for a DEV User"

Hey, we are using GH Action for DEV Integration and few others too.

But, DEV one seems failing since last 4 days.

Here is the trace from GH Action run.

Run dev_orbit --check-comments
  dev_orbit --check-comments
  shell: /usr/bin/bash -e {0}
  env:
    ......ENV_VARS

/opt/hostedtoolcache/Ruby/2.7.2/x64/lib/ruby/gems/2.7.0/gems/dev_orbit-0.5.1/lib/dev_orbit/dev.rb:86:in `get_articles':
undefined method `empty?' for #<Net::HTTPForbidden 403 Forbidden Bots readbody=true> (NoMethodError)
	from /opt/hostedtoolcache/Ruby/2.7.2/x64/lib/ruby/gems/2.7.0/gems/dev_orbit-0.5.1/lib/dev_orbit/dev.rb:20:in `process_comments'
	from /opt/hostedtoolcache/Ruby/2.7.2/x64/lib/ruby/gems/2.7.0/gems/dev_orbit-0.5.1/lib/dev_orbit/client.rb:54:in `comments'
	from /opt/hostedtoolcache/Ruby/2.7.2/x64/lib/ruby/gems/2.7.0/gems/dev_orbit-0.5.1/scripts/check_comments.rb:13:in `render'
	from /opt/hostedtoolcache/Ruby/2.7.2/x64/lib/ruby/gems/2.7.0/gems/thor-1.1.0/lib/thor/command.rb:27:in `run'
	from /opt/hostedtoolcache/Ruby/2.7.2/x64/lib/ruby/gems/2.7.0/gems/thor-1.1.0/lib/thor/invocation.rb:127:in `invoke_command'
	from /opt/hostedtoolcache/Ruby/2.7.2/x64/lib/ruby/gems/2.7.0/gems/thor-1.1.0/lib/thor.rb:392:in `dispatch'
	from /opt/hostedtoolcache/Ruby/2.7.2/x64/lib/ruby/gems/2.7.0/gems/thor-1.1.0/lib/thor/base.rb:485:in `start'
	from /opt/hostedtoolcache/Ruby/2.7.2/x64/lib/ruby/gems/2.7.0/gems/dev_orbit-0.5.1/bin/dev_orbit:41:in `<top (required)>'
	from /opt/hostedtoolcache/Ruby/2.7.2/x64/bin/dev_orbit:23:in `load'
	from /opt/hostedtoolcache/Ruby/2.7.2/x64/bin/dev_orbit:23:in `<main>'

Checking for new DEV comments within the past day and posting them to your Orbit workspace...

Error: Process completed with exit code 1.

Appreciate your time looking into this. Thank You!