OpenCEPK - Terraform/OpenTofu Module for GitHub

Terraform/OpenTofu module for creating and managing GitHub Organizations, Repositories, Projects and more.

Features

Usage

(Resource) Best Practices

• https://registry.terraform.io/providers/integrations/github
• https://github.com/integrations/terraform-provider-github

Examples

Requirements

Name	Version
terraform	>= 1.0
github	5.3.0

Providers

Name	Version
github	5.3.0

Modules

No modules.

Resources

Name	Type
github_organization_project.this	resource
github_organization_settings.this	resource
github_organization_webhook.this	resource

Inputs

Name	Description	Type	Default	Required
advanced_security_enabled_for_new_repositories	Whether or not advanced security is enabled for new repositories. (Optional)	bool	false	no
billing_email	The billing email address for the GitHub Organization. (Required)	string	n/a	yes
blog_url	The blog URL (https://example.com) for the GitHub Organization. (Optional)	string	""	no
company	The company name for the GitHub Organization. (Optional)	string	""	no
create_github_organization	Whether to create the GitHub Organization.	bool	true	no
create_github_organization_project	Whether to create Projects in the GitHub Organization.	bool	false	no
create_github_organization_webhook	Whether to create Webhooks in the GitHub Organization.	bool	false	no
default_repository_permission	The default permission [read|write|admin|none] for GitHub Organization members to create new repositories . (Optional)	string	"read"	no
dependabot_alerts_enabled_for_new_repositories	Whether or not dependabot alerts are enabled for new repositories. (Optional)	bool	false	no
dependabot_security_updates_enabled_for_new_repositories	Whether or not dependabot security updates are enabled for new repositories. (Optional)	bool	false	no
dependency_graph_enabled_for_new_repositories	Whether or not dependency graph is enabled for new repositories. (Optional)	bool	false	no
description	The description for the GitHub Organization. (Optional)	string	""	no
email	The email address ([email protected]) for the GitHub Organization. (Optional)	string	""	no
github_organization_projects	Map of GitHub Organization Projects to create. (Optional)	map(any)	{}	no
github_organization_webhooks	Map of GitHub Organization Webhooks to create. (Optional) For list of valid events, visit https://docs.github.com/en/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#issues	map(any)	{}	no
has_organization_projects	Whether or not organization projects are enabled for the GitHub Organization. (Optional)	bool	true	no
has_repository_projects	Whether or not repository projects are enabled for the GitHub Organization. (Optional)	bool	true	no
location	The location for the GitHub Organization. (Optional)	string	""	no
members_can_create_internal_repositories	Whether or not organization members can create new internal repositories. For Enterprise Organizations only. (Optional)	bool	false	no
members_can_create_pages	Whether or not organization members can create new pages. (Optional)	bool	true	no
members_can_create_private_pages	Whether or not organization members can create new private pages. (Optional)	bool	true	no
members_can_create_private_repositories	Whether or not organization members can create new private repositories. (Optional)	bool	true	no
members_can_create_public_pages	Whether or not organization members can create new public pages. (Optional)	bool	true	no
members_can_create_public_repositories	Whether or not organization members can create new public repositories. (Optional)	bool	true	no
members_can_create_repositories	Whether or not organization members can create new repositories. (Optional)	bool	true	no
members_can_fork_private_repositories	Whether or not organization members can fork private repositories. (Optional)	bool	false	no
name	The name for the GitHub Organization. (Optional)	string	""	no
secret_scanning_enabled_for_new_repositories	Whether or not secret scanning is enabled for new repositories. (Optional)	bool	false	no
secret_scanning_push_protection_enabled_for_new_repositories	Whether or not secret scanning push protection is enabled for new repositories. (Optional)	bool	false	no
twitter_username	The Twitter username for the GitHub Organization. (Optional)	string	""	no
web_commit_signoff_required	Whether or not commit signatures are required for commits to the organization. (Optional)	bool	false	no

Outputs

Name	Description
organization_project_url	The URL of the project
organization_settings_id	The ID of the organization settings
organization_webhook_url	The URL of the webhook

Authors

License