Upgrading to GitHub App v0.7.0

With the release of version 0.7.0 of the GitHub app, the changes to the poller ingest method require any existing pollers to be removed and recreated.

Updating the GitHub App and Poller

Updating the GitHub App

From the home page of your Observe instance, go to the Apps page. You should see Update available within the GitHub card. Click on Manage.

GitHub app card on the apps home page

Figure 1 - GitHub app card

From the App details page, click on Update available.

Github app details showing that an update is available.

Figure 2 - GitHub app details with an available update

You may see a modal window that informs you of new default configuration variables in the updated version, go ahead and click Update.

Github app update modal showing that default configuration variables have changed for the new update.

Figure 3 - GitHub app update modal warning of changes to default configuration variables

Once the GitHub app completes updating, you can verify that you are on version 0.7.0 of the GitHub app by navigating to the Versions tab of the GitHub app details.

Github app versions tab displaying that the latest version of the app, version 0.7.0, is the currently installed version.

Figure 4 - GitHub app versions tab with version history information.

With this confirmed, you can move on to updating the poller ingest method.

UpdatingPoller Update

Removing Existing Pollers

From the GitHub app details page, navigate to the Connections tab. Under Existing connections, look for any pollers. Any webhook connections continue to work properly without intervention and can be ignored for this upgrade.

If you do not have any existing pollers, you can follow the standard GitHub Poller configuration steps.

Github app connections tab displaying that there is an existing poller.

Figure 5 - GitHub app connections tab existing poller.

If you have an existing poller, click on the name of the poller to open it. You can then click on the drop-down menu on the top right and select Delete.

Github poller datastream page with the dropdown menu for enabling, disabling, or deleting the datastream selected. "Delete" is highlighted.

Figure 6 - GitHub datastream page demonstrating deletion.

At this point, you can create a new poller ingest connection in the same way as the initial setup. You can find the necessary steps here.