{"id":31904323,"url":"https://github.com/cloudfoundry-community/git-multibranch-resource","last_synced_at":"2025-10-13T13:49:03.359Z","repository":{"id":3697323,"uuid":"50047356","full_name":"cloudfoundry-community/git-multibranch-resource","owner":"cloudfoundry-community","description":"Provides concourse resource for triggering and fetching on any git branch change","archived":false,"fork":false,"pushed_at":"2021-12-08T10:42:16.000Z","size":110,"stargazers_count":36,"open_issues_count":12,"forks_count":26,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-04-14T22:47:40.796Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloudfoundry-community.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-01-20T17:32:17.000Z","updated_at":"2024-02-09T14:25:32.000Z","dependencies_parsed_at":"2022-07-15T16:37:34.734Z","dependency_job_id":null,"html_url":"https://github.com/cloudfoundry-community/git-multibranch-resource","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/cloudfoundry-community/git-multibranch-resource","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Fgit-multibranch-resource","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Fgit-multibranch-resource/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Fgit-multibranch-resource/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Fgit-multibranch-resource/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudfoundry-community","download_url":"https://codeload.github.com/cloudfoundry-community/git-multibranch-resource/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Fgit-multibranch-resource/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279015347,"owners_count":26085686,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-13T13:48:35.722Z","updated_at":"2025-10-13T13:49:03.354Z","avatar_url":"https://github.com/cloudfoundry-community.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Git Resource\n\nTracks the commits in a [git](http://git-scm.com/) repository.\n\n\n## Source Configuration\n\n* `uri`: *Required.* The location of the repository.\n\n* `branch`: *Required.* The branch to track.\n\n* `private_key`: *Optional.* Private key to use when pulling/pushing.\n    Example:\n    ```\n    private_key: |\n      -----BEGIN RSA PRIVATE KEY-----\n      MIIEowIBAAKCAQEAtCS10/f7W7lkQaSgD/mVeaSOvSF9ql4hf/zfMwfVGgHWjj+W\n      \u003cLots more text\u003e\n      DWiJL+OFeg9kawcUL6hQ8JeXPhlImG6RTUffma9+iGQyyBMCGd1l\n      -----END RSA PRIVATE KEY-----\n    ```\n\n* `paths`: *Optional.* If specified (as a list of glob patterns), only changes\n  to the specified files will yield new versions.\n\n* `ignore_paths`: *Optional.* The inverse of `paths`; changes to the specified\n  files are ignored.\n\n* `skip_ssl_verification`: *Optional.* Skips git ssl verification by exporting\n  `GIT_SSL_NO_VERIFY=true`.\n\n* `branches`: *Optional.* Turns on multi-branch mode; takes a regular\n  expression as argument -- branches matching the regular expression on origin\n  will all be checked for changes.  Uses grep-style regular expression syntax\n\n* `ignore_branches`: *Optional.* Used in conjunction with and applied after\n  the `branches` pattern.  See example for common use case.\n\n* `redis`: *Optional.*  Contains the information required to use a specified\n  Redis server to store multibranch historic references so that they don't\n  clutter up the ref lines.  It consists of the following subkeys:\n\n  * `host`: *Required.* The name or ip of the Redis host.\n\n  * `password`: *Optional.* The password to connect to the Redis server, if\n    required.\n\n  * `prefix`: *Optional.* If you have multiple multi-branch pipelines, you\n    will want to prefix your keys to separate the histories of each pipeline.\n\n  * `db_number`: *Optional.* The Redis database number, defaults to 0\n\n### Example\n\nResource configuration for a private repo:\n\n``` yaml\nresource_types:\n- name: git-multibranch\n  type: docker-image\n  source:\n    repository: cfcommunity/git-multibranch-resource\n\nresources:\n- name: source-code\n  type: git-multibranch\n  source:\n    uri: git@github.com:concourse/git-resource.git\n    branch: master\n    private_key: |\n      -----BEGIN RSA PRIVATE KEY-----\n      MIIEowIBAAKCAQEAtCS10/f7W7lkQaSgD/mVeaSOvSF9ql4hf/zfMwfVGgHWjj+W\n      \u003cLots more text\u003e\n      DWiJL+OFeg9kawcUL6hQ8JeXPhlImG6RTUffma9+iGQyyBMCGd1l\n      -----END RSA PRIVATE KEY-----\n```\n\nFetching a repo with only 100 commits of history:\n\n``` yaml\n- get: source-code\n  params: {depth: 100}\n```\n\nPushing local commits to the repo:\n\n``` yaml\n- get: some-other-repo\n- put: source-code\n  params: {repository: some-other-repo}\n```\n\nDetecting changes on all branches except master and deploy\n\n``` yaml\nresources:\n- name: my-repo\n  type: git-multibranch\n  source:\n    uri: git@github.com:my-org/my-repo.git\n    branches: '.*'\n    ignore_branches: '(master|deploy)'\n```\n\n## Behavior\n\n### `check`: Check for new commits.\n\nThe repository is cloned (or pulled if already present), and any commits\nmade after the given version are returned. If no version is given, the ref\nfor `HEAD` is returned.\n\nAny commits that contain the string `[ci skip]` will be ignored. This\nallows you to commit to your repository without triggering a new version.\n\n### `in`: Clone the repository, at the given ref.\n\nClones the repository to the destination, and locks it down to a given ref.\nReturns the resulting ref as the version.\n\nSubmodules are initialized and updated recursively.\n\n\n#### Parameters\n\n* `depth`: *Optional.* If a positive integer is given, *shallow* clone the\n  repository using the `--depth` option.\n\n* `submodules`: *Optional.* If `none`, submodules will not be\n  fetched. If specified as a list of paths, only the given paths will be\n  fetched. If not specified, or if `all` is explicitly specified, all\n  submodules are fetched.\n\n\n### `out`: Push to a repository.\n\nPush the checked-out reference to the source's URI and branch. All tags are\nalso pushed to the source. If a fast-forward for the branch is not possible\nand the `rebase` parameter is not provided, the push will fail.\n\n#### Parameters\n\n* `repository`: *Required.* The path of the repository to push to the source.\n\n* `rebase`: *Optional.* If pushing fails with non-fast-forward, continuously\n  attempt rebasing and pushing.\n\n* `tag`: *Optional* If this is set then HEAD will be tagged. The value should be\n  a path to a file containing the name of the tag.\n\n* `only_tag`: *Optional* When set to 'true' push only the tags of a repo.\n\n* `tag_prefix`: *Optional.* If specified, the tag read from the file will be\nprepended with this string. This is useful for adding `v` in front of\nversion numbers.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudfoundry-community%2Fgit-multibranch-resource","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudfoundry-community%2Fgit-multibranch-resource","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudfoundry-community%2Fgit-multibranch-resource/lists"}