{"resource_type":{"id":135,"name":"git_repository","schema":"{\n\t\"$schema\": \"https://json-schema.org/draft/2020-12/schema\",\n\t\"order\": [\n\t\t\"url\",\n\t\t\"branch\",\n\t\t\"folder\",\n\t\t\"gpg_key\",\n\t\t\"is_github_app\"\n\t],\n\t\"properties\": {\n\t\t\"branch\": {\n\t\t\t\"default\": \"\",\n\t\t\t\"description\": \"Custom branch to use for this repository. If unset, the repository default branch will be used. Certain script might expects that the branch is already created (it is the case of the Windmill Git Sync script).\",\n\t\t\t\"type\": \"string\"\n\t\t},\n\t\t\"folder\": {\n\t\t\t\"default\": \"\",\n\t\t\t\"description\": \"Optional path to a folder inside the repository. The path should be relative to the root of the repository. Certain scripts might expects that the folder already exists in the repo (it is the case of the Windmill Git Sync script).\",\n\t\t\t\"type\": \"string\"\n\t\t},\n\t\t\"gpg_key\": {\n\t\t\t\"description\": \"Optional GPG Key resource if the repo requires signed commits\",\n\t\t\t\"format\": \"resource-gpg_key\",\n\t\t\t\"type\": \"object\"\n\t\t},\n\t\t\"is_github_app\": {\n\t\t\t\"default\": false,\n\t\t\t\"description\": \"Use GitHub App installation token for authentication. Requires a GitHub App installation in your organization / user account as well as configuring it in the customer portal.\",\n\t\t\t\"type\": \"boolean\"\n\t\t},\n\t\t\"url\": {\n\t\t\t\"default\": \"\",\n\t\t\t\"description\": \"URL of the remote\",\n\t\t\t\"type\": \"string\"\n\t\t}\n\t},\n\t\"required\": [\n\t\t\"url\"\n\t],\n\t\"type\": \"object\"\n}","approved":true,"app":"git","description":"Remote Git repository\n\nOnly token-based authentication is supported for this resource type currently. When authentication is needed, the username and token can be included directly in the URL (i.e. `https://[USERNAME]:[TOKEN]@github.com/[ORG|USER]/[REPO_NAME].git`).\n\nScoped token can be generated from most git repository platforms (see [Github](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens), [Gitlab](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html) or [Bitbucket](https://support.atlassian.com/bitbucket-cloud/docs/create-a-repository-access-token/), [Azure DevOps PAT](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=Windows), [Azure DevOps Service Principal](https://windmill.dev/docs/advanced/git_sync#azure-devops-with-service-principal-setup))\n\nInstead of using a PAT for GitHub, you can also install the [Windmill GitHub App](https://windmill.dev/docs/integrations/git_repository#github-app) to authenticate with GitHub using a short lived token.","created_by":"guillaume670","created_at":"2023-12-01T10:23:32.441Z"}}