[WIP] Doc Only: Update gitrepository.md about Github Apps

[jeffkala]

Closes: N/A

What's Changed

Be more explict that the currently functionalities within Git Repos don't support GitHub apps.

TODO

• Explanation of Change(s)
• Documentation Updates (when adding/changing features)

[gsnider2195]

By github apps do you mean something like https://github.com/marketplace/gitguardian

[jeffkala]

More like custom apps to try and solve not needing a service account.
https://docs.github.com/en/apps/creating-github-apps/creating-github-apps/about-apps

[gsnider2195]

More like custom apps to try and solve not needing a service account. https://docs.github.com/en/apps/creating-github-apps/creating-github-apps/about-apps

I see. Maybe it would be clearer to just say something like nautobot only supports repositories that can be cloned with the git cli app using git clone?

[bryanculver]

I'm confused here. Along with #3151, where is the use case where your Git Repository is a Github App?

I can see the case for documentation stating we don't support Github App authentication but in review #3151 I'm not seeing how the REST API token can be used to perform a git clone onto the filesystem.

[bryanculver]

Marking as WIP until feedback is addressed.

[jeffkala]

This is all about the management and accessibility to repositories. GH Apps provides some safeguards for this. Ultimately the goal of this PR is not to provide a fix or recommendation beyond just mentioning it in the docs that we don't support the functionality. I'm happy to add additional details if needed.

[jeffkala]

More like custom apps to try and solve not needing a service account. https://docs.github.com/en/apps/creating-github-apps/creating-github-apps/about-apps

I see. Maybe it would be clearer to just say something like nautobot only supports repositories that can be cloned with the git cli app using git clone?

I'm open to changing the terminology but do think GH Apps should be directly called out.

[jeffkala]

Suggested change

	!!! note
	GitHub Apps are not currently supported. GitHub Apps are not specifically focused on the workflow of creating/updating/deleting files. They can indeed perform these actions, but in order to accomplish that the client side MUST hit GitHub APIs instead of using standard command line or Python Git library tooling. At this time this functionality does not exist.
	!!! note
	GitHub Apps are not currently supported. GitHub Apps are not specifically focused on the workflow of creating/updating/deleting files. Nautobot only supports repositories that can be cloned using standard git command line using `git clone`.

[jeffkala]

committed suggestion. Thanks!