feat(github-runners): add ephemeral self-hosted runners on build servers (#12054)

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 21:18:11 -04:00 · 2026-09-30 12:13:11 +02:00
parent 03a056709d
commit fd85b740f5
40 changed files with 3605 additions and 20 deletions
@@ -0,0 +1,104 @@
+<?php
+
+namespace App\Models;
+
+use App\Enums\GithubRunnerStatus;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class GithubRunnerExecution extends BaseModel
+{
+    protected $fillable = [
+        'github_app_id',
+        'github_runner_config_id',
+        'server_id',
+        'status',
+        'trigger_workflow_job_id',
+        'workflow_job_id',
+        'workflow_job_html_url',
+        'workflow_name',
+        'job_name',
+        'repository_full_name',
+        'labels',
+        'runner_name',
+        'runner_id',
+        'conclusion',
+        'error_message',
+        'provision_attempts',
+        'queued_at',
+        'ready_at',
+        'started_at',
+        'completed_at',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'status' => GithubRunnerStatus::class,
+            'trigger_workflow_job_id' => 'integer',
+            'workflow_job_id' => 'integer',
+            'runner_id' => 'integer',
+            'provision_attempts' => 'integer',
+            'labels' => 'array',
+            'queued_at' => 'datetime',
+            'ready_at' => 'datetime',
+            'started_at' => 'datetime',
+            'completed_at' => 'datetime',
+        ];
+    }
+
+    public function githubApp(): BelongsTo
+    {
+        return $this->belongsTo(GithubApp::class);
+    }
+
+    public function config(): BelongsTo
+    {
+        return $this->belongsTo(GithubRunnerConfig::class, 'github_runner_config_id');
+    }
+
+    public function server(): BelongsTo
+    {
+        return $this->belongsTo(Server::class);
+    }
+
+    public function isActive(): bool
+    {
+        return $this->status->isActive();
+    }
+
+    /**
+     * Base name of the Docker resources (containers, network, volumes) of this runner.
+     */
+    public function containerName(): string
+    {
+        return 'coolify-runner-'.$this->uuid;
+    }
+
+    /**
+     * Marks the runner as finished and keeps the first completion time.
+     */
+    public function finish(GithubRunnerStatus $status, ?string $errorMessage = null): void
+    {
+        $this->update([
+            'status' => $status,
+            'error_message' => $errorMessage,
+            'completed_at' => $this->completed_at ?? now(),
+        ]);
+    }
+
+    public function duration(): ?string
+    {
+        if (! $this->started_at) {
+            return null;
+        }
+
+        return $this->started_at->diffForHumans($this->completed_at ?? now(), true);
+    }
+
+    public function workflowJobUrl(): ?string
+    {
+        $url = trim((string) $this->workflow_job_html_url);
+
+        return str_starts_with($url, 'https://') ? $url : null;
+    }
+}