github_repository_file

This resource allows you to create and manage files within a GitHub repository.

Example Usage

resource "github_repository" "foo" {
  name      = "tf-acc-test-%s"
  auto_init = true
}

resource "github_repository_file" "foo" {
  repository          = github_repository.foo.name
  branch              = "main"
  file                = ".gitignore"
  content             = "**/*.tfstate"
  commit_message      = "Managed by Terraform"
  commit_author       = "Terraform User"
  commit_email        = "terraform@example.com"
  overwrite_on_create = true
}

Argument Reference

The following arguments are supported:

Attributes Reference

The following additional attributes are exported:

Import

Repository files can be imported using a combination of the repo and file, e.g.

$ terraform import github_repository_file.gitignore example/.gitignore

To import a file from a branch other than the default branch, append : and the branch name, e.g.

$ terraform import github_repository_file.gitignore example/.gitignore:dev