feat: Add ability to set GitHub app as source for git dependency resources

Author: lourens-octopus

docs/resources/process_child_step.md

@@ -133,6 +133,7 @@ Optional:
 
 - `file_path_filters` (Set of String) List of file path filters used to narrow down the directory where files are to be sourced from. Supports glob patten syntax.
 - `git_credential_id` (String) ID of an existing Git credential.
+- `github_connection_id` (String) ID of an existing GitHub App connection. Used when git_credential_type is GitHub
 
 
 <a id="nestedatt--packages"></a>

docs/resources/process_step.md

@@ -164,6 +164,7 @@ Optional:
 
 - `file_path_filters` (Set of String) List of file path filters used to narrow down the directory where files are to be sourced from. Supports glob patten syntax.
 - `git_credential_id` (String) ID of an existing Git credential.
+- `github_connection_id` (String) ID of an existing GitHub App connection. Used when git_credential_type is GitHub
 
 
 <a id="nestedatt--packages"></a>

docs/resources/process_templated_child_step.md

@@ -184,6 +184,7 @@ Optional:
 
 - `file_path_filters` (Set of String) List of file path filters used to narrow down the directory where files are to be sourced from. Supports glob patten syntax.
 - `git_credential_id` (String) ID of an existing Git credential.
+- `github_connection_id` (String) ID of an existing GitHub App connection. Used when git_credential_type is GitHub
 
 
 <a id="nestedatt--packages"></a>

docs/resources/process_templated_step.md

@@ -165,6 +165,7 @@ Optional:
 
 - `file_path_filters` (Set of String) List of file path filters used to narrow down the directory where files are to be sourced from. Supports glob patten syntax.
 - `git_credential_id` (String) ID of an existing Git credential.
+- `github_connection_id` (String) ID of an existing GitHub App connection. Used when git_credential_type is GitHub
 
 
 <a id="nestedatt--packages"></a>

go.mod

@@ -5,7 +5,7 @@ go 1.24.0
 toolchain go1.24.5
 
 require (
-	github.com/OctopusDeploy/go-octopusdeploy/v2 v2.95.0
+	github.com/OctopusDeploy/go-octopusdeploy/v2 v2.96.0
 	github.com/OctopusSolutionsEngineering/OctopusTerraformTestFramework v1.0.2
 	github.com/google/uuid v1.6.0
 	github.com/hashicorp/go-cty v1.4.1-0.20200723130312-85980079f637

go.sum

@@ -21,6 +21,10 @@ github.com/OctopusDeploy/go-octodiff v1.0.0 h1:U+ORg6azniwwYo+O44giOw6TiD5USk8S4
 github.com/OctopusDeploy/go-octodiff v1.0.0/go.mod h1:Mze0+EkOWTgTmi8++fyUc6r0aLZT7qD9gX+31t8MmIU=
 github.com/OctopusDeploy/go-octopusdeploy/v2 v2.95.0 h1:zSrcA1jVi9vKz786rhJxi8EDyN+6YEPyLncOebk+yMQ=
 github.com/OctopusDeploy/go-octopusdeploy/v2 v2.95.0/go.mod h1:VkTXDoIPbwGFi5+goo1VSwFNdMVo784cVtJdKIEvfus=
+github.com/OctopusDeploy/go-octopusdeploy/v2 v2.95.1-0.20251211021954-20cad2b7a2d0 h1:UNcHBCthgIjxdjphwm0R688AdAMmHuXpsE3Pkl1fmx4=
+github.com/OctopusDeploy/go-octopusdeploy/v2 v2.95.1-0.20251211021954-20cad2b7a2d0/go.mod h1:VkTXDoIPbwGFi5+goo1VSwFNdMVo784cVtJdKIEvfus=
+github.com/OctopusDeploy/go-octopusdeploy/v2 v2.96.0 h1:MLVK95s2+qf2IPginWLB13KKQsXIApD5zuyXZJRiDaI=
+github.com/OctopusDeploy/go-octopusdeploy/v2 v2.96.0/go.mod h1:VkTXDoIPbwGFi5+goo1VSwFNdMVo784cVtJdKIEvfus=
 github.com/OctopusSolutionsEngineering/OctopusTerraformTestFramework v1.0.2 h1:960T/UryMsoc2ZOnoLEg7rM9QpxWIdkdB9sR5gsUFAQ=
 github.com/OctopusSolutionsEngineering/OctopusTerraformTestFramework v1.0.2/go.mod h1:kllISYzQ8N3P6+3rScVhyW/KWnPWQbwzm8pFcMInSRM=
 github.com/ProtonMail/go-crypto v1.1.6 h1:ZcV+Ropw6Qn0AX9brlQLAUXfqLBc7Bl+f/DmNxpLfdw=

octopusdeploy_framework/resource_process_step.go

@@ -351,11 +351,12 @@ func mapProcessStepActionGitDependenciesFromState(ctx context.Context, dependenc
 		}
 
 		gitDependency := &gitdependencies.GitDependency{
-			Name:              key,
-			RepositoryUri:     dependencyState.RepositoryUri.ValueString(),
-			DefaultBranch:     dependencyState.DefaultBranch.ValueString(),
-			GitCredentialType: dependencyState.GitCredentialType.ValueString(),
-			GitCredentialId:   dependencyState.GitCredentialID.ValueString(),
+			Name:               key,
+			RepositoryUri:      dependencyState.RepositoryUri.ValueString(),
+			DefaultBranch:      dependencyState.DefaultBranch.ValueString(),
+			GitCredentialType:  dependencyState.GitCredentialType.ValueString(),
+			GitCredentialId:    dependencyState.GitCredentialID.ValueString(),
+			GitHubConnectionId: dependencyState.GitHubConnectionID.ValueString(),
 		}
 
 		if dependencyState.FilePathFilters.IsNull() {
@@ -541,11 +542,12 @@ func mapGitDependenciesToState(dependencies []*gitdependencies.GitDependency) ty
 		stateDependency := types.ObjectValueMust(
 			schemas.ProcessStepGitDependencyAttributeTypes(),
 			map[string]attr.Value{
-				"repository_uri":      types.StringValue(dependency.RepositoryUri),
-				"default_branch":      types.StringValue(dependency.DefaultBranch),
-				"git_credential_type": types.StringValue(dependency.GitCredentialType),
-				"file_path_filters":   types.SetValueMust(types.StringType, util.ToValueSlice(dependency.FilePathFilters)),
-				"git_credential_id":   types.StringValue(dependency.GitCredentialId),
+				"repository_uri":       types.StringValue(dependency.RepositoryUri),
+				"default_branch":       types.StringValue(dependency.DefaultBranch),
+				"git_credential_type":  types.StringValue(dependency.GitCredentialType),
+				"file_path_filters":    types.SetValueMust(types.StringType, util.ToValueSlice(dependency.FilePathFilters)),
+				"git_credential_id":    types.StringValue(dependency.GitCredentialId),
+				"github_connection_id": types.StringValue(dependency.GitHubConnectionId),
 			},
 		)
 

octopusdeploy_framework/schemas/process_step.go

@@ -289,11 +289,12 @@ func resourceActionPackageReferenceAttributes() map[string]resourceSchema.Attrib
 }
 
 type ProcessStepGitDependencyResourceModel struct {
-	RepositoryUri     types.String `tfsdk:"repository_uri"`
-	DefaultBranch     types.String `tfsdk:"default_branch"`
-	GitCredentialType types.String `tfsdk:"git_credential_type"`
-	FilePathFilters   types.Set    `tfsdk:"file_path_filters"`
-	GitCredentialID   types.String `tfsdk:"git_credential_id"`
+	RepositoryUri      types.String `tfsdk:"repository_uri"`
+	DefaultBranch      types.String `tfsdk:"default_branch"`
+	GitCredentialType  types.String `tfsdk:"git_credential_type"`
+	FilePathFilters    types.Set    `tfsdk:"file_path_filters"`
+	GitCredentialID    types.String `tfsdk:"git_credential_id"`
+	GitHubConnectionID types.String `tfsdk:"github_connection_id"`
 }
 
 func ProcessStepGitDependencyObjectType() types.ObjectType {
@@ -304,11 +305,12 @@ func ProcessStepGitDependencyObjectType() types.ObjectType {
 
 func ProcessStepGitDependencyAttributeTypes() map[string]attr.Type {
 	return map[string]attr.Type{
-		"repository_uri":      types.StringType,
-		"default_branch":      types.StringType,
-		"git_credential_type": types.StringType,
-		"file_path_filters":   types.SetType{ElemType: types.StringType},
-		"git_credential_id":   types.StringType,
+		"repository_uri":       types.StringType,
+		"default_branch":       types.StringType,
+		"git_credential_type":  types.StringType,
+		"file_path_filters":    types.SetType{ElemType: types.StringType},
+		"git_credential_id":    types.StringType,
+		"github_connection_id": types.StringType,
 	}
 }
 
@@ -349,6 +351,10 @@ func resourceActionGitDependencyNestedAttribute() resourceSchema.NestedAttribute
 				Computed().
 				Default("").
 				Build(),
+			"github_connection_id": util.ResourceString().
+				Description("ID of an existing GitHub App connection. Used when git_credential_type is GitHub").
+				Optional().
+				Build(),
 		},
 	}
 }