feat: Add github_actions_hosted_runner resource (#2893)

* feat: Add GitHub Actions hosted runner resource and examples

* feat: Add documentation for GitHub Actions hosted runner resource

* feat: Update GitHub Actions hosted runner resource to use numeric image IDs and add new attributes

* feat: Update GitHub Actions hosted runner resource to allow size field updates and enhance validation

* feat: Enhance GitHub Actions hosted runner resource to handle image ID as number and add image_gen attribute

* Add link to GitHub Actions hosted runner documentation in website

* feat: Improve error handling and type assertion in resourceGithubActionsHostedRunnerRead function

* lint: Replace interface{} with any in resource_github_actions_hosted_runner.go

---------

Co-authored-by: Nick Floyd <[email protected]>

Author: austenstone

examples/hosted_runner/main.tf

@@ -0,0 +1,34 @@
+resource "github_actions_runner_group" "example" {
+  name       = "example-runner-group"
+  visibility = "all"
+}
+
+# NOTE: You must first query available images using the GitHub API:
+# GET /orgs/{org}/actions/hosted-runners/images/github-owned
+# The image ID is numeric, not a string like "ubuntu-latest"
+resource "github_actions_hosted_runner" "example" {
+  name = "example-hosted-runner"
+  
+  image {
+    id     = "2306"  # Ubuntu Latest (24.04) - query your org for available IDs
+    source = "github"
+  }
+
+  size            = "4-core"
+  runner_group_id = github_actions_runner_group.example.id
+}
+
+# Advanced example with optional parameters
+resource "github_actions_hosted_runner" "advanced" {
+  name = "advanced-hosted-runner"
+  
+  image {
+    id     = "2306"  # Ubuntu Latest (24.04) - query your org for available IDs
+    source = "github"
+  }
+
+  size             = "8-core"
+  runner_group_id  = github_actions_runner_group.example.id
+  maximum_runners  = 10
+  enable_static_ip = true
+}

github/provider.go

@@ -145,6 +145,7 @@ func Provider() *schema.Provider {
 			"github_actions_repository_oidc_subject_claim_customization_template":   resourceGithubActionsRepositoryOIDCSubjectClaimCustomizationTemplate(),
 			"github_actions_repository_permissions":                                 resourceGithubActionsRepositoryPermissions(),
 			"github_actions_runner_group":                                           resourceGithubActionsRunnerGroup(),
+			"github_actions_hosted_runner":                                          resourceGithubActionsHostedRunner(),
 			"github_actions_secret":                                                 resourceGithubActionsSecret(),
 			"github_actions_variable":                                               resourceGithubActionsVariable(),
 			"github_app_installation_repositories":                                  resourceGithubAppInstallationRepositories(),