Skip to main content

GitHub Issues

The GitHub Issues integration allows you to link DoiT Threads to GitHub issues, so teams that run their backlog on GitHub can track FinOps actions where their engineering work already lives. After you connect a GitHub organization or personal account, you can create threads from Insights and automate thread creation using CloudFlow.

Required permissions​

  • DoiT account: To connect GitHub from the console, your account needs Manage settings. To create and manage threads after the integration is connected, your account needs the Thread Manager permission. See Threads.

  • GitHub: You need to be an owner of the GitHub organization (or the owner of the personal account) to install the DoiT Threads app. If you are an organization member without owner rights, GitHub sends an installation request to the owners instead; the console shows Awaiting approval until an owner approves it.

What the app can access​

The DoiT Threads GitHub App requests only two repository permissions:

  • Issues: Read and write to create issues and read their state, labels, and assignees.

  • Metadata: Read-only to list the repositories the installation can access.

You choose whether the app can access all repositories or only selected ones when you install it, and you can change that later in the app's settings on GitHub.

Connect GitHub​

  1. Sign in to the DoiT console, select Data ingestion and integrations > Integrations from the top navigation mega menu.

  2. On the GitHub Issues integration card, select Manage.

  3. Select Connect GitHub.

  4. On GitHub, pick the organization or personal account and the repositories the app may access, then select Install. GitHub redirects you back to the console with the account connected.

The connected view shows the GitHub account, whether the app can access all or selected repositories, and a Manage on GitHub link to the installation settings.

Creating threads after you connect​

Once GitHub is connected, you can:

  • Create threads from Insights. Choose a repository, review the pre-filled title and description, and optionally pick labels and assignees.

  • Create a thread from a flow.

Issues are created by the DoiT Threads app; the console shows the issue's state, labels, and assignees, and a Manage in GitHub button opens the issue on GitHub.

Note

The console does not add issues to GitHub Projects. If your team plans in a Project, use the Project's built-in Auto-add to project workflow so that new issues in the repository appear there automatically.

Disconnect​

To disconnect GitHub, uninstall the DoiT Threads app from your GitHub organization or account settings (the Manage on GitHub link takes you there). The console reflects the removal within seconds, and existing GitHub threads are marked as not available.

See also​

Last updated on