feat: add support for the github_app_installation_repository resource

Author: soerenmartius

.github/workflows/main.yml

@@ -49,3 +49,4 @@ jobs:
         env:
           GITHUB_OWNER: ${{ secrets.TEST_GITHUB_ORGANIZATION }}
           GITHUB_TOKEN: ${{ secrets.TEST_GITHUB_TOKEN }}
+          TF_VAR_app_installations: ${{ secrets.TEST_GITHUB_APP_INSTALLATIONS }}

CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add support for `github_app_installation_repository`
+
 
 ## [0.16.0]
 

README.md

@@ -33,6 +33,7 @@ _Security related notice: Versions 4.7.0, 4.8.0, 4.9.0 and 4.9.1 of the Terrafor
     - [Webhooks Configuration](#webhooks-configuration)
     - [Secrets Configuration](#secrets-configuration)
     - [Autolink References Configuration](#autolink-references-configuration)
+    - [App Installations](#app-installations)
   - [Module Configuration](#module-configuration)
 - [Module Outputs](#module-outputs)
 - [External Documentation](#external-documentation)
@@ -808,6 +809,20 @@ This is due to some terraform limitation and we will update the module once terr
 
     The template of the target URL used for the links; must be a valid URL and contain `<num>` for the reference number.
 
+#### App Installations
+
+- [**`app_installations`**](#var-app_installations): *(Optional `set(number)`)*<a name="var-app_installations"></a>
+
+  A set of GitHub App IDs to be installed in this repository.
+
+  Default is `{}`.
+
+  Example:
+
+  ```hcl
+  app_installations = [25405144, 12556423]
+  ```
+
 ### Module Configuration
 
 - [**`module_depends_on`**](#var-module_depends_on): *(Optional `list(dependency)`)*<a name="var-module_depends_on"></a>
@@ -886,6 +901,10 @@ The following attributes are exported by the module:
 
   List of secrets available.
 
+- [**`app_installations`**](#output-app_installations): *(`set(number)`)*<a name="output-app_installations"></a>
+
+  A map of deploy app installations keyed by installation id.
+
 ## External Documentation
 
 ### Terraform Github Provider Documentation

README.tfdoc.hcl

@@ -1052,6 +1052,22 @@ section {
           }
         }
       }
+
+      section {
+        title = "App Installations"
+
+        variable "app_installations" {
+          type        = set(number)
+          default     = {}
+          description = <<-END
+            A set of GitHub App IDs to be installed in this repository.
+          END
+
+          readme_example = <<-END
+            app_installations = [25405144, 12556423]
+          END
+        }
+      }
     }
 
     section {
@@ -1177,6 +1193,13 @@ section {
         List of secrets available.
       END
     }
+
+    output "app_installations" {
+      type        = set(number)
+      description = <<-END
+        A map of deploy app installations keyed by installation id.
+      END
+    }
   }
 
   section {

main.tf

@@ -496,3 +496,14 @@ resource "github_repository_autolink_reference" "repository_autolink_reference"
   key_prefix          = each.value.key_prefix
   target_url_template = each.value.target_url_template
 }
+
+# ---------------------------------------------------------------------------------------------------------------------
+# App installation
+# ---------------------------------------------------------------------------------------------------------------------
+
+resource "github_app_installation_repository" "app_installation_repository" {
+  for_each = { for a in var.app_installations : a => a }
+
+  repository      = github_repository.repository.name
+  installation_id = each.value
+}

outputs.tf

@@ -79,6 +79,11 @@ output "secrets" {
   description = "List of secrets available."
 }
 
+output "app_installations" {
+  value       = github_app_installation_repository.app_installation_repository
+  description = "A map of deploy app installations keyed by installation id."
+}
+
 # ----------------------------------------------------------------------------------------------------------------------
 # OUTPUT MODULE CONFIGURATION
 # ----------------------------------------------------------------------------------------------------------------------

test/unit-complete/main.tf

@@ -132,6 +132,8 @@ module "repository" {
   projects = var.projects
 
   autolink_references = var.autolink_references
+
+  app_installations = var.app_installations
 }
 
 # ---------------------------------------------------------------------------------------------------------------------

test/unit-complete/variables.tf

@@ -255,3 +255,9 @@ variable "autolink_references" {
     target_url_template = "https://hello.there/TICKET?query=<num>"
   }]
 }
+
+variable "app_installations" {
+  type        = set(number)
+  description = "A list of GitHub App IDs to be installed in this repository."
+  default     = []
+}

variables.tf

@@ -528,6 +528,12 @@ variable "archive_on_destroy" {
   default     = true
 }
 
+variable "app_installations" {
+  type        = set(number)
+  description = "(Optional) A list of GitHub App IDs to be installed in this repository."
+  default     = []
+}
+
 # ------------------------------------------------------------------------------
 # MODULE CONFIGURATION PARAMETERS
 # These variables are used to configure the module.