What is the Travis CI Connector?

The Travis CI Connector is a practical tool that allows you to receive updates about software projects you are following, directly from the Feishu App. It makes it easier to follow and manage developments, and improve communication flows.

How to configure Travis CI Connector

Access Travis CI via GitHub (for project administrators)

You must first integrate Travis CI to GitHub before using it.

•Go to this website and click "Sign in with GitHub", then follow the prompts to setpermissions.

•When the permissions are successfully set, open the GitHub website and then access the "Application" interface from the "Settings" page. Select "Authorized OAuth Apps" to view the installed Travis CI app.

Project administrators need only to complete this process once. If they signed in with permissions before, they can skip this step.

Associate Webhook with the project and Feishu group (for project administrators）

•The project administrator adds the Travis CI Connector Bot to the group chat and sends the message:

@TravisCI Connector get_webhook

•The group administrator will then receive a Webhook address from the Bot, like the one below.

Only the group administrator will receive the group's Webhook address. You can contact them to obtain it.

•Add the Webhook address to the project code library .travis.yml file (if there is no .travis.yml file, you need to create one)

notifications:

webhooks:

urls:

- http://your-domain.com/notifications

on_success: always # default: always

on_failure: always # default: always

on_start: never # default: never

on_cancel: always # default: always

on_error: always # default: always

For detailed configuration parameters, visit this website.

•Configure the project's CI switch from the Travis CI Settings page or using the Travis CI Connector Mini Program (see steps below)

Sign in to the Travis Ci Connector Mini Program (for individual users)

•Open the Travis CI Connector Mini Program in the Workplace of the Feishu mobile client, and sign in to GitHub to get permissions (you can also get permissions for your organization)

•Once these steps are completed, you can receive project update notifications via the Feishu Bot, as well as view planning outcomes and details in the Mini Program.

How to use the GitHub Connector

Bot

•Obtain a Webhook address

@TravisCI Connector get_webhook

•Update the Webhook address (for group administrators only)

@TravisCI Connector reset_webhook

Mini Program

•When the Bot has sent the planning outcome to the designated group, click the card to view the plan details in the Mini Program.

•The Mini Program displays the list of all the followed and activated code libraries, allowing you to quickly view plan outcomes and details. You can follow or unfollow a project at any time.

•The Mini Program supports managing both private and organization libraries. You can change the display settings and control whether Travis CI is enabled or disabled for the project.

Message Cards

Launching plans by pushing code to GitHub

•Push code from the library to the default branch (usually the master branch)

•Wait until the plan is complete and a card message appears, then click the card content or "Plan Details". You will jump to the corresponding plan details page in the Mini Program

•Click "View Code" to go to the GitHub "CodeReview" page

Launching plans by submitting a Pull Request to GitHub

•Sign in to GitHub and submit a Pull Request in the library to the master branch

•Wait until the plan is complete and a card message appears, then click the card content or "Plan Details". You will jump to the corresponding plan details page in the Mini Program.

•Click "View Code" to go to the GitHub "CodeReview" page

Launching plans on the Travis CI website or using APIs

•Wait until the plan is complete and a card message appears, then click the card content or "Plan Details". You will jump to the corresponding plan details page in the Mini Program

•Click "View Code" to go to the GitHub "CodeReview" page

Launching plans by setting scheduled tasks in Travis CI

•Wait until the plan is complete and a card message appears, then click the card content or "Plan Details". You will jump to the corresponding plan details page in the Mini Program

•Click "View Code" to go to the GitHub "CodeReview" page