mirror of
https://github.com/coder/coder.git
synced 2025-07-09 11:45:56 +00:00
73 lines
2.7 KiB
Markdown
73 lines
2.7 KiB
Markdown
# Cloning Git Repositories
|
|
|
|
<div style="padding: 0px; margin: 0px;">
|
|
<span style="vertical-align:middle;">Author: </span>
|
|
<a href="https://github.com/BrunoQuaresma" style="text-decoration: none; color: inherit; margin-bottom: 0px;">
|
|
<span style="vertical-align:middle;">Bruno Quaresma</span>
|
|
<img src="https://avatars.githubusercontent.com/u/3165839?v=4" alt="Bruno Quaresma" width="24px" height="24px" style="vertical-align:middle; margin: 0px;"/>
|
|
</a>
|
|
</div>
|
|
August 06, 2024
|
|
|
|
---
|
|
|
|
When starting to work on a project, engineers usually need to clone a Git
|
|
repository. Even though this is often a quick step, it can be automated using
|
|
the [Coder Registry](https://registry.coder.com/) to make a seamless Git-first
|
|
workflow.
|
|
|
|
The first step to enable Coder to clone a repository is to provide
|
|
authorization. This can be achieved by using the Git provider, such as GitHub,
|
|
as an authentication method. If you don't know how to do that, we have written
|
|
documentation to help you:
|
|
|
|
- [GitHub](../admin/external-auth.md#github)
|
|
- [GitLab self-managed](../admin/external-auth.md#gitlab-self-managed)
|
|
- [Self-managed git providers](../admin/external-auth.md#self-managed-git-providers)
|
|
|
|
With the authentication in place, it is time to set up the template to use the
|
|
[Git Clone module](https://registry.coder.com/modules/git-clone) from the
|
|
[Coder Registry](https://registry.coder.com/) by adding it to our template's
|
|
Terraform configuration.
|
|
|
|
```tf
|
|
module "git-clone" {
|
|
source = "registry.coder.com/modules/git-clone/coder"
|
|
version = "1.0.12"
|
|
agent_id = coder_agent.example.id
|
|
url = "https://github.com/coder/coder"
|
|
}
|
|
```
|
|
|
|
> You can edit the template using an IDE or terminal of your preference, or by
|
|
> going into the
|
|
> [template editor UI](../admin/templates/creating-templates.md#web-ui).
|
|
|
|
You can also use
|
|
[template parameters](../admin/templates/extending-templates/parameters.md) to
|
|
customize the Git URL and make it dynamic for use cases where a template
|
|
supports multiple projects.
|
|
|
|
```tf
|
|
data "coder_parameter" "git_repo" {
|
|
name = "git_repo"
|
|
display_name = "Git repository"
|
|
default = "https://github.com/coder/coder"
|
|
}
|
|
|
|
module "git-clone" {
|
|
source = "registry.coder.com/modules/git-clone/coder"
|
|
version = "1.0.12"
|
|
agent_id = coder_agent.example.id
|
|
url = data.coder_parameter.git_repo.value
|
|
}
|
|
```
|
|
|
|
> If you need more customization, you can read the
|
|
> [Git Clone module](https://registry.coder.com/modules/git-clone) documentation
|
|
> to learn more about the module.
|
|
|
|
Don't forget to build and publish the template changes before creating a new
|
|
workspace. You can check if the repository is cloned by accessing the workspace
|
|
terminal and listing the directories.
|