You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
modules/git-config/README.md

47 lines
1.3 KiB
Markdown

---
display_name: Git Config
description: Stores Git configuration from Coder credentials
icon: ../.icons/git.svg
maintainer_github: coder
verified: true
tags: [helper, git]
---
# git-config
Runs a script that checks for stored Git credentials `user.name` and `user.email`, populating them with workspace owner's credentials when missing.
## Examples
### Using workspace owner
The default credentials can be populated from the workspace owner's information.
```hcl
module "git-config" {
source = "https://registry.coder.com/modules/git-config"
agent_id = coder_agent.example.id
default_username = data.coder_workspace.me.owner
default_user_email = data.coder_workspace.me.owner_email
}
```
### Custom credentials
Credentials can also be set manually by the template admin.
```hcl
module "git-config" {
source = "https://registry.coder.com/modules/git-config"
agent_id = coder_agent.example.id
default_username = "michael"
user_email = "michael@example.com"
}
```
## Coder parameter usage
With the defaults set, users still have the opportunity to override the template admin's settings with the coder parameter interface. The workspace owner can manually add their credentials during workspace creation or leave them as "default".
![Coder Parameter Example](../.images/git-config-params.png)