Kyso
Kyso.ioAbout Us
  • What is Kyso?
  • Getting started
    • Architecture and Deployment
  • Kyso's Renderer
    • Jupyter Notebooks
    • Jupyter FAQ
      • Kyso's Jupyter Renderer
      • Bokeh Plots and Kyso
    • HTML
    • Markdown
    • PDFs
    • PowerPoints
    • RTF Documents
    • Embedded Dashboards
      • Google Sheets
      • Looker Dashboards
      • Tableau Dashboards
      • Microsoft BI Dashboards
      • Plotly's Dash
      • Streamlit
    • Videos
  • Publishing Workflows
    • Creating Reports In-App
    • Kyso's Command Line Tool
      • Installation
        • Using Amazon Linux
      • Authorization
      • Publishing & Downloading
      • Advanced configuration
    • Integrating with Git
      • Github
      • Gitlab
      • Bitbucket
    • Configuring Report Metadata
    • Importing Files from S3
    • Publishing FAQ
      • Meta Reports
      • Pushing Single Files
      • Issues with Report Rendering
  • Search and Discovery
    • Searching Reports
    • Browsing Files & Versions
  • COLLABORATION
    • Report Comments
    • Report Tasks
    • Notebook Report Snippets
    • Business Notifications
      • Slack
      • Microsoft Teams
  • Settings & Administration
    • Themes & Styling
    • Permissions System
    • Managing Access
    • SSO Configuration
  • Resources
    • How to manage adoption
      • Driving Internal Engagement
      • Advice for Large Companies
    • R Users & R Markdown
    • Writing a good data-science report
Powered by GitBook
On this page
  • Kyso integrates with all 3 Git systems:
  • How does it work?
  • Git metadata capture
  • Kyso Metadata Configuration

Was this helpful?

  1. Publishing Workflows

Integrating with Git

This section will help you understand Kyso's Git integration so you can start automatically publishing reports on commit.

PreviousAdvanced configurationNextGithub

Last updated 1 year ago

Was this helpful?

Kyso integrates with all 3 Git systems:

How does it work?

Kyso uses Git actions & CI pipelines with each VCS. This is a super-powered way of integrating into your existing workflows, allowing you to fine tune how you commit your work to Kyso - you can choose to integrate a specific branch, tag, on an event - or any other specification of your choosing. You can import both public and private repositories from Git.

Git metadata capture

When you create a report on Kyso, in the browser or from the Command Line, report metadata is created automatically. This is so users can browse through previous iterations of a project and track where & when changes are made, and by whom.

For Git–based reports, we've updated the report interface to also display the commit hash and provide links back to the source Git repository.

No additional action nor configuration is needed from the user. Simply integrate the Kyso CLI into your Git CI pipelines (), and Kyso will handle the rest.

This is how a Git-based report now looks on Kyso:

In the image on the left you can see both the link back to the main Git repository and to the specific commit hash of that report version. On the right, users can browse through previous iterations of the project on Kyso, with each version displaying it's own Git metadata, such as commit hash & creation date.

Kyso Metadata Configuration

Remember that in order to ensure a successful import process, your repositories will need to be set up so Kyso can read in the metadata and properly structure your content. This is especially important if you're connecting multiple repositories or one repository with a lot of sub-directories intended to be published as their own individual Kyso reports. Read more about report metadata here:

Configuring Report Metadata
Github
Gitlab
Bitbucket
see our docs on how to do that here
Git Links
Report Version & Commit Hash